Merge v13 RC1

postgresql/advanced.xml

@@ -626,7 +626,7 @@ CREATE VIEW villes AS
 );
 
 CREATE TABLE capitales (
-  etat      char(2)
+  etat      char(2) UNIQUE NOT NULL
 ) INHERITS (villes);</programlisting>
    </para>
 
@@ -638,9 +638,9 @@ CREATE TABLE capitales (
     <classname>villes</classname>. Le type de la colonne
     <structfield>nom</structfield> est <type>text</type>, un type natif de
     <productname>PostgreSQL</productname> pour les chaînes de caractères à
-    longueur variable. La table <classname>capitales</classname> a une colonne supplémentaire,
-    <structfield>etat</structfield>, qui affiche l'état dont elles sont la
-    capitale. Sous <productname>PostgreSQL</productname>, une table peut
+    longueur variable. La table <classname>capitales</classname> a une colonne
+    supplémentaire, <structfield>etat</structfield>, qui affiche l'abréviation
+    de l'état. Sous <productname>PostgreSQL</productname>, une table peut
     hériter de zéro à plusieurs autres tables.
    </para>
 

postgresql/bgworker.xml

@@ -35,15 +35,19 @@
   <productname>PostgreSQL</productname> est démarré en incluant le nom du
   module dans <varname>shared_preload_libraries</varname>.  Un module qui
   souhaite fonctionner comme un processus en tâche de fond peut s'enregistrer en
-  appelant <function>RegisterBackgroundWorker(<type>BackgroundWorker *worker</type>)</function>
-  dans son <function>_PG_init()</function>.  Les processus en tâche de fond
-  peuvent également être démarrés après que le système ait démarré et soit en
-  fonctionnement en appelant la fonction <function>RegisterDynamicBackgroundWorker(
-   <type>BackgroundWorker *worker, BackgroundWorkerHandle **handle</type>)</function>.
-  À la différence de <function>RegisterBackgroundWorker</function>, qui ne peut
-  être appelée que depuis le postmaster,<function>RegisterDynamicBackgroundWorker</function>
-  doit être appelée depuis un processus client standard ou un processus en
-  tâche de fond.
+  appelant <function>RegisterBackgroundWorker(<type>BackgroundWorker</type>
+  <parameter>*worker</parameter>)</function> dans son
+  <function>_PG_init()</function>.  Les processus en tâche de fond peuvent
+  également être démarrés après que le système ait démarré et soit en
+  fonctionnement en appelant la fonction
+  <function>RegisterDynamicBackgroundWorker( <type>BackgroundWorker</type>
+  <parameter>*worker</parameter>, <type>BackgroundWorkerHandle</type>
+  <parameter>**handle</parameter>)</function>. À la différence de
+  <function>RegisterBackgroundWorker</function>, qui ne peut être appelée que
+  depuis le processus
+  postmaster,<function>RegisterDynamicBackgroundWorker</function> doit être
+  appelée depuis un processus client standard ou un processus en tâche de
+  fond.
  </para>
 
  <para>

postgresql/biblio.xml

@@ -121,8 +121,8 @@
   </biblioentry>
 
   <biblioentry id="ull88">
-   <title>Principles of Database and Knowledge</title>
-   <subtitle>Base Systems</subtitle>
+   <title>Principles of Database and Knowledge-Base Systems</title>
+   <subtitle>Classical Database Systems</subtitle>
    <authorgroup>
     <author>
      <firstname>Jeffrey D.</firstname>

postgresql/btree.xml

@@ -276,7 +276,7 @@
    </varlistentry>
 
    <varlistentry>
-    <term><function>inrange</function></term>
+    <term><function>in_range</function></term>
     <listitem>
      <indexterm>
       <primary>fonctions de support in_range</primary>

postgresql/catalogs.xml

@@ -10456,13 +10456,14 @@ SCRAM-SHA-256$<replaceable>&lt;nombre d'itération&gt;</replaceable>:<replaceabl
    relations complètes (tables, par exemple), les pages individuelles de
    relations, des tuples individuels de relations, les identifiants de
    transaction (virtuels et permanents) et les objets généraux de la base
-   de données (identifiés par
-   l'OID de la classe et l'OID de l'objet, de la même façon que dans
-   <structname>pg_description</structname> ou
+   de données (identifiés par l'OID de la classe et l'OID de l'objet, de la
+   même façon que dans <structname>pg_description</structname> ou
    <structname>pg_depend</structname>). De plus, le droit d'étendre une
-   relation est représenté comme un objet verrouillable distinct. Et
-   enfin, les verrous informatifs peuvent être pris sur les numéros qui
-   ont la signification définie par l'utilisateur.
+   relation est représenté comme un objet verrouillable distinct, tout comme
+   l'est le droit de mettre à jour
+   <structname>pg_database</structname>.<structfield>datfrozenxid</structfield>.
+   Et enfin, les verrous informatifs peuvent être pris sur les numéros qui ont
+   la signification définie par l'utilisateur.
   </para>
 
   <table>
@@ -10487,6 +10488,7 @@ SCRAM-SHA-256$<replaceable>&lt;nombre d'itération&gt;</replaceable>:<replaceabl
        Type de l'objet verrouillable&nbsp;:
        <literal>relation</literal>,
        <literal>extend</literal>,
+       <literal>frozenid</literal>,
        <literal>page</literal>,
        <literal>tuple</literal>,
        <literal>transactionid</literal>,

postgresql/charset.xml

@@ -823,12 +823,12 @@ CREATE COLLATION german (provider = libc, locale = 'de_DE');
      </varlistentry>
 
      <varlistentry>
-      <term><literal>CREATE COLLATION digitslast (provider = icu, locale = 'en-u-kr-latn-digit');</literal></term>
-      <term><literal>CREATE COLLATION digitslast (provider = icu, locale = 'en@colReorder=latn-digit');</literal></term>
+      <term><literal>CREATE COLLATION latinlast (provider = icu, locale = 'en-u-kr-grek-latn');</literal></term>
+      <term><literal>CREATE COLLATION latinlast (provider = icu, locale = 'en@colReorder=grek-latn');</literal></term>
       <listitem>
        <para>
-        Trie les chiffres après les lettres latines. (Par défaut, les chiffres
-        sont avant les lettres.)
+        Trie les lettres grecques avant les lettres latines. (Par défaut, le
+        latin est avant le grec.)
        </para>
       </listitem>
      </varlistentry>
@@ -845,8 +845,8 @@ CREATE COLLATION german (provider = libc, locale = 'de_DE');
      </varlistentry>
 
      <varlistentry>
-      <term><literal>CREATE COLLATION special (provider = icu, locale = 'en-u-kf-upper-kr-latn-digit');</literal></term>
-      <term><literal>CREATE COLLATION special (provider = icu, locale = 'en@colCaseFirst=upper;colReorder=latn-digit');</literal></term>
+      <term><literal>CREATE COLLATION special (provider = icu, locale = 'en-u-kf-upper-kr-grek-latn');</literal></term>
+      <term><literal>CREATE COLLATION special (provider = icu, locale = 'en@colCaseFirst=upper;colReorder=grek-latn');</literal></term>
       <listitem>
        <para>
         Combine ces deux options.

postgresql/config.xml

@@ -7278,6 +7278,8 @@ CREATE TABLE postgres_log
  <programlisting>
 COPY postgres_log FROM '/chemin/complet/vers/le/logfile.csv' WITH csv;
  </programlisting>
+ Il est aussi possible d'accéder au fichier via une table externe en
+ utilisant le module <xref linkend="file-fdw"/>.
 </para>
 
 <para>

postgresql/datetime.xml

@@ -589,7 +589,7 @@
   </indexterm>
 
   <para>
-   <acronym>PostgreSQL</acronym> accepte les fuseaux horaires écrits suivant
+   <productname>PostgreSQL</productname> accepte les fuseaux horaires écrits suivant
    les règles du standard <acronym>POSIX</acronym> pour la variable
    d'environnement <varname>TZ</varname>. Les spécifications de fuseau horaire
    <acronym>POSIX</acronym> sont inadéquates pour gérer la complexité des
@@ -663,7 +663,7 @@
    <literal>-</literal>). Le signe positif est utilisé pour les fuseaux
    horaires à l'<emphasis>ouest</emphasis> de Greenwich. (Notez que c'est
    l'inverse de la convention prise par l'ISO-8601 utilisée ailleurs dans
-   <acronym>PostgreSQL</acronym>.) <replaceable>hh</replaceable> peut avoir un
+   <productname>PostgreSQL</productname>.) <replaceable>hh</replaceable> peut avoir un
    ou deux chiffres&nbsp;; <replaceable>mm</replaceable> et
    <replaceable>ss</replaceable> (s'ils sont utilisées) doivent en avoir deux.
   </para>

postgresql/ddl.xml

@@ -4248,9 +4248,8 @@ ALTER INDEX measurement_city_id_logdate_key
 
      <listitem>
       <para>
-       en cas de besoin, les triggers <literal>BEFORE ROW</literal> doivent
-       être définis sur les partitions individuelles, et non sur la table
-       partitionnée.
+       les triggers <literal>BEFORE ROW</literal> ne peuvent pas changer la
+       partition de destination d'une nouvelle ligne.
       </para>
      </listitem>
 

postgresql/file-fdw.xml

@@ -27,9 +27,10 @@
 
    <listitem>
     <para>
-     Spécifie le fichier devant être lu. Doit être un chemin absolu.
-     <literal>filename</literal> ou <literal>program</literal> doit être
-     spécifié, mais pas les deux en même temps.
+     Spécifie le fichier devant être lu. Les chemins relatifs sont relatifs au
+     répertoire principal des données. <literal>filename</literal> ou
+     <literal>program</literal> doit être spécifié, mais pas les deux en même
+     temps.
     </para>
    </listitem>
   </varlistentry>
@@ -219,10 +220,12 @@
 
   <para>
    Une des utilisations évidentes de <literal>file_fdw</literal> est de rendre
-   les journaux applicatifs de PostgreSQL disponibles sous la forme d'une table.
-   Pour faire cela, vous devez tout d'abord journaliser les traces au format CSV.
-   Nous appelerons le fichier de traces <literal>pglog.csv</literal>.
-   Tout d'abord, installez l'extension <literal>file_fdw</literal>&nbsp;:
+   les journaux applicatifs de PostgreSQL disponibles sous la forme d'une
+   table. Pour faire cela, vous devez tout d'abord <link
+   linkend="runtime-config-logging-csvlog">enregistrer les traces au format
+   CSV</link>. Nous appelerons le fichier de traces
+   <literal>pglog.csv</literal>. Tout d'abord, installez l'extension
+   <literal>file_fdw</literal>&nbsp;:
   </para>
 
   <programlisting>
@@ -269,7 +272,7 @@ CREATE FOREIGN TABLE pglog (
   application_name text,
   backend_type text
 ) SERVER pglog
-OPTIONS ( filename '/home/josh/data/log/pglog.csv', format 'csv' );
+OPTIONS ( filename 'log/pglog.csv', format 'csv' );
    </programlisting>
   </para>
 

postgresql/func.xml

@@ -1068,6 +1068,8 @@ repeat('Pg', 4) <returnvalue>PgPgPgPg</returnvalue>
        </para>
        <para>
         Factoriel
+        (obsolète, utilisez à la place <link
+        linkend="function-factorial"><function>factorial()</function></link>)
        </para>
        <para>
         <literal>5 !</literal>
@@ -1360,6 +1362,23 @@ repeat('Pg', 4) <returnvalue>PgPgPgPg</returnvalue>
        </para></entry>
       </row>
 
+      <row>
+       <entry role="func_table_entry"><para role="func_signature">
+        <indexterm id="function-factorial">
+         <primary>factorial</primary>
+        </indexterm>
+        <function>factorial</function> ( <type>bigint</type> )
+        <returnvalue>numeric</returnvalue>
+       </para>
+       <para>
+        Factorielle
+       </para>
+       <para>
+        <literal>factorial(5)</literal>
+        <returnvalue>120</returnvalue>
+       </para></entry>
+      </row>
+
       <row>
        <entry role="func_table_entry"><para role="func_signature">
         <indexterm>
@@ -14260,7 +14279,7 @@ SELECT xmltable.*
                         size_sq_km float PATH 'SIZE[@unit = "sq_km"]',
                         size_other text PATH
                              'concat(SIZE[@unit!="sq_km"], " ", SIZE[@unit!="sq_km"]/@unit)',
-                        premier_name text PATH 'PREMIER_NAME' DEFAULT 'not specified') ;
+                        premier_name text PATH 'PREMIER_NAME' DEFAULT 'not specified');
 
  id | ordinality | COUNTRY_NAME | country_id | size_sq_km |  size_other  | premier_name  
 ----+------------+--------------+------------+------------+--------------+---------------
@@ -15573,7 +15592,12 @@ table2-mapping
         calls.
        </para>
        <para>
-        <literal>select * from json_populate_record(null::myrowtype, '{"a": 1, "b": ["2", "a b"], "c": {"d": 4, "e": "a  b c"}}')</literal>
+        <literal>create type subrowtype as (d int, e text);</literal>
+        <literal>create type myrowtype as (a int, b text[], c subrowtype);</literal>
+       </para>
+       <para>
+        <literal>select * from json_populate_record(null::myrowtype,
+         '{"a": 1, "b": ["2", "a b"], "c": {"d": 4, "e": "a  b c"}, "x": "foo"}')</literal>
         <returnvalue></returnvalue>
 <programlisting>
  a |   b       |      c
@@ -15605,7 +15629,10 @@ table2-mapping
         for <function>json[b]_populate_record</function>.
        </para>
        <para>
-        <literal>select * from json_populate_recordset(null::myrowtype, '[{"a":1,"b":2},{"a":3,"b":4}]')</literal>
+        <literal>create type twoints as (a int, b int);</literal>
+       </para>
+       <para>
+        <literal>select * from json_populate_recordset(null::twoints, '[{"a":1,"b":2},{"a":3,"b":4}]')</literal>
         <returnvalue></returnvalue>
 <programlisting>
  a | b
@@ -15642,7 +15669,10 @@ table2-mapping
         input record value, unmatched columns are always filled with nulls.
        </para>
        <para>
-        <literal>select * from json_to_record('{"a":1,"b":[1,2,3],"c":[1,2,3],"e":"bar","r": {"a": 123, "b": "a b c"}}') as x(a int, b text, c int[], d text, r myrowtype) </literal>
+        <literal>create type myrowtype as (a int, b text);</literal>
+       </para>
+       <para>
+        <literal>select * from json_to_record('{"a":1,"b":[1,2,3],"c":[1,2,3],"e":"bar","r": {"a": 123, "b": "a b c"}}') as x(a int, b text, c int[], d text, r myrowtype)</literal>
         <returnvalue></returnvalue>
 <programlisting>
  a |    b    |    c    | d |       r

postgresql/high-availability.xml

@@ -9,7 +9,6 @@
  <indexterm><primary>clustering</primary></indexterm>
  <indexterm><primary>partitionnement de données</primary></indexterm>
 
- <!-- seamlessly ? -->
  <para>
   Des serveurs de bases de données peuvent travailler ensemble pour permettre
   à un serveur standby de prendre rapidement la main si le serveur principal
@@ -2537,13 +2536,14 @@ LOG:  database system is ready to accept read only connections
    </para>
 
    <para>
-    Le processus d'écriture en arrière plan (background writer) est actif durant
-    la récupération et effectuera les restartpoints (points de reprise)
-    (similaires aux points de synchronisation ou checkpoints sur le primaire) et
-    les activités normales de nettoyage de blocs. Ceci peut inclure la mise à jour
-    des information de hint bit des données du serveur de standby.
-    La commande <command>CHECKPOINT</command>  est acceptée pendant la récupération,
-    bien qu'elle déclenche un restartpoint et non un checkpoint.
+    Les processus d'écriture en arrière plan (checkpointer et background
+    writer) sont actifs durant la restauration. Le processus checkpointer
+    process effectuera les restartpoints (similaires aux checkpoints sur le
+    primaire) et le processus background writer réalisera les activités
+    normales de nettoyage de blocs. Ceci peut inclure la mise à jour des
+    information de hint bit des données du serveur de standby. La commande
+    <command>CHECKPOINT</command>  est acceptée pendant la récupération, bien
+    qu'elle déclenche un restartpoint et non un checkpoint.
    </para>
   </sect2>
 

postgresql/libpq.xml

@@ -818,8 +818,9 @@ typedef struct
        <function>PQsetSSLKeyPassHook_OpenSSL</function> permet à une
        application de passer outre la <link
        linkend="libpq-ssl-clientcert">gestion par défaut des fichiers clés de
-       certificats client de libpq</link> en utilisant <xref
-       linkend="libpq-connect-sslpassword"/> ou une invite interactive.
+       certificats client</link> de la <application>libpq</application> en
+       utilisant <xref linkend="libpq-connect-sslpassword"/> ou une invite
+       interactive.
 
 <synopsis>
 void PQsetSSLKeyPassHook_OpenSSL(PQsslKeyPassHook_OpenSSL_type hook);
@@ -835,9 +836,9 @@ int callback_fn(char *buf, int size, PGconn *conn);
        <function>PQdefaultSSLKeyPassHook_OpenSSL</function>. Le callback devra
        déterminer le mot de passe pour la clé et la copier dans le résultat
        tampon <literal>buf</literal> de taille <literal>size</literal>. La
-       chaîne dans <literal>buf</literal> doit être terminée par null. Le
+       chaîne dans <parameter>buf</parameter> doit être terminée par null. Le
        callback doit retourner la longueur du mot de passe stockée dans
-       <literal>buf</literal> en excluant le caractère terminateur nul. En
+       <parameter>buf</parameter> en excluant le caractère terminateur nul. En
        cas d'échec, le callback devra affecter <literal>buf[0] =
        '\0'</literal> et retourner 0. Voir
        <function>PQdefaultSSLKeyPassHook_OpenSSL</function> dans le code
@@ -846,7 +847,7 @@ int callback_fn(char *buf, int size, PGconn *conn);
 
       <para>
        Si l'utilisateur spécifie un emplacement explicite de la clef, son
-       chemin sera dans <literal>conn->pgsslkey</literal> quand le callback
+       chemin sera dans <literal>conn->sslkey</literal> quand le callback
        est appelé. Il sera vide si le chemin de clé par défaut est utilisé.
        Pour les clés qui sont spécifiques au moteur, celui-ci est responsable
        de leurs implémentations qu'elles utilisent le callback mot de passe
@@ -7928,7 +7929,7 @@ ldap://ldap.mycompany.com/dc=mycompany,dc=com?description?one?(cn=mydatabase)
      <row>
       <entry><filename>~/.postgresql/postgresql.crt</filename></entry>
       <entry>certificat client</entry>
-      <entry>requis par le serveur</entry>
+      <entry>envoyé au serveur</entry>
      </row>
 
      <row>