Merge v12 beta 3

postgresql/backup.xml

@@ -1018,8 +1018,8 @@ SELECT * FROM pg_stop_backup(false, true);
      de sauvegarde peut seulement être réalisé sur un serveur primaire et ne
      permet pas des sauvegardes concurrentes. De plus, le fichier backup_label
      créé sur un serveur primaire peut empêcher le redémarrage de celui-ci en
-     cas de crash. D'un autre côté, la suppression à tord du fichier
-     backup_label d'une sauvegarde ou d'un serveur secondaire est une erreur
+     cas de crash. D'un autre côté, la suppression à tord de ce fichier
+     d'une sauvegarde ou d'un serveur secondaire est une erreur
      fréquente qui peut mener à de sérieuses corruptions de données. S'il
      était nécessaire d'utiliser cette méthode, les étapes suivantes doivent
      être respectées.
@@ -1084,9 +1084,9 @@ SELECT pg_start_backup('label', true);
     <para>
       Comme il est déjà indiqué ci-dessus, si le serveur s'arrête brutalement
       lors de la sauvegarde, il pourrait ne pas être possible de recommencer
-      tant que le fichier <literal>backup_label</literal> ne soit manuellement
+      tant que le fichier <filename>backup_label</filename> ne soit manuellement
       supprimée du répertoire <envar>PGDATA</envar>. Il est très important de
-      ne jamais supprimer le fichier <literal>backup_label</literal> lors de
+      ne jamais supprimer le fichier <filename>backup_label</filename> lors de
       la restauration d'une sauvegarde afin d'éviter toute corruption. La
       confusion concernant les cas d'usage où il est approprié de supprimer
       ce fichier est une cause fréquente de corruption de données lors de
@@ -1133,7 +1133,7 @@ SELECT pg_start_backup('label', true);
      exécuter <function>pg_stop_backup</function> laisse le serveur en mode
      sauvegarde indéfiniment, empêchant la réalisation des futures sauvegardes
      et augmentant le risque que le serveur ne puisse pas redémarrer lorsque
-     le fichier <literal>backup_label</literal> existe.
+     le fichier <filename>backup_label</filename> existe.
     </para>
    </listitem>
   </orderedlist>

postgresql/biblio.xml

@@ -137,14 +137,11 @@
   </biblioentry>
 
   <biblioentry id="sqltr-19075-6">
-   <title>SQL Technical Report</title>
+   <title><ulink url="http://standards.iso.org/ittf/PubliclyAvailableStandards/c067367_ISO_IEC_TR_19075-6_2017.zip">SQL Technical Report</ulink></title>
    <subtitle>Part 6: SQL support for JavaScript Object
      Notation (JSON)</subtitle>
-   <edition>First Edition.</edition>
-   <biblioid>
-   <ulink url="http://standards.iso.org/ittf/PubliclyAvailableStandards/c067367_ISO_IEC_TR_19075-6_2017.zip"></ulink>.
-   </biblioid>
-   <pubdate>2017.</pubdate>
+   <edition>First Edition</edition>
+   <pubdate>2017</pubdate>
   </biblioentry>
 
  </bibliodiv>

postgresql/catalogs.xml

@@ -1801,8 +1801,8 @@ SCRAM-SHA-256$<replaceable>&lt;nombre d'itération&gt;</replaceable>:<replaceabl
       <entry><structfield>relam</structfield></entry>
       <entry><type>oid</type></entry>
       <entry><literal><link linkend="catalog-pg-am"><structname>pg_am</structname></link>.oid</literal></entry>
-      <entry>S'il s'agit d'un index, OID de la méthode d'accès utilisée (B-tree,
-       hash, etc.)</entry>
+      <entry>S'il s'agit d'une table ou d'un index, méthode d'accès utilisée
+       (B-tree, hash, etc.)</entry>
      </row>
 
      <row>
@@ -5740,8 +5740,7 @@ SCRAM-SHA-256$<replaceable>&lt;nombre d'itération&gt;</replaceable>:<replaceabl
       <entry><structfield>oid</structfield></entry>
       <entry><type>oid</type></entry>
       <entry></entry>
-      <entry>Identifiant de ligne (attribut caché&nbsp;; doit être
-       explicitement sélectionné)</entry>
+      <entry>Identifiant de ligne</entry>
      </row>
 
      <row>
@@ -10467,11 +10466,6 @@ SELECT * FROM pg_locks pl LEFT JOIN pg_prepared_xacts ppx
    n'affiche pas le champ du mot de passe.
   </para>
 
-  <para>
-   Cette vue expose explicitement la colonne OID de la table sous-jacente car
-   elle est nécessaire pour réaliser des jointures avec les autres catalogues.
-  </para>
-
   <table>
    <title>Colonnes de <structname>pg_roles</structname></title>
 

postgresql/client-auth.xml

@@ -656,8 +656,9 @@ hostnogssenc <replaceable>database</replaceable>  <replaceable>user</replaceable
    lorsque le processus serveur principal reçoit un signal
    <systemitem>SIGHUP</systemitem><indexterm><primary>SIGHUP</primary></indexterm>.
    Si le fichier est édité sur un système actif, on peut signaler au
-   postmaster (en utilisant <literal>pg_ctl reload</literal> ou
-   <literal>kill -HUP</literal>) de relire le fichier.
+   postmaster (en utilisant <literal>pg_ctl reload</literal>, en appelant la
+   fonction SQL <function>pg_reload_conf()</function>, ou <literal>kill
+   -HUP</literal>) de relire le fichier.
   </para>
 
   <note>
@@ -891,7 +892,8 @@ mymap   /^(.*)@otherdomain\.com$   guest
    quand le processus principal du serveur reçoit un signal
    <systemitem>SIGHUP</systemitem><indexterm><primary>SIGHUP</primary></indexterm>.
    Si vous éditez le fichier sur un système en cours d'utilisation, vous devez
-   notifier le postmaster (en utilisant<literal>pg_ctl reload</literal> ou
+   notifier le postmaster (en utilisant<literal>pg_ctl reload</literal>, en
+   appelant la fonction SQL <function>pg_reload_conf()</function>, ou
    <literal>kill -HUP</literal>) pour lui faire relire le fichier.
   </para>
 

postgresql/config.xml

@@ -6111,11 +6111,10 @@ local0.*    /var/log/postgresql
    </indexterm>
    <para>
     Trace la durée de toute instruction terminée dont le temps d'exécution
-    égale ou dépasse ce nombre de millisecondes, modulé par
-    <varname>log_statement_sample_rate</varname>. Positionné à zéro, les
+    égale ou dépasse ce nombre de millisecondes. Positionné à zéro, les
     durées de toutes les instructions sont tracées. <literal>-1</literal>
-    (valeur par défaut) désactive ces traces pour cause de dépassement de la
-    limite de durée. Par exemple, si le paramètre est positionné à
+    (valeur par défaut) désactive la trace de la durée des requêtes. Par
+    exemple, si le paramètre est positionné à
     <literal>250ms</literal>, alors toutes les instructions SQL dont la durée
     est supérieure ou égale à 250&nbsp;ms sont tracées. Il est utile d'activer
     ce paramètre pour tracer les requêtes non optimisées des applications.
@@ -6143,25 +6142,6 @@ local0.*    /var/log/postgresql
   </listitem>
  </varlistentry>
 
- <varlistentry id="guc-log-statement-sample-rate" xreflabel="log_statement_sample_rate">
-  <term><varname>log_statement_sample_rate</varname> (<type>real</type>)
-  <indexterm>
-   <primary>paramètre de configuration <varname>log_statement_sample_rate</varname></primary>
-  </indexterm>
-  </term>
-   <listitem>
-    <para>
-     Détermine la fraction de requêtes dépassant <xref
-     linkend="guc-log-min-duration-statement"/> devant être tracées. La valeur
-     par défaut est <literal>1.0</literal>, signifiant toutes les requêtes.
-     Configurer ce paramètre à zéro désactive les traces par durée, de même
-     que configurer <varname>log_min_duration_statement</varname> à
-     <literal>-1</literal>. <varname>log_statement_sample_rate</varname> est
-     utile quand le trafic est trop important pour tracer toutes les requêtes.
-    </para>
-   </listitem>
-  </varlistentry>
-
   <varlistentry id="guc-log-transaction-sample-rate" xreflabel="log_transaction_sample_rate">
    <term><varname>log_transaction_sample_rate</varname> (<type>real</type>)
    <indexterm>
@@ -7521,6 +7501,10 @@ Ces paramètres contrôlent le comportement de la fonctionnalité appelée
     est parcouru <emphasis>avant</emphasis> tout autre élément du chemin.
    </para>
 
+   <!-- To further split hairs, funcname('foo') does not use the temporary
+        schema, even when it considers typname='funcname'.  This paragraph
+        refers to function names in a loose sense, "pg_proc.proname or
+        func_name grammar production". -->
    <para>
     De même, le schéma des tables temporaires,
     <literal>pg_temp_<replaceable>nnn</replaceable></literal>, s'il existe,

postgresql/ddl.xml

@@ -1311,6 +1311,31 @@ CREATE TABLE cercles (
     précisée (NULL en l'absence de clause <literal>DEFAULT</literal>).
    </para>
 
+   <tip>
+    <para>
+     À partir de <productname>PostgreSQL</productname> 11, ajouter une colonne
+     avec une valeur par défaut constante ne signifie plus que chaque ligne de
+     la table doit être mise à jour quand l'instruction <command>ALTER
+     TABLE</command> doit être exécutée. À la place, la valeur par défaut sera
+     renvoyée à chaque accès à la ligne et appliquée quand la table est
+     réécrite, rendant ainsi la commande <command>ALTER TABLE</command> bien
+     plus rapide, même sur de grosses tables.
+    </para>
+
+    <para>
+     Néanmoins, si la valeur par défaut est volatile (par exemple
+     <function>clock_timestamp()</function>), chaque ligne devra être mise à
+     jour avec la valeur calculée à l'exécution du <command>ALTER
+     TABLE</command>. Pour éviter une opération de mise à jour potentiellement
+     longue, et en particulier si vous avez de toute façon l'intention de
+     remplir la colonne avec des valeurs qui ne sont pas par défaut, il
+     pourrait être préférable d'ajouter la colonne sans valeur par défaut,
+     d'insérer les valeurs correctes en utilisant l'instruction
+     <command>UPDATE</command>, et enfin d'ajouter la valeur par désirée comme
+     décrit ci-dessous.
+    </para>
+   </tip>
+
    <para>
     Des contraintes de colonne peuvent être définies dans la même commande,
     à l'aide de la syntaxe habituelle&nbsp;:
@@ -1323,20 +1348,6 @@ CREATE TABLE cercles (
     avoir rempli la nouvelle colonne correctement.
    </para>
 
-  <tip>
-   <para>
-    Ajouter une colonne avec une valeur par défaut nécessite la mise à jour
-    de chaque ligne de la table pour stocker la valeur de la nouvelle colonne.
-    Cependant, si aucune valeur par défaut n'est précisée,
-    <productname>PostgreSQL</productname> peut éviter la mise à jour physique.
-    Il est, de ce fait, préférable, si la colonne doit être remplie en majorité
-    avec des valeurs différentes de la valeur par défaut, d'ajouter
-    la colonne sans valeur par défaut, d'insérer les bonnes valeurs avec une
-    commande <command>UPDATE</command>, puis d'ajouter la valeur par défaut désirée
-    comme décrit ci-dessus.
-   </para>
-  </tip>
-
   </sect2>
 
   <sect2 id="ddl-alter-removing-a-column">
@@ -3708,6 +3719,15 @@ VALUES ('Albany', NULL, NULL, 'NY');</programlisting>
       </para>
      </listitem>
 
+     <listitem>
+      <para>
+       Les contraintes d'unicité sur les tables partitionnées doivent inclure
+       toutes les colonnes de la clé de partitionnement. Cette limitation
+       existe parce que <productname>PostgreSQL</productname> peut seulement
+       garantir l'unicité au niveau de chaque partition individuelle.
+      </para>
+     </listitem>
+
      <listitem>
       <para>
        Utiliser <literal>ONLY</literal> pour ajouter ou supprimer une
@@ -4121,6 +4141,15 @@ ALTER INDEX measurement_city_id_logdate_key
       </para>
      </listitem>
 
+     <listitem>
+      <para>
+       Les contraintes d'unicité sur les tables partitionnées doivent
+       inclure toutes les colonnes de la clé de partitionnement. Cette
+       limitation existe parce que <productname>PostgreSQL</productname> peut
+       seulement garantir l'unicité dans chaque partition individuelle.
+      </para>
+     </listitem>
+
      <listitem>
       <para>
        en cas de besoin, les triggers <literal>BEFORE ROW</literal> doivent

postgresql/diskusage.xml

@@ -96,9 +96,9 @@ WHERE c.relname = 'customer' AND
       c2.oid = i.indexrelid
 ORDER BY c2.relname;
 
-       relname        | relpages
-----------------------+----------
- customer_id_indexdex |       26</programlisting>
+       relname     | relpages
+-------------------+----------
+ customer_id_index |       26</programlisting>
   </para>
 
   <para>