Traduction du jour avant merge vers la RC1

postgresql/auto-explain.xml

@@ -9,37 +9,37 @@
  <para>
   Le module <filename>auto_explain</filename> fournit un moyen de tracer les
   plans d'exécution des requêtes lentes automatiquement, sans qu'il soit
-  nécessaire de lancer <xref linkend="sql-explain"/>
-  manuellement. C'est particulièrement utile pour repérer les requêtes
-  non optimisées sur de grosses applications.
+  nécessaire de lancer <xref linkend="sql-explain"/> manuellement. C'est
+  particulièrement utile pour repérer les requêtes non optimisées sur de grosses
+  applications.
  </para>
 
  <para>
-  Le module ne fournit pas de fonctions accessibles par SQL.
-  Pour l'utiliser, il suffit de le charger sur le serveur.
-  Il peut être chargé dans une session individuelle&nbsp;:
+  Le module ne fournit pas de fonctions accessibles par SQL. Pour l'utiliser, il
+  suffit de le charger sur le serveur. Il peut être chargé dans une session
+  individuelle&nbsp;:
 
   <programlisting>
     LOAD 'auto_explain';
   </programlisting>
 
-  (Seul le super-utilisateur peut le faire.)
-  Une utilisastion plus commune est de le précharger dans certaines ou toutes
-  les sessions, en incluant <literal>auto_explain</literal> dans
+  (Seul le super-utilisateur peut le faire.) Une utilisation plus commune est de
+  le précharger dans certaines ou toutes les sessions, en incluant
+  <literal>auto_explain</literal> dans
   <xref linkend="guc-session-preload-libraries"/> ou dans
   <xref linkend="guc-shared-preload-libraries"/> dans le fichier
-  <filename>postgresql.conf</filename>. Il est alors possible de récupérer les requêtes
-  lentes non prévues, quel que soit le moment où elles se produisent. Évidemment, il y a un prix
-  à payer pour cela.
+  <filename>postgresql.conf</filename>. Il est alors possible de récupérer les
+  requêtes lentes non prévues, quel que soit le moment où elles se produisent.
+  Évidemment, il y a un prix à payer pour cela.
  </para>
 
 <sect2>
  <title>Paramètres de configuration</title>
 
  <para>
   Plusieurs paramètres de configuration contrôlent le comportement
-  d'<filename>auto_explain</filename>. Le comportement par défaut est
-  de ne rien faire. Il est donc nécessaire de préciser au minimum
+  d'<filename>auto_explain</filename>. Le comportement par défaut est de ne rien
+  faire. Il est donc nécessaire de préciser au minimum
   <varname>auto_explain.log_min_duration</varname> pour obtenir un résultat.
  </para>
 
@@ -54,12 +54,11 @@
    <listitem>
     <para>
      <varname>auto_explain.log_min_duration</varname> est la durée minimale
-     d'exécution de requête à partir de laquelle le plan d'exécution
-     sera tracé. Son unité est la milliseconde. La positionner à zéro trace
-     tous les plans. -1 (la valeur par défaut) désactive l'écriture des plans.
-     Positionnée à <literal>250ms</literal>,
-     tous les ordres qui durent 250&nbsp;ms ou plus seront tracés. Seuls les
-     super-utilisateurs peuvent modifier ce paramétrage.
+     d'exécution de requête à partir de laquelle le plan d'exécution sera tracé.
+     Son unité est la milliseconde. La positionner à zéro trace tous les plans.
+     -1 (la valeur par défaut) désactive l'écriture des plans. Positionnée à
+     <literal>250ms</literal>, tous les ordres qui durent 250&nbsp;ms ou plus
+     seront tracés. Seuls les super-utilisateurs peuvent modifier ce paramétrage.
     </para>
    </listitem>
   </varlistentry>
@@ -73,21 +72,20 @@
    </term>
    <listitem>
     <para>
-     <varname>auto_explain.log_analyze</varname> entraîne
-     l'écriture du résultat de <command>EXPLAIN ANALYZE</command>,
-     à la place du résultat de <command>EXPLAIN</command>,
-     lorsqu'un plan d'exécution est tracé.
-     Ce paramètre est désactivé par défaut.
-     Seuls les super-utilisateurs peuvent modifier ce paramètre.
+     <varname>auto_explain.log_analyze</varname> entraîne l'écriture du résultat
+     de <command>EXPLAIN ANALYZE</command>, à la place du résultat de
+     <command>EXPLAIN</command>, lorsqu'un plan d'exécution est tracé. Ce
+     paramètre est désactivé par défaut. Seuls les super-utilisateurs peuvent
+     modifier ce paramètre.
     </para>
     <note>
      <para>
-      Lorsque ce paramètre est activé, un chronométrage par
-      n&oelig;ud du plan est calculé pour
-      tous les ordres exécutés, qu'ils durent suffisamment longtemps pour être réellement tracés, ou non.
-      Ceci peut avoir des conséquences très négatives sur les performances.
-       Turning off <varname>auto_explain.log_timing</varname> ameliorates the
-       performance cost, at the price of obtaining less information.
+      Lorsque ce paramètre est activé, un chronométrage par n&oelig;ud du plan
+      est calculé pour tous les ordres exécutés, qu'ils durent suffisamment
+      longtemps pour être réellement tracés, ou non. Ceci peut avoir des
+      conséquences très négatives sur les performances. Désactiver
+      <varname>auto_explain.log_timing</varname> améliore les performances au
+      prix d'une diminution des informations.
      </para>
     </note>
    </listitem>
@@ -102,12 +100,13 @@
    </term>
    <listitem>
     <para>
-      <varname>auto_explain.log_buffers</varname> controls whether buffer
-      usage statistics are printed when an execution plan is logged; it's
-      equivalent to the <literal>BUFFERS</literal> option of <command>EXPLAIN</command>.
-      This parameter has no effect
-      unless <varname>auto_explain.log_analyze</varname> is enabled.
-      This parameter is off by default.
+      <varname>auto_explain.log_buffers</varname> contrôle l'affichage des
+      statistiques d'utilisation du cache disque de PostgreSQL dans la trace
+      d'un plan d'exécution&nbsp;; il s'agit de l'équivalent de l'option
+      <literal>BUFFERS</literal> de la commande <command>EXPLAIN</command>.
+      Ce paramètre n'a pas d'effet tant que
+      <varname>auto_explain.log_analyze</varname> n'est pas activé. Il est
+      désactivé par défaut.
     </para>
    </listitem>
   </varlistentry>
@@ -121,17 +120,17 @@
     </term>
     <listitem>
      <para>
-      <varname>auto_explain.log_timing</varname> controls whether per-node
-      timing information is printed when an execution plan is logged; it's
-      equivalent to the <literal>TIMING</literal> option of <command>EXPLAIN</command>.
-      The overhead of repeatedly reading the system clock can slow down
-      queries significantly on some systems, so it may be useful to set this
-      parameter to off when only actual row counts, and not exact times, are
-      needed.
-      This parameter has no effect
-      unless <varname>auto_explain.log_analyze</varname> is enabled.
-      This parameter is on by default.
-      Only superusers can change this setting.
+      <varname>auto_explain.log_timing</varname> contrôle l'affichage du
+      chronométrage de chaque nœud lorsqu'un plan d'exécution est tracé&nbsp;;
+      il s'agit de l'équivalent de l'option <literal>TIMING</literal> pour la
+      commande <command>EXPLAIN</command>. La surcharge occasionnée par la
+      lecture répétée de l'horloge système peut ralentir significativement
+      l'exécution des requêtes sur certains systèmes. De ce fait, il peut être
+      utile de désactiver ce paramètre quand seul le nombre de lignes exacts
+      importe. Ce paramètre n'a pas d'effet tant que
+      <varname>auto_explain.log_analyze</varname> n'est pas activé. Il est
+      désactivé par défaut. Seuls les superutilisateurs peuvent modifier la
+      valeur de ce paramètre.
      </para>
     </listitem>
    </varlistentry>
@@ -147,11 +146,10 @@
      <para>
       <varname>auto_explain.log_triggers</varname> entraîne la prise en compte
       des statistiques d'exécution des triggers quand un plan d'exécution
-      est tracé.
-      This parameter has no effect
-      unless <varname>auto_explain.log_analyze</varname> is enabled.
-      This parameter is off by default.
-      Only superusers can change this setting.
+      est tracé. Ce paramètre n'a pas d'effet tant que
+      <varname>auto_explain.log_analyze</varname> n'est pas activé. Il est
+      désactivé par défaut. Seuls les superutilisateurs peuvent modifier la
+      valeur de ce paramètre.
      </para>
     </listitem>
    </varlistentry>
@@ -165,10 +163,10 @@
     </term>
     <listitem>
      <para>
-      <varname>auto_explain.log_verbose</varname> controls whether verbose
-      details are printed when an execution plan is logged; it's
-      equivalent to the <literal>VERBOSE</literal> option of <command>EXPLAIN</command>.
-      This parameter is off by default.
+      <varname>auto_explain.log_verbose</varname> contrôle l'affichage des
+      détails quand un plan d'exécution est tracé&nbsp;; il s'agit de
+      l'équivalent de l'option <literal>VERBOSE</literal> pour la commande
+      <command>EXPLAIN</command>. Ce paramètre est désactivé par défaut.
      </para>
     </listitem>
    </varlistentry>
@@ -182,10 +180,11 @@
     </term>
     <listitem>
      <para>
-      <varname>auto_explain.log_format</varname> selects the
-      <command>EXPLAIN</command> output format to be used.
-      The allowed values are <literal>text</literal>, <literal>xml</literal>,
-      <literal>json</literal>, and <literal>yaml</literal>.  The default is text.
+      <varname>auto_explain.log_format</varname> sélectionne le format de sortie
+      utilisé par la commande <command>EXPLAIN</command>. Les valeurs autorisées
+      sont <literal>text</literal>, <literal>xml</literal>,
+      <literal>json</literal> et <literal>yaml</literal>. Le format par défaut
+      est le texte brut.
      </para>
     </listitem>
    </varlistentry>
@@ -199,22 +198,21 @@
     </term>
    <listitem>
     <para>
-     <varname>auto_explain.log_nested_statements</varname> entraîne
-     la prise en compte des ordres imbriqués
-     (les requêtes exécutées dans une fonction) dans la trace.
-     Quand il est désactivé, seuls les plans d'exécution
-     de plus haut niveau sont tracés. Ce paramètre est désactivé par
-     défaut. Seuls les super-utilisateurs peuvent modifier ce paramètre.
+     <varname>auto_explain.log_nested_statements</varname> entraîne la prise en
+     compte des ordres imbriqués (les requêtes exécutées dans une fonction)
+     dans la trace. Quand il est désactivé, seuls les plans d'exécution de plus
+     haut niveau sont tracés. Ce paramètre est désactivé par défaut. Seuls les
+     super-utilisateurs peuvent modifier ce paramètre.
     </para>
    </listitem>
   </varlistentry>
  </variablelist>
 
  <para>
-   In ordinary usage, these parameters are set
-   in <filename>postgresql.conf</filename>, although superusers can alter them
-   on-the-fly within their own sessions.
-   Voici un exemple typique d'utilisation&nbsp;:
+   D'ordinaire, ces paramètres sont configurés dans le fichier
+   <filename>postgresql.conf</filename> mais les superutilisateurs peuvent les
+   modifier en ligne pour leur propres sessions. Voici un exemple typique
+   d'utilisation&nbsp;:
  </para>
 
  <programlisting>

postgresql/pgbench.xml

@@ -152,7 +152,7 @@ pgbench <optional> <replaceable>options</replaceable> </optional> <replaceable>n
   </para>
 
  <refsect2 id="pgbench-init-options">
-  <title>Initialization Options</title>
+  <title>Options d'initialisation</title>
 
    <para>
     <application>pgbench</application> comprend les options de la ligne de
@@ -279,11 +279,11 @@ pgbench <optional> <replaceable>options</replaceable> </optional> <replaceable>n
  </refsect2>
 
  <refsect2 id="pgbench-run-options">
-  <title>Benchmarking Options</title>
+  <title>Options de benchmark</title>
 
    <para>
-    <application>pgbench</application> comprend les options de la ligne de
-    commande suivants&nbsp;:
+    <application>pgbench</application> comprend les options suivantes en ligne
+    de commande&nbsp;:
 
     <variablelist>
 
@@ -325,8 +325,9 @@ pgbench <optional> <replaceable>options</replaceable> </optional> <replaceable>n
       <term><option>--define=</option><replaceable>nom_variable</replaceable><literal>=</literal><replaceable>valeur</replaceable></term>
       <listitem>
        <para>
-        Définit une variable pouvant être utilisé par un script personalisé (voir plus bas).
-        Plusieurs options <option>-D</option> peuvent être utilisées.
+        Définit une variable pouvant être utilisé par un script personnalisé
+        (voir plus bas). Plusieurs options <option>-D</option> peuvent être
+        utilisées.
        </para>
       </listitem>
      </varlistentry>
@@ -397,9 +398,9 @@ pgbench <optional> <replaceable>options</replaceable> </optional> <replaceable>n
       <term><option>--no-vacuum</option></term>
       <listitem>
        <para>
-        Ne pas faire de vacuuming avant de lancer le test.
+        Ne pas exécuter de VACUUM avant de lancer le test.
         Cette option est <emphasis>obligatoire</emphasis>
-        si vous lancez un scenario de test personalisé qui n'inclut pas
+        si vous lancez un scénario de test personalisé qui n'inclut pas
         les tables standards <structname>pgbench_accounts</structname>,
         <structname>pgbench_branches</structname>, <structname>pgbench_history</structname> et
         <structname>pgbench_tellers</structname>.
@@ -429,10 +430,10 @@ pgbench <optional> <replaceable>options</replaceable> </optional> <replaceable>n
         rapport inclut le tmps depuis le début de l'exécution, le nombre de
         transactions par seconde depuis le dernier rapport, la latence moyenne
         des transactions, et la déviation standard depuis le dernier rapport.
-        En utilisant l'option (<option>-R</option>), the latency is computed
-        with respect to the transaction scheduled
-        start time, not the actual transaction beginning time, thus it also
-        includes the average schedule lag time.
+        En utilisant l'option (<option>-R</option>), la latence est calculée en
+        prenant en compte l'heure de début prévue de la transaction, et non pas
+        l'heure de début réelle.. De ce faire, cela inclut aussi le temps de
+        latence moyen.
        </para>
       </listitem>
      </varlistentry>
@@ -468,24 +469,25 @@ pgbench <optional> <replaceable>options</replaceable> </optional> <replaceable>n
         peuvent récupérer de nouveau.
        </para>
        <para>
-        When throttling is active, the transaction latency reported at the
-        end of the run is calculated from the scheduled start times, so it
-        includes the time each transaction had to wait for the previous
-        transaction to finish. The wait time is called the schedule lag time,
-        and its average and maximum are also reported separately. The
-        transaction latency with respect to the actual transaction start time,
-        i.e. the time spent executing the transaction in the database, can be
-        computed by subtracting the schedule lag time from the reported
-        latency.
+        Lorsque la limitation est activée, la latence des transactions rapportée
+        en fin de test est calculée à partir de l'heure de début prévue, de
+        sorte qu'il comprend le temps d'attente de la fin de la transaction
+        précédente. La durée d'attente est appelée durée de latence planifiée,
+        et ses valeur moyenne et valeur maximale sont aussi rapportées
+        séparément. La latence de la transaction, calculée  partir de l'heure
+        de début réelle de la transactions, donc le temps passé à exécuter la
+        transaction au niveau de la base de données, peut se calculer en
+        soustrayant la durée de la latence planifiée de la latence rapportée.
        </para>
        <para>
-        A high schedule lag time is an indication that the system cannot
-        process transactions at the specified rate, with the chosen number of
-        clients and threads. When the average transaction execution time is
-        longer than the scheduled interval between each transaction, each
-        successive transaction will fall further behind, and the schedule lag
-        time will keep increasing the longer the test run is. When that
-        happens, you will have to reduce the specified transaction rate.
+        Une grande durée de latence planifiée est une indication que le
+        système ne peut pas traiter les transactions à ce rythme, avec le
+        nombre choisi de clients et de threads. Quand la durée d'exécution
+        moyenne des transactions est plus longue que l'intervalle planifié
+        entre chaque transactions, toutes les transactions suivantes vont
+        durer encore plus longtemps, et la durée de latence planifiée ne fera
+        que grossir jusqu'à la fin de l'exécution du test. Quand ceci survient,
+        vous devez réduire le taux de transaction indiqué.
        </para>
       </listitem>
      </varlistentry>
@@ -595,10 +597,10 @@ pgbench <optional> <replaceable>options</replaceable> </optional> <replaceable>n
  </refsect2>
 
  <refsect2 id="pgbench-common-options">
-  <title>Common Options</title>
+  <title>Options générales</title>
 
    <para>
-    <application>pgbench</application> reconnait les options habituels suivantes
+    <application>pgbench</application> reconnait les options habituelles suivantes
     de ligne de commande&nbsp;:
 
     <variablelist>
@@ -947,10 +949,10 @@ END;
    une date/heure au format epoch Unix et un décalage en microsecondes
    (convenable pour la création d'un horodatage ISO 8601 avec des secondes
    en fraction) indiquant la date et heure de la fin de la transaction.
-   The last field, <replaceable>schedule_lag</replaceable>, is
-   the difference between the transaction's scheduled start time, and the
-   time it actually started, in microseconds. It is only present when the
-   <option>--rate</option> option is used.
+   Le dernier champ, <replaceable>schedule_lag</replaceable>, est la
+   différence entre l'heure de début planifiée de la transaction, et l'heure à
+   laquelle elle a réellement commencé, en microsecondes. Cette information
+   n'est présente que si l'option <option>--rate</option> est utilisée.
   </para>
 
   <para>
@@ -993,11 +995,13 @@ END;
    <replaceable>min_latence</replaceable> - la latence minimale dans cet intervalle,
    et <replaceable>max_latence</replaceable> - la latence maximale dans cet
    intervalle. Une transaction est comptée dans l'intervalle où elle a été validée.
-   The last four fields, 
-   <replaceable>lag_sum</replaceable>, <replaceable>lag_2_sum</replaceable>, <replaceable>min_lag</replaceable>, and <replaceable>max_lag</replaceable>, are only present if the --rate option is used.
-   They are calculated from the time each transaction had to wait for the
-   previous one to finish, i.e. the difference between each transaction's
-   scheduled start time and the time it actually started.
+   Les quatre derniers champs, <replaceable>lag_sum</replaceable>,
+   <replaceable>lag_2_sum</replaceable>, <replaceable>min_lag</replaceable>
+   et <replaceable>max_lag</replaceable>, sont seulement présents si l'option
+   est utilisée. Ils sont calculés à partir du moment où chaque transaction
+   doit attendre la fin de la précédente, autrement dit la différence entre
+   l'heure de début planifiée de chaque transaction et l'heure de début
+   réelle.
   </para>
 
   <para>