Mise à jour en version 9.6.16

postgresql/config.xml

@@ -50,7 +50,7 @@
       <emphasis>Chaîne de caractères</emphasis>&nbsp;:
       En général, entoure la valeur de guillemets simples, doublant tout
       guillemet simple compris dans la valeur. Les guillemets peuvent
-      habituellement être omis si la valeur est un nomnbre ou un identifiant
+      habituellement être omis si la valeur est un nombre ou un identifiant
       simple.
      </para>
     </listitem>
@@ -143,6 +143,8 @@ shared_buffers = 128MB</programlisting>
     guillemets simples. Pour intégrer un guillemet simple dans la valeur d'un
     paramètre, on écrit soit deux guillemets (c'est la méthode préférée) soit
     un antislash suivi du guillemet.
+    Si le fichier contient plusieurs entrées du même paramètre, tous sont
+    ignorés sauf le dernier.
    </para>
 
    <para>
@@ -192,21 +194,33 @@ shared_buffers = 128MB</programlisting>
      données d'un serveur <productname>PostgreSQL</productname> contient un
      fichier <filename>postgresql.auto.conf</filename>
      <indexterm><primary>postgresql.auto.conf</primary></indexterm>, qui a le
-     même format que le fichier <filename>postgresql.conf</filename>. Cependant,
-     il ne devrait jamais être édité manuellement. Ce fichier contient les
+     même format que le fichier <filename>postgresql.conf</filename> et qui a
+     pour but d'être modifié automatiquement plutôt que manuellement.
+     Ce fichier contient les
      configurations réalisées avec la commande <xref linkend="sql-altersystem"/>.
-     Ce fichier est lu automatiquement quand le fichier
-     <filename>postgresql.conf</filename> et lu, et son contenu prend effet de
+     Ce fichier est lu à chaque fois que le fichier
+     <filename>postgresql.conf</filename> est lu, et son contenu prend effet de
      la même façon. Les paramètres configurés dans
      <filename>postgresql.auto.conf</filename> surchargent ceux configurés dans
      <filename>postgresql.conf</filename>.
     </para>
 
+    <para>
+     Des outils externes peuvent aussi modifier le fichier
+     <filename>postgresql.auto.conf</filename>. Il n'est pas recommandé de le
+     faire alors que le serveur est en cours d'exécution car une commande
+     <command>ALTER SYSTEM</command> exécutée en parallèle pourrait supprimer
+     de telles modifications. De tels outils devraient simplement ajouter
+     les nouvelles configurations à la fin. Ils pourraient aussi choisir de
+     supprimer les configurations dupliquées et/ou les commentaires
+     (ce que fait <command>ALTER SYSTEM</command>).
+    </para>
+
     <para>
      La vue système
      <link linkend="view-pg-file-settings"><structname>pg_file_settings</structname></link>
-     peut être utile pour tester par avance des modifications dans le
-     fichier de configuration, ou pour diagnostiquer des problèmes si
+     peut être utile pour tester par avance des modifications dans les
+     fichiers de configuration, ou pour diagnostiquer des problèmes si
      un signal <systemitem>SIGHUP</systemitem> n'a pas eu les effets
      désirés.
     </para>
@@ -6530,10 +6544,8 @@ Ces paramètres contrôlent le comportement de la fonctionnalité appelée
     séparément pour chaque tentative d'acquisition d'un verrou. La limite
     s'applique pour les demandes de verrous explicites (comme <command>LOCK
      TABLE</command>, ou <command>SELECT FOR UPDATE</command> sans
-    <literal>NOWAIT</literal>) et pour ceux acquis implicitement. Si
-    <varname>log_min_error_statement</varname> est configuré à
-    <literal>ERROR</literal> ou plus bas, l'instruction qui dépasse ce délai
-    sera tracé. Une valeur de zéro (valeur par défaut) désactive ce
+    <literal>NOWAIT</literal>) et pour ceux acquis implicitement.
+    Une valeur de zéro (valeur par défaut) désactive ce
     comportement.
    </para>
 
@@ -6543,7 +6555,10 @@ Ces paramètres contrôlent le comportement de la fonctionnalité appelée
     <varname>statement_timeout</varname> est différent de zéro, il est
     plutôt inutile de configurer <varname>lock_timeout</varname> à la
     même valeur ou à une valeur plus importante puisque le délai sur la
-    requête se déclenchera toujours avant.
+    requête se déclenchera toujours avant. Si
+    <varname>log_min_error_statement</varname> est configuré à
+    <literal>ERROR</literal> ou plus bas, l'instruction qui dépasse ce délai
+    sera tracé. 
    </para>
 
    <para>

postgresql/custom-scan.xml

@@ -102,10 +102,7 @@ typedef struct CustomPath
    comme prévu. <structfield>methods</structfield> doit pointer vers un
    objet (généralement alloué statiquement) implémentant les méthodes
    obligatoires d'un chemin personnalisé. Pour l'instant, il n'y en a
-   qu'une. Les champs <structfield>LibraryName</structfield> et
-   <structfield>SymbolName</structfield> doivent aussi être initialisés
-   pour que le chargeur dynamique puisse les résoudre pour situer la
-   table de méthode.
+   qu'une.
   </para>
 
   <para>

postgresql/datatype.xml

@@ -2261,17 +2261,17 @@ des références au 1er janvier 2000 ?
          <row>
           <entry><literal>today</literal></entry>
           <entry><type>date</type>, <type>timestamp</type></entry>
-          <entry>aujourd'hui minuit</entry>
+          <entry>aujourd'hui minuit (<literal>00:00</literal>)</entry>
          </row>
          <row>
           <entry><literal>tomorrow</literal></entry>
           <entry><type>date</type>, <type>timestamp</type></entry>
-          <entry>demain minuit</entry>
+          <entry>demain minuit (<literal>00:00</literal>)</entry>
          </row>
          <row>
           <entry><literal>yesterday</literal></entry>
           <entry><type>date</type>, <type>timestamp</type></entry>
-          <entry>hier minuit</entry>
+          <entry>hier minuit (<literal>00:00</literal>)</entry>
          </row>
          <row>
           <entry><literal>allballs</literal></entry>

postgresql/ecpg.xml

@@ -81,7 +81,7 @@ EXEC SQL ...;
    linkend="ddl-schemas-patterns">méthode sécurisée d'usage des
    schemas</link>, commencez chaque session en supprimant les schémas
    modifiables par tout le monde du paramètre <varname>search_path</varname>.
-   Par exemple, ajoutez <literal>options=-csearch_path=</literal> à
+   Par exemple, ajoutez <literal>options=-c search_path=</literal> à
    <literal><replaceable>options</replaceable></literal> ou exécutez
    <literal>EXEC SQL SELECT pg_catalog.set_config('search_path', '',
    false);</literal> tout de suite après la connexion. Cette considération
@@ -189,6 +189,19 @@ EXEC SQL CONNECT TO <replaceable>cible</replaceable> <optional>AS <replaceable>n
     une chaîne SQL littérale, ou une référence à une variable caractère.
    </para>
 
+   <para>
+    Si la cible de connexion indiclut des <replaceable>options</replaceable>,
+    ils doivent consister en des paires
+    <literal><replaceable>motclé</replaceable>=<replaceable>valeur</replaceable></literal>
+    séparées par un point-virgule (<literal>&amp;</literal>).
+    Les mots-clés autorisés sont les mêmes que ceux reconnus par
+    <application>libpq</application> (voir
+    <xref linkend="libpq-paramkeywords"/>). Les espaces sont ignorés avant tout
+    <replaceable>motclé</replaceable> ou <replaceable>valeur</replaceable>, mais
+    pas à l'intérieur de l'un ou l'autre. Notez qu'il n'existe pas de moyens
+    d'écrire <literal>&amp;</literal> dans une <replaceable>valeur</replaceable>.
+   </para>
+
    <para>
     Le <replaceable>nom-connexion</replaceable> est utilisé pour gérer
     plusieurs connexions dans un programme. Il peut être omis si le programme
@@ -4955,7 +4968,7 @@ struct
 
    <para>
     Les champs <structfield>sqlcaid</structfield>,
-    <structfield>sqlcabc</structfield>,
+    <structfield>sqlabc</structfield>,
     <structfield>sqlerrp</structfield>, et les éléments restants de
     <structfield>sqlerrd</structfield> et
     <structfield>sqlwarn</structfield> ne contiennent pour le moment
@@ -6421,7 +6434,7 @@ DATABASE <replaceable>connection_target</replaceable>
     </varlistentry>
 
     <varlistentry>
-     <term><replaceable class="PARAMETER">connection_object</replaceable></term>
+     <term><replaceable class="PARAMETER">connection_name</replaceable></term>
      <listitem>
       <para>
        Un identifiant optionnel pour la connexion, afin qu'on puisse

postgresql/extend.xml

@@ -825,7 +825,7 @@ SELECT pg_catalog.pg_extension_config_dump('my_config', 'WHERE NOT standard_entr
     sa base de données dynamiquement d'une version à une autre, vous pouvez
     fournir <firstterm>des scripts de mise à jour</firstterm> qui feront les
     modifications nécessaires. Les scripts de mise à jour ont un nom qui correspond au format
-    <literal><replaceable>extension</replaceable>--<replaceable>oldversion</replaceable>--<replaceable>newversion</replaceable>.sql</literal>
+    <literal><replaceable>extension</replaceable>--<replaceable>ancienne_version</replaceable>--<replaceable>nouvelle_version</replaceable>.sql</literal>
     (par exemple, <literal>foo--1.0--1.1.sql</literal> contient les commandes pour modifier
     la version <literal>1.0</literal> de l'extension <literal>foo</literal> en la version
     <literal>1.1</literal>).

postgresql/fdwhandler.xml

@@ -793,10 +793,12 @@ IsForeignRelUpdatable (Relation rel);
      modifient les lignes, une par une. Dans certains cas, cette approche
      ligne par ligne est nécessaire mais elle peut s'avérer inefficace. S'il
      est possible pour le serveur distant de déterminer les lignes à modifier
-     sans avoir à les récupérer, et qu'il n'y a pas de triggers locals qui
-     pourraient affecter l'opération, alors il est possible de s'arranger pour
-     que l'opération entière soit réalisée sur le serveur distant. Les
-     interfaces décrites ci-dessous rendent cela possible.
+     sans avoir à les récupérer, et qu'il n'y a pas de structures locales qui
+     pourraient affecter l'opération (triggers locaux niveau ligne ou
+     contraintes <literal>WITH CHECK OPTION</literal> à partir des vues
+     parents), alors il est possible de s'arranger pour que l'opération entière
+     soit réalisée sur le serveur distant. Les interfaces décrites ci-dessous
+     rendent cela possible.
     </para>
 
     <para>

postgresql/func.xml

@@ -2812,7 +2812,7 @@ champs, adressable en tant qu'entité.) -->
     </row>
 
     <row>
-     <entry><literal>tcvn_to_utf8</literal></entry>
+     <entry><literal>windows_1258_to_utf8</literal></entry>
      <entry><literal>WIN1258</literal></entry>
      <entry><literal>UTF8</literal></entry>
     </row>
@@ -2980,7 +2980,7 @@ champs, adressable en tant qu'entité.) -->
     </row>
 
     <row>
-     <entry><literal>utf8_to_tcvn</literal></entry>
+     <entry><literal>utf8_to_windows_1258</literal></entry>
      <entry><literal>UTF8</literal></entry>
      <entry><literal>WIN1258</literal></entry>
     </row>
@@ -12480,14 +12480,14 @@ END</synopsis>
        <row>
         <entry> <literal>@&gt;</literal> </entry>
         <entry>contient</entry>
-        <entry><literal>ARRAY[1,4,3] @&gt; ARRAY[3,1]</literal></entry>
+        <entry><literal>ARRAY[1,4,3] @&gt; ARRAY[3,1,3]</literal></entry>
         <entry><literal>t</literal></entry>
        </row>
 
        <row>
         <entry> <literal>&lt;@</literal> </entry>
         <entry>est contenu par</entry>
-        <entry><literal>ARRAY[2,7] &lt;@ ARRAY[1,7,4,2,6]</literal></entry>
+        <entry><literal>ARRAY[2,2,7] &lt;@ ARRAY[1,7,4,2,6]</literal></entry>
         <entry><literal>t</literal></entry>
        </row>
 
@@ -12530,13 +12530,12 @@ END</synopsis>
           </tgroup>
          </table>
 
-         <!-- SAS 20080806 : row-major doit-il être conservé, sans traduction ?
-     Non. Traduit pas premier index, ou lignes, un tableau à deux dimensions
-     est une matrice [ligne][colonne] -->
          <para>
-          Les comparaisons de tableaux comparent les contenus des tableaux élément par
-          élément, en utilisant la fonction de comparaison par défaut du B-Tree pour
-          le type de données de l'élément. Dans les tableaux multidimensionnels,
+          Les opérateurs de tri de tableau (<literal>&lt;</literal>,
+          <literal>&gt;=</literal>, etc) comparent le contenu d'un tableau,
+          élément par élément, en utilisant la fonction de comparaison B-tree
+          par défaut pour le type de données de l'élément. Le tri est basé sur
+          la première différence. Dans les tableaux multi-dimensionnels,
           les éléments sont visités dans l'ordre des colonnes (<quote>row-major
            order</quote>, le dernier indice varie le plus rapidement).
           Si le contenu de deux tableaux est identique, mais que les dimensions sont
@@ -12548,6 +12547,15 @@ END</synopsis>
           diffèrent.)
          </para>
 
+         <para>
+          Les opérateurs de contenu des tableaux (<literal>&lt;@</literal> et
+          <literal>@&gt;</literal>) considèrent qu'un tableau est contenu dans
+          un autre tableau si chacun de ses éléments apparait dans l'autre. Les
+          duplicats ne sont pas traités spécialement, donc
+          <literal>ARRAY[1]</literal> et <literal>ARRAY[1,1]</literal> sont
+          tous les deux considérés contenus dans l'autre.
+         </para>
+
          <para>
           Voir la <xref linkend="arrays"/> pour plus de détails sur le comportement des
           opérateurs. Voir <xref linkend="indexes-types"/> pour plus d'informations sur
@@ -13325,7 +13333,7 @@ END</synopsis>
               sinon identique au type de données de l'argument
              </entry>
              <entry>Oui</entry>
-             <entry>la moyenne arithmétique de toutes les valeurs en
+             <entry>la moyenne arithmétique de toutes les valeurs non NULL en
               entrée</entry>
             </row>
 
@@ -13449,7 +13457,7 @@ END</synopsis>
               <type>json</type>
              </entry>
              <entry>Non</entry>
-             <entry>agrège les valeurs sous la forme d'un tableau JSON</entry>
+             <entry>agrège les valeurs, incluant les NULL, sous la forme d'un tableau JSON</entry>
             </row>
 
             <row>
@@ -13483,7 +13491,8 @@ END</synopsis>
               <type>json</type>
              </entry>
              <entry>Non</entry>
-             <entry>agrège les paires nom/valeur en tant qu'objet JSON</entry>
+             <entry>agrège les paires nom/valeur en tant qu'objet JSON&nbsp;; les valeurs peuvent
+        être NULL, mais pas les nom</entry>
             </row>
 
             <row>
@@ -13500,7 +13509,8 @@ END</synopsis>
        <type>jsonb</type>
       </entry>
       <entry>Non</entry>
-      <entry>agrège les paires nom/valeur en tant qu'objet JSON</entry>
+      <entry>agrège les paires nom/valeur en tant qu'objet JSON&nbsp;; les valeurs peuvent
+        être NULL, mais pas les nom</entry>
      </row>
 
      <row>
@@ -13514,8 +13524,8 @@ END</synopsis>
              <entry>identique au type en argument</entry>
              <entry>Oui</entry>
              <entry>
-              valeur maximale de l'<replaceable class="parameter">expression</replaceable> pour toutes les valeurs en
-              entrée
+              valeur maximale de l'<replaceable class="parameter">expression</replaceable>
+              pour toutes les valeurs non NULL en entrée
              </entry>
             </row>
 
@@ -13531,8 +13541,8 @@ END</synopsis>
              <entry>identique au type en argument</entry>
              <entry>Oui</entry>
              <entry>
-              valeur minimale de l'<replaceable class="parameter">expression</replaceable> pour toutes les valeurs en
-              entrée
+              valeur minimale de l'<replaceable class="parameter">expression</replaceable>
+              pour toutes les valeurs non NULL en entrée
              </entry>
             </row>
 
@@ -13553,7 +13563,7 @@ END</synopsis>
               identique aux arguments
              </entry>
              <entry>Non</entry>
-             <entry>valeurs en entrées concaténées dans une chaîne, séparées par un
+             <entry>valeurs non NULL en entrée concaténées dans une chaîne, séparées par un
               délimiteur</entry>
             </row>
 
@@ -13577,7 +13587,7 @@ END</synopsis>
              </entry>
              <entry>Oui</entry>
              <entry>somme de l'<replaceable class="parameter">expression</replaceable>
-              pour toutes les valeurs en entrée</entry>
+              pour toutes les valeurs non NULL en entrée</entry>
             </row>
 
             <row>
@@ -13594,7 +13604,7 @@ END</synopsis>
               <type>xml</type>
              </entry>
              <entry>Non</entry>
-             <entry>concaténation de valeurs XML (voir aussi <xref
+             <entry>concaténation de valeurs XML non NULL (voir aussi <xref
               linkend="functions-xml-xmlagg"/>)</entry>
             </row>
 

postgresql/gist.xml

@@ -724,8 +724,8 @@ my_picksplit(PG_FUNCTION_ARGS)
 
         /*
          * Choose where to put the index entries and update unionL and unionR
-         * accordingly. Append the entries to either v_spl_left or
-         * v_spl_right, and care about the counters.
+         * accordingly. Append the entries to either v->spl_left or
+         * v->spl_right, and care about the counters.
          */
 
         if (my_choice_is_left(unionL, curl, unionR, curr))
@@ -951,7 +951,7 @@ Datum
 my_fetch(PG_FUNCTION_ARGS)
 {
     GISTENTRY  *entry = (GISTENTRY *) PG_GETARG_POINTER(0);
-    input_data_type *in = DatumGetP(entry->key);
+    input_data_type *in = DatumGetPointer(entry->key);
     fetched_data_type *fetched_data;
     GISTENTRY  *retval;
 
@@ -962,7 +962,7 @@ my_fetch(PG_FUNCTION_ARGS)
      * Convertit 'fetched_data' en un Datum du type de données original.
      */
 
-    /* remplit *retval à partir de fetch_data. */
+    /* remplit *retval à partir de fetched_data. */
     gistentryinit(*retval, PointerGetDatum(converted_datum),
                   entry->rel, entry->page, entry->offset, FALSE);