Merge 9.4 beta 2

La traduction peut commencer :)
gleu · Aug 5, 2014 · 5a03d75 · 5a03d75
1 parent 52280f8
commit 5a03d75
Show file tree

Hide file tree

Showing 280 changed files with 15,521 additions and 3,039 deletions.
diff --git a/postgresql/advanced.xml b/postgresql/advanced.xml
@@ -389,7 +389,9 @@ SELECT nomdep, noemp, salaire, avg(salaire) OVER (PARTITION BY nomdep) FROM sala
     un exemple&nbsp;:
 
 <programlisting>
-SELECT nomdep, noemp, salaire, rank() OVER (PARTITION BY nomdep ORDER BY salaire DESC) FROM salaireemp;
+SELECT nomdep, noemp, salaire,
+       rank() OVER (PARTITION BY nomdep ORDER BY salaire DESC)
+FROM salaireemp;
 </programlisting>
 
 <screen>

diff --git a/postgresql/array.xml b/postgresql/array.xml
@@ -325,6 +325,19 @@ SELECT array_length(planning, 1) FROM sal_emp WHERE nom = 'Carol';
 --------------
             2
 (1 row)
+</programlisting>
+
+ <function>cardinality</function> renvoie le nombre total d'éléments d'un tableau
+ sur toutes ses dimensions. Autrement dit, c'est le nombre de lignes que renverrait
+ un appel à la fonction <function>unnest</function>&nbsp;:
+
+<programlisting>
+SELECT cardinality(planning) FROM sal_emp WHERE nom = 'Carol';
+
+ cardinality 
+-------------
+           4
+(1 row)
 </programlisting>
  </para>
  </sect2>

diff --git a/postgresql/auth-delay.xml b/postgresql/auth-delay.xml
@@ -28,10 +28,10 @@
    <varlistentry>
     <term>
      <varname>auth_delay.milliseconds</varname> (<type>int</type>)
+     <indexterm>
+      <primary>paramètre de configuration <varname>auth_delay.milliseconds</varname></primary>
+     </indexterm>
     </term>
-    <indexterm>
-     <primary>paramètre de configuration <varname>auth_delay.milliseconds</varname></primary>
-    </indexterm>
     <listitem>
      <para>
       Le nombre de millisecondes à attendre avant de rapporter une erreur

diff --git a/postgresql/auto-explain.xml b/postgresql/auto-explain.xml
@@ -24,8 +24,9 @@
   </programlisting>
 
   (Seul le super-utilisateur peut le faire.)
-  Un usage plus caractéristique est de le précharger dans toutes les sessions
-  en incluant <literal>auto_explain</literal> dans
+  Un usage plus caractéristique 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
@@ -46,10 +47,10 @@
   <varlistentry>
    <term>
     <varname>auto_explain.log_min_duration</varname> (<type>integer</type>)
+    <indexterm>
+     <primary>paramètre de configuration <varname>auto_explain.log_min_duration</varname></primary>
+    </indexterm>
    </term>
-   <indexterm>
-    <primary>paramètre de configuration <varname>auto_explain.log_min_duration</varname></primary>
-   </indexterm>
    <listitem>
     <para>
      <varname>auto_explain.log_min_duration</varname> est la durée minimale
@@ -66,10 +67,10 @@
   <varlistentry>
    <term>
     <varname>auto_explain.log_analyze</varname> (<type>boolean</type>)
+    <indexterm>
+     <primary>paramètre de configuration <varname>auto_explain.log_analyze</varname></primary>
+    </indexterm>
    </term>
-   <indexterm>
-    <primary>paramètre de configuration <varname>auto_explain.log_analyze</varname></primary>
-   </indexterm>
    <listitem>
     <para>
      <varname>auto_explain.log_analyze</varname> entraîne
@@ -93,10 +94,10 @@
   <varlistentry>
    <term>
     <varname>auto_explain.log_verbose</varname> (<type>boolean</type>)
+    <indexterm>
+     <primary>paramètre de configuration <varname>auto_explain.log_verbose</varname></primary>
+    </indexterm>
    </term>
-   <indexterm>
-    <primary>paramètre de configuration <varname>auto_explain.log_verbose</varname></primary>
-   </indexterm>
    <listitem>
     <para>
      <varname>auto_explain.log_verbose</varname> entraîne l'écriture
@@ -111,10 +112,10 @@
    <varlistentry>
     <term>
      <varname>auto_explain.log_buffers</varname> (<type>boolean</type>)
+     <indexterm>
+      <primary>paramètre de configuration <varname>auto_explain.log_buffers</varname></primary>
+     </indexterm>
     </term>
-    <indexterm>
-     <primary>paramètre de configuration <varname>auto_explain.log_buffers</varname></primary>
-    </indexterm>
     <listitem>
      <para>
       <varname>auto_explain.log_buffers</varname> permet d'obtenir la même
@@ -128,13 +129,32 @@
     </listitem>
    </varlistentry>
 
+   <varlistentry>
+    <term>
+     <varname>auto_explain.log_triggers</varname> (<type>boolean</type>)
+     <indexterm>
+      <primary>paramètre de configuration <varname>auto_explain.log_triggers</varname></primary>
+     </indexterm>
+    </term>
+    <listitem>
+     <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é.
+     </para>
+    </listitem>
+   </varlistentry>
+
    <varlistentry>
     <term>
      <varname>auto_explain.log_format</varname> (<type>enum</type>)
+     <indexterm>
+      <primary>paramètre de configuration <varname>auto_explain.log_format</varname></primary>
+     </indexterm>
     </term>
-    <indexterm>
-     <primary>paramètre de configuration <varname>auto_explain.log_format</varname></primary>
-    </indexterm>
     <listitem>
      <para>
       <varname>auto_explain.log_format</varname> sélectionne le format de
@@ -147,12 +167,12 @@
    </varlistentry>
 
   <varlistentry>
-   <term>
+    <term>
      <varname>auto_explain.log_timing</varname> (<type>boolean</type>)
+     <indexterm>
+      <primary><varname>auto_explain.log_timing</varname> configuration parameter</primary>
+     </indexterm>
     </term>
-    <indexterm>
-     <primary><varname>auto_explain.log_timing</varname> configuration parameter</primary>
-    </indexterm>
     <listitem>
      <para>
       <varname>auto_explain.log_timing</varname> permet d'obtenir la même sortie
@@ -170,11 +190,11 @@
 
    <varlistentry>
     <term>
-    <varname>auto_explain.log_nested_statements</varname> (<type>boolean</type>)
-   </term>
-   <indexterm>
-    <primary>paramètre de configuration <varname>auto_explain.log_nested_statements</varname></primary>
-   </indexterm>
+     <varname>auto_explain.log_nested_statements</varname> (<type>boolean</type>)
+     <indexterm>
+      <primary>paramètre de configuration <varname>auto_explain.log_nested_statements</varname></primary>
+     </indexterm>
+    </term>
    <listitem>
     <para>
      <varname>auto_explain.log_nested_statements</varname> entraîne
@@ -196,7 +216,7 @@
 
  <programlisting>
  	# postgresql.conf
- 	shared_preload_libraries = 'auto_explain'
+ 	session_preload_libraries = 'auto_explain'
 
  	auto_explain.log_min_duration = '3s'
  </programlisting>

diff --git a/postgresql/backup.xml b/postgresql/backup.xml
@@ -44,9 +44,14 @@
    classique (mais plutôt intelligent). Cela signifie que la 
    sauvegarde peut être effectuée depuis n'importe quel ordinateur ayant accès à la base.
    Mais <application>pg_dump</application> n'a pas de droits spéciaux.
-   Il doit, en particulier, avoir accès en lecture à toutes les tables 
-   à sauvegarder, si bien qu'il doit être lancé pratiquement
-   toujours en tant que superutilisateur de la base.
+   In particular, it must
+   have read access to all tables that you want to back up, so in order
+   to back up the entire database you almost always have to run it as a
+   database superuser.  (If you do not have sufficient privileges to back up
+   the entire database, you can still back up portions of the database to which
+   you do have access using options such as
+   <option>-n <replaceable>schema</replaceable></option>
+   or <option>-t <replaceable>table</replaceable></option>.)
   </para>
 
   <para>
@@ -616,7 +621,7 @@ pg_dump -j <replaceable class="parameter">num</replaceable> -F d -f <replaceable
    <para>
     Pour activer l'archivage des journaux de transaction, on positionne le
     paramètre de configuration <xref linkend="guc-wal-level"/> à
-    <literal>archive</literal> (ou à <literal>hot_standby</literal>),
+    <literal>archive</literal> ou supérieur,
     <xref linkend="guc-archive-mode"/> à <literal>on</literal>,
     et on précise la commande shell à utiliser dans le paramètre
     <xref linkend="guc-archive-command"/> de la configuration. En fait, ces
@@ -994,6 +999,21 @@ SELECT pg_start_backup('label', true);
     problème à <application>pg_ctl</application>.
    </para>
 
+   <para>
+    It is often a good idea to also omit from the backup dump the files
+    within the cluster's <filename>pg_replslot/</filename> directory, so that
+    replication slots that exist on the master do not become part of the
+    backup.  Otherwise, the subsequent use of the backup to create a standby
+    may result in indefinite retention of WAL files on the standby, and
+    possibly bloat on the master if hot standby feedback is enabled, because
+    the clients that are using those replication slots will still be connecting
+    to and updating the slots on the master, not the standby.  Even if the
+    backup is only intended for use in creating a new master, copying the
+    replication slots isn't expected to be particularly useful, since the
+    contents of those slots will likely be badly out of date by the time
+    the new master comes on line.
+   </para>
+
    <para>
     La fonction
     <function>pg_start_backup</function> crée un fichier nommé 
@@ -1146,7 +1166,15 @@ SELECT pg_start_backup('label', true);
     zéro en cas d'échec. Des fichiers absents de l'archive
     <emphasis>seront</emphasis> demandés à la commande&nbsp;; elle doit
     renvoyer autre chose que zéro dans ce cas. Ce n'est pas une condition
-    d'erreur. Tous les fichiers demandés ne seront pas des segmets WAL; vous
+    d'erreur. An exception is that if the command was terminated by
+    a signal (other than <systemitem>SIGTERM</systemitem>, which is used as
+    part of a database server shutdown) or an error by the shell (such as
+    command not found), then recovery will abort and the server will not start
+    up.
+   </para>
+
+   <para>
+    Tous les fichiers demandés ne seront pas des segmets WAL; vous
     pouvez aussi vous attendre à des demandes de fichiers suffixés par
     <literal>.backup</literal> or <literal>.history</literal>. Il faut également
     garder à l'esprit que le nom de base du chemin <literal>%p</literal>
@@ -1176,7 +1204,8 @@ SELECT pg_start_backup('label', true);
 
    <para>
     Pour récupérer à un moment précis (avant que le DBA junior n'ait supprimé
-    la table principale), il suffit d'indiquer le point d'arrêt requis dans
+    la table principale), il suffit d'indiquer le <link
+    linkend="recovery-target-settings">point d'arrêt</link> requis dans
     <filename>recovery.conf</filename>. Le point d'arrêt, aussi nommé
     <quote>recovery target</quote> (cible de récupération), peut être précisé
     par une combinaison date/heure, un point de récupération nommé ou par le
@@ -1333,7 +1362,7 @@ SELECT pg_start_backup('label', true);
       pour les sauvegardes à chaud autonomes. 
       En vue d'effectuer des sauvegardes à chaud autonomes, on positionne
       <varname>wal_level</varname> à
-      <literal>archive</literal> (ou <literal>hot_standby</literal>),
+      <literal>archive</literal> ou supérieur,
       <varname>archive_mode</varname> à <literal>on</literal>, et on configure
       <varname>archive_command</varname> de telle sorte que l'archivage ne soit
       réalisé que lorsqu'un <emphasis>fichier de bascule</emphasis> existe. Par