Merge 9.4 beta 3

gleu · Nov 8, 2014 · 40ec218 · 40ec218
1 parent c176af8
commit 40ec218
Show file tree

Hide file tree

Showing 44 changed files with 1,453 additions and 1,073 deletions.
diff --git a/postgresql/auto-explain.xml b/postgresql/auto-explain.xml
@@ -86,45 +86,52 @@
       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.
      </para>
     </note>
    </listitem>
   </varlistentry>
 
   <varlistentry>
    <term>
-    <varname>auto_explain.log_verbose</varname> (<type>boolean</type>)
+    <varname>auto_explain.log_buffers</varname> (<type>boolean</type>)
     <indexterm>
-     <primary>paramètre de configuration <varname>auto_explain.log_verbose</varname></primary>
+     <primary>paramètre de configuration <varname>auto_explain.log_buffers</varname></primary>
     </indexterm>
    </term>
    <listitem>
     <para>
-     <varname>auto_explain.log_verbose</varname> entraîne l'écriture
-     du résultat de <command>EXPLAIN VERBOSE</command>
-     au lieu du résultat de la commande simple <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_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.
     </para>
    </listitem>
   </varlistentry>
 
    <varlistentry>
     <term>
-     <varname>auto_explain.log_buffers</varname> (<type>boolean</type>)
+     <varname>auto_explain.log_timing</varname> (<type>boolean</type>)
      <indexterm>
-      <primary>paramètre de configuration <varname>auto_explain.log_buffers</varname></primary>
+      <primary>paramètre de configuration <varname>auto_explain.log_timing</varname></primary>
      </indexterm>
     </term>
     <listitem>
      <para>
-      <varname>auto_explain.log_buffers</varname> permet d'obtenir la même
-      sortie qu'un <command>EXPLAIN (ANALYZE, BUFFERS)</command>, plutôt que
-      la sortie <command>EXPLAIN</command> habituelle quand un plan d'exécution
-      est tracé. Ce paramètre est désactivé par défaut. Seuls les
-      superutilisateurs peuvent modifier cette configuration. Ce paramètre n'a
-      pas d'effet sauf si le paramètre
-      <varname>auto_explain.log_analyze</varname> est activé.
+      <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.
      </para>
     </listitem>
    </varlistentry>
@@ -140,50 +147,45 @@
      <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é. Ce paramètre est désactivé par défaut. Seuls les
-      superutilisateurs peuvent modifier cette configuration. Ce paramètre n'a
-      pas d'effet sauf si le paramètre
-      <varname>auto_explain.log_analyze</varname> est activé.
+      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.
      </para>
     </listitem>
    </varlistentry>
 
    <varlistentry>
     <term>
-     <varname>auto_explain.log_format</varname> (<type>enum</type>)
+     <varname>auto_explain.log_verbose</varname> (<type>enum</type>)
      <indexterm>
-      <primary>paramètre de configuration <varname>auto_explain.log_format</varname></primary>
+      <primary>paramètre de configuration <varname>auto_explain.log_verbose</varname></primary>
      </indexterm>
     </term>
     <listitem>
      <para>
-      <varname>auto_explain.log_format</varname> sélectionne le format de
-      sortie du <command>EXPLAIN</command> à utiliser. Les valeurs autorisées
-      sont <literal>text</literal>, <literal>xml</literal>,
-      <literal>json</literal> et <literal>yaml</literal>. La valeur par défaut
-      est text. Seuls les super-utilisateurs peuvent modifier ce paramètre.
+      <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.
      </para>
     </listitem>
    </varlistentry>
 
   <varlistentry>
     <term>
-     <varname>auto_explain.log_timing</varname> (<type>boolean</type>)
+     <varname>auto_explain.log_format</varname> (<type>boolean</type>)
      <indexterm>
-      <primary><varname>auto_explain.log_timing</varname> configuration parameter</primary>
+      <primary>paramètre de configuration <varname>auto_explain.log_format</varname></primary>
      </indexterm>
     </term>
     <listitem>
      <para>
-      <varname>auto_explain.log_timing</varname> permet d'obtenir la même sortie
-      qu'un <command>EXPLAIN (ANALYZE, TIMING off)</command>, plutôt qu'un simple
-      <command>EXPLAIN (ANALYZE)</command>. La surcharge due à la lecture répétée de
-      l'horloge système pourrait ralentir fortement la requête sur certains systèmes,
-      donc il est intéressant de pouvoir configurer ce paramètre à
-      off quand seul le dénombrage des lignes est nécessaire.
-      Ce paramètre n'est pris en compte que si <varname>auto_explain.log_analyze</varname>
-      est lui-aussi activé. Ce paramètre est activé par défaut. Seuls les
-      superutilisateurs peuvent modifier cette configuration.
+      <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.
      </para>
     </listitem>
    </varlistentry>
@@ -209,8 +211,9 @@
  </variablelist>
 
  <para>
-   Ces paramètres doivent être configurés dans le fichier
-   <filename>postgresql.conf</filename>.
+   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;:
  </para>
 
@@ -228,6 +231,7 @@
  <programlisting>
 postgres=# LOAD 'auto_explain';
 postgres=# SET auto_explain.log_min_duration = 0;
+postgres=# SET auto_explain.log_analyze = true;
 postgres=# SELECT count(*)
     FROM pg_class, pg_index
     WHERE oid = indrelid AND indisunique;

diff --git a/postgresql/backup.xml b/postgresql/backup.xml
@@ -36,6 +36,9 @@
 <synopsis>pg_dump <replaceable class="parameter">base_de_donnees</replaceable> &gt; <replaceable class="parameter">fichier_de_sortie</replaceable></synopsis>
    <application>pg_dump</application> écrit son résultat sur la
    sortie standard. Son utilité est expliquée plus loin.
+   While the above command creates a text file, <application>pg_dump</application>
+   can create files in other formats that allow for parallism and more
+   fine-grained control of object restoration.
   </para>
 
   <para>
@@ -103,16 +106,6 @@
    la plupart des formes d'<command>ALTER TABLE</command>.)
   </para>
 
-  <important>
-   <para>
-    Si la base de données utilise les OID (par exemple en tant que clés 
-    étrangères), il est impératif d'indiquer à
-    <application>pg_dump</application> de sauvegarder
-    aussi les OID. Pour cela, on utilise l'option <option>-o</option> sur la ligne
-    de commande.
-   </para>
-  </important>
-
   <sect2 id="backup-dump-restore">
    <title>Restaurer la sauvegarde</title>
 
@@ -131,6 +124,8 @@
     <application>pg_dump</application> pour indiquer le serveur de bases de
     données sur lequel se connecter et le nom d'utilisateur à utiliser. La
     page de référence de <xref linkend="app-psql"/> donne plus d'informations.
+    Non-text file dumps are restored using the <xref
+    linkend="app-pgrestore"/> utility.
     </para>
 
    <para>
@@ -235,8 +230,16 @@
     <foreignphrase>tablespaces</foreignphrase> et les bases vides, puis
     en invoquant <application>pg_dump</application> pour chaque base de
     données. Cela signifie que, bien que chaque base de données est
-    cohérente en interne, les images des différentes bases de données peuvent
-    ne pas être tout à fait synchronisées.
+    cohérente en interne, les images des différentes bases de données ne sont
+    pas synchronisées.
+
+   </para>
+
+   <para>
+    Cluster-wide data can be dumped alone using the
+    <application>pg_dumpall</application> <option>--globals-only</option> option.
+    This is necessary to fully backup the cluster if running the
+    <application>pg_dump</application> command on individual databases.
    </para>
   </sect2>
 

diff --git a/postgresql/client-auth.xml b/postgresql/client-auth.xml
@@ -1271,7 +1271,7 @@ omicron       bryanh            guest1
     mécanisme similaire. Actuellement, cela inclut <systemitem
     class="osname">Linux</systemitem>, la plupart des variantes
     <systemitem class="osname">BSD</systemitem> (et donc <systemitem
-    class="osname">Mac OS X</systemitem>), ainsi que <systemitem
+    class="osname">OS X</systemitem>), ainsi que <systemitem
     class="osname">Solaris</systemitem>.
    </para>
   </sect2>