Mise à jour en version 10.4

postgresql/backup.xml

@@ -33,7 +33,7 @@
    base de données identique à celle sauvegardée.
    <productname>PostgreSQL</productname> propose pour cela le programme utilitaire
    <xref linkend="app-pgdump"/>. L'usage basique est&nbsp;:
-   <synopsis>pg_dump <replaceable class="parameter">base_de_donnees</replaceable> &gt; <replaceable class="parameter">fichier_de_sortie</replaceable></synopsis>
+   <synopsis>pg_dump <replaceable class="parameter">base_de_donnees</replaceable> &gt; <replaceable class="parameter">fichier_sauvegarde</replaceable></synopsis>
    <application>pg_dump</application> écrit son résultat sur la
    sortie standard. Son utilité est expliquée plus loin.
    Bien que la commande ci-dessus crée un fichier texte,
@@ -114,8 +114,8 @@
     Les fichiers texte créés par <application>pg_dump</application> peuvent être
     lus par le programme <application>psql</application>. La syntaxe générale
     d'une commande de restauration est
-<synopsis>psql <replaceable class="parameter">base_de_donnees</replaceable> &lt; <replaceable class="parameter">fichier_d_entree</replaceable></synopsis>
-    où <replaceable class="parameter">fichier_d_entree</replaceable> est
+<synopsis>psql <replaceable class="parameter">base_de_donnees</replaceable> &lt; <replaceable class="parameter">fichier_sauvegarde</replaceable></synopsis>
+    où <replaceable class="parameter">fichier_sauvegarde</replaceable> est
     le fichier en sortie de la commande <application>pg_dump</application>. La base de données
     <replaceable class="parameter">base_de_donnees</replaceable> n'est pas créée par cette
     commande. Elle doit être créée à partir de <literal>template0</literal>
@@ -146,7 +146,7 @@
     <literal>ON_ERROR_STOP</literal> configurée pour modifier ce comportement.
     <application>psql</application> quitte alors avec un
     code d'erreur 3 si une erreur SQL survient&nbsp;:
-<programlisting>psql --set ON_ERROR_STOP=on base_de_données &lt; infile
+<programlisting>psql --set ON_ERROR_STOP=on base_de_données &lt; fichier_sauvegarde
    </programlisting>
    Dans tous les cas, une sauvegarde partiellement restaurée est obtenue.
    Si cela n'est pas souhaitable, il est possible d'indiquer que la sauvegarde
@@ -210,10 +210,10 @@
     cluster (ensemble des bases d'une instance) <productname>PostgreSQL</productname> et
     préserve les données communes au cluster, telles que les rôles et tablespaces.
     L'utilisation basique de cette commande est&nbsp;:
-<synopsis>pg_dumpall &gt; <replaceable>fichier_de_sortie</replaceable></synopsis>
+<synopsis>pg_dumpall &gt; <replaceable>fichier_sauvegarde</replaceable></synopsis>
     Le fichier de sauvegarde résultant peut être restauré avec
     <application>psql</application>&nbsp;:
-<synopsis>psql -f <replaceable class="parameter">fichier_d_entree</replaceable> postgres</synopsis>
+<synopsis>psql -f <replaceable class="parameter">fichier_sauvegarde</replaceable> postgres</synopsis>
     (N'importe quelle base de données peut être utilisée pour la connexion
     mais si le rechargement est exécuté sur un cluster vide, il est
     préférable d'utiliser <literal>postgres</literal>.)

postgresql/brin.xml

@@ -105,6 +105,19 @@
    existantes.
   </para>
 
+  <para>
+   Quand le résumé automatique est activé, chaque fois qu'un intervalle de
+   page est rempli, une requête est envoyée à autovacuum pour qu'il exécute un
+   résumé ciblé pour cet intervalle, opération à exécuter à la fin du travail
+   du prochain worker sur la même base de données. Si la queue des demandes
+   est remplie, la demande n'est pas enregistré et un message est enregistré
+   dans les traces du serveur&nbsp;:
+<screen>
+LOG:  request for BRIN range summarization for index "brin_wi_idx" page 128 was not recorded
+</screen>
+   Quand cela arrive, l'intervalle sera résumé avec la méthode habituelle lors
+   du prochain VACUUM standard de la table.
+  </para>
  </sect2>
 </sect1>
 

postgresql/config.xml

@@ -3256,7 +3256,7 @@ block : bloc vidé,  dirty bloc : bloc à vider ?
      nommés dans cette liste, qui sont à la fois connectés et qui récupèrent
      les données en temps réel (comme indiqué par l'état
      <literal>streaming</literal> dans la vue
-     <link linkend="monitoring-stats-views-table">
+     <link linkend="pg-stat-replication-view">
      <literal>pg_stat_replication</literal></link>).
      Indiquer plus d'un serveur standby synchrone permet une meilleure haute-
      disponibilité et une meilleure protection contre les pertes de données.
@@ -3520,7 +3520,7 @@ ANY <replaceable class="parameter">nb_sync</replaceable> ( <replaceable class="p
      de réception (walreceiver) sur le serveur de standby envoie des
      informations sur la progression de la réplication au serveur
      en envoi, où elles sont disponibles en utilisant la vue
-     <link linkend="monitoring-stats-views-table"><literal>pg_stat_replication</literal></link>.
+     <link linkend="pg-stat-replication-view"><literal>pg_stat_replication</literal></link>.
      Le serveur en standby
      renvoie la dernière position écrite dans le journal de transactions,
      la dernière position vidée sur disque du journal de transactions,

postgresql/datatype.xml

@@ -65,7 +65,7 @@
 
     <row>
      <entry><type>bit varying [ (<replaceable>n</replaceable>) ]</type></entry>
-     <entry><type>varbit</type></entry>
+     <entry><type>varbit [ (<replaceable>n</replaceable>) ]</type></entry>
      <entry>Suite de bits de longueur variable</entry>
     </row>
 
@@ -3156,19 +3156,29 @@ SELECT personne.nom, vacances.nombre_de_semaines FROM personne, vacances
   <sect2>
    <title>Détails d'implémentation</title>
 
+   <para>
+    Les labels enum sont sensibles à la casse, donc <type>'heureux'</type>
+    n'est pas identique à <type>'HEUREUX'</type>. Les espaces blancs dans les
+    labels sont aussi pris en compte.
+   </para>
+
+   <para>
+    Bien que les types enum ont principalement pour but d'être des ensembles
+    statiques de valeurs, il est possible d'ajouter de nouvelles valeurs à un
+    type enum existant et de renommer les valeurs existantes (voir <xref
+    linkend="sql-altertype"/>). Les valeurs existantes ne peuvent pas être
+    supprimées d'un type enum, pas plus qu'il n'est possible de modifier
+    l'ordre de tri de ces valeurs, si ce n'est en supprimant puis en re-
+    créant le type enum.
+   </para>
+
    <para>
     Une valeur enum occupe quatre octets sur disque. La longueur du label texte
     d'une valeur enum est limité au paramètre <symbol>NAMEDATALEN</symbol>
     codé en dur dans <productname>PostgreSQL</productname>&nbsp;; dans les
     constructions standards, cela signifie un maximum de 63 octets.
    </para>
 
-   <para>
-    Les labels enum sont sensibles à la casse, donc
-    <type>'heureux'</type> n'est pas identique à <type>'HEUREUX'</type>.
-    Les espaces blancs sont significatifs dans les labels.
-   </para>
-
    <para>
     Les traductions des valeurs enum internes vers des labels texte sont
     gardées dans le catalogue système <link linkend="catalog-pg-enum">

postgresql/extend.xml

@@ -989,13 +989,12 @@ SELECT * FROM pg_extension_update_paths('<replaceable>extension_name</replaceabl
 -- se plaint si le script est exécuté directement dans psql, plutôt que via CREATE EXTENSION
 \echo Use "CREATE EXTENSION pair" to load this file. \quit
 
-CREATE TYPE pair AS ( k pg_catalog.text, v pg_catalog.text );
+CREATE TYPE pair AS ( k text, v text );
  
-CREATE OR REPLACE FUNCTION pair(pg_catalog.text, pg_catalog.text)
+CREATE OR REPLACE FUNCTION pair(text, text)
 RETURNS pair LANGUAGE SQL AS 'SELECT ROW($1, $2)::@extschema@.pair;';
  
-CREATE OPERATOR ~> (LEFTARG = pg_catalog.text,
-                    RIGHTARG = pg_catalog.text, PROCEDURE = pair);
+CREATE OPERATOR ~> (LEFTARG = text, RIGHTARG = text, PROCEDURE = pair);
  
 -- "SET search_path" is easy to get right, but qualified names perform better.
 CREATE OR REPLACE FUNCTION lower(pair)

postgresql/external-projects.xml

@@ -149,7 +149,7 @@
   <para>
    Différents outils d'administration sont disponibles pour
    <productname>PostgreSQL</productname>. Le plus populaire est
-   <application><ulink url="http://www.pgadmin.org/">pgAdmin III</ulink></application>
+   <application><ulink url="http://www.pgadmin.org/">pgAdmin</ulink></application>
    mais il existe aussi plusieurs outils commerciaux.
   </para>
  </sect1>

postgresql/func.xml

@@ -10624,6 +10624,25 @@ SELECT xmlagg(x) FROM (SELECT * FROM test ORDER BY y DESC) AS tab;
             </para>
            </sect3>
 
+           <sect3>
+            <title><literal>IS NOT DOCUMENT</literal></title>
+
+            <indexterm>
+             <primary>IS NOT DOCUMENT</primary>
+            </indexterm>
+
+            <synopsis>
+             <replaceable>xml</replaceable> IS NOT DOCUMENT
+            </synopsis>
+
+            <para>
+             L'expression <literal>IS NOT DOCUMENT</literal> renvoie false si
+             la valeur XML est un document XML propre, vrai s'il ne l'est pas
+             (ie, c'est un fragment de document) et NULL si l'argument est
+             NULL.
+            </para>
+           </sect3>
+
            <sect3 id="xml-exists">
             <title><literal>XMLEXISTS</literal></title>
 
@@ -13060,7 +13079,7 @@ END</synopsis>
             <row>
              <entry>
               <literal>
-               <function>array_fill</function>(<type>anyelement</type>, <type>int[]</type>,
+               <function>array_fill</function>(<type>anyelement</type>, <type>int[]</type>
                <optional>, <type>int[]</type></optional>)
               </literal>
              </entry>

postgresql/high-availability.xml

@@ -960,7 +960,7 @@ primary_conninfo = 'host=192.168.1.50 port=5432 user=foo password=foopass'
     </para>
     <para>
      Vous pouvez obtenir la liste des processus émetteurs de WAL au moyen de la vue
-     <link linkend="monitoring-stats-views-table"><literal>pg_stat_replication</literal></link>
+     <link linkend="pg-stat-replication-view"><literal>pg_stat_replication</literal></link>
      D'importantes différences entre les champs <function>pg_current_wal_lsn</function> et
      <literal>sent_lsn</literal> peuvent indiquer que le serveur primaire est en surcharge,
      tandis que des différences entre <literal>sent_lsn</literal> et

postgresql/logical-replication.xml

@@ -557,7 +557,15 @@
    Le rôle utilisée pour la réplication doit avoir l'attribut
    <literal>REPLICATION</literal> (ou être un superutilisateur). L'accès de ce
    rôle à l'instance doit avoir été déclaré dans
-   <filename>pg_hba.conf</filename>.
+   <filename>pg_hba.conf</filename> et ce rôle doit avoir l'attribut
+   <literal>LOGIN</literal>.
+  </para>
+
+  <para>
+   Pour être capable de copier les données originales de la table, le rôle
+   utilisé pour la connexion de réplication doit avoir le droit
+   <literal>SELECT</literal> sur une table publiée (ou être un
+   superutilisateur).
   </para>
 
   <para>

postgresql/ltree.xml

@@ -37,10 +37,7 @@
    <literal>L1.L2.L3</literal>, ce qui représente le chemin de la racine
    jusqu'à un nœud particulier. La longueur d'un chemin
    est limité à 65&nbsp;Ko, mais une longueur inférieure ou égale à 2&nbsp;Ko
-   est préférable. Nous considérons qu'il ne s'agit pas d'une limitation
-   stricte. Par exemple, lataille maximum d'un chemin de label dans le
-   <ulink url="http://www.dmoz.org">catalogue DMOZ</ulink> fait environ 240
-   octets&nbsp;!
+   est préférable.
   </para>
 
   <para>

postgresql/pgtrgm.xml

@@ -105,12 +105,10 @@
       </entry>
       <entry><type>real</type></entry>
       <entry>
-       Renvoie un nombre indiquant la similarité de la première chaîne avec le
-       mot le plus similaire de la deuxième chaîne. La fonction recherche dans
-       la deuxième chaîne un mot le plus similaire, pas une sous-chaîne la plus
-       similaire. Le résultat va de zéro (indiquant que les deux chaînes sont
-       complètement différentes) à un (indiquant que la première chaîne est
-       identique à un des mots de la deuxième chaîne).
+       Renvoie un nombre qui indique la plus grande similarité entre
+       l'ensemble de trigrammes dans la première chaîne et toute étendue
+       continue d'un ensemble trié de trigrammes dans la deuxième chaîne. Pour
+       les détails, voir l'explication ci-dessous.
       </entry>
      </row>
      <row>
@@ -163,6 +161,35 @@
    </tgroup>
   </table>
 
+  <para>
+   Prenons l'exemple suivant&nbsp;:
+
+<programlisting>
+# SELECT word_similarity('word', 'two words');
+ word_similarity
+-----------------
+             0.8
+(1 row)
+</programlisting>
+
+   Dans la première chaîne, l'ensemble de trigrammes est
+   <literal>{"  w"," wo","ord","wor","rd "}</literal>. Dans la seconde chaîne,
+   l'ensemble trié de trigrammes est
+   <literal>{"  t"," tw",two,"wo ","  w"," wo","wor","ord","rds", ds "}</literal>.
+   L'étendue la plus similaire d'un ensemble trié de trigrammes dans la
+   seconde chaîne est <literal>{"  w"," wo","wor","ord"}</literal>, et la
+   similarité est <literal>0.8</literal>.
+  </para>
+
+  <para>
+   Cette fonction renvoie une valeur qui peut être comprise approximativement
+   comme la plus grande similarité entre la première chaîne et toute
+   sous-chaîne de la deuxième chaîne. Néanmoins, cette fonction n'ajoute pas
+   de remplissage aux limites de l'étendue. De ce fait, une correspondance sur
+   un mot complet obtient un meilleur score qu'une correspondance sur une
+   partie d'un mot.
+  </para>
+
   <table id="pgtrgm-op-table">
    <title>Opérateurs de <filename>pg_trgm</filename></title>
    <tgroup cols="3">
@@ -188,9 +215,10 @@
       <entry><type>text</type> <literal>&lt;%</literal> <type>text</type></entry>
       <entry><type>boolean</type></entry>
       <entry>
-       Renvoie <literal>true</literal> si son premier argument a un mot
-       similaire dans le deuxième argument et ils ont une similarité qui est
-       supérieure à la limite de similarité du mot courant configurée avec le
+       Renvoie <literal>true</literal> si la similarité entre l'ensemble de
+       trigrammes du premier argument et une étendue continue d'un ensemble
+       trie de trigrammes dans le second argument est plus grande que la
+       limite de similarité actuelle, telle qu'elle est configurée avec le
        paramètre <varname>pg_trgm.word_similarity_threshold</varname>.
       </entry>
      </row>
@@ -312,10 +340,12 @@ SELECT t, word_similarity('<replaceable>word</replaceable>', t) AS sml
   WHERE '<replaceable>word</replaceable>' &lt;% t
   ORDER BY sml DESC, t;
 </programlisting>
-   Ceci renverra toutes les valeurs dans la colonne de type texte qui ont un mot
-   suffisamment similaire à <replaceable>word</replaceable>, triées de la
-   meilleure correspondance à la pire. L'index sera utilisé pour en faire une
-   opération rapide même sur de très gros ensembles de données.
+   Ceci renverra toutes les valeurs dans la colonne texte pour lesquelles il
+   existe une étendue continue de l'ensemble ordonné de trigrammes qui est
+   suffisamment similaire à l'ensemble de trigrammes de
+   <replaceable>word</replaceable>, trié de la meilleure correspondance à la
+   pire. L'index sera utilisé pour accélérer l'opération y compris sur des
+   très gros ensembles de données.
   </para>
 
   <para>

postgresql/plhandler.xml

@@ -16,8 +16,7 @@
   Tous les appels de fonctions écrites dans un langage autre que celui
   de l'interface <quote>version 1</quote> pour les langages compilés (ce qui
   inclut les fonctions dans les langages procéduraux utilisateur, les
-  fonctions SQL et les fonctions utilisant l'interface de langage compilé
-  version 0), passent par une fonction spécifique au langage du
+  fonctions SQL), passent par une fonction spécifique au langage du
   <firstterm>gestionnaire d'appels</firstterm>.
   Le gestionnaire d'appels exécute la fonction de manière appropriée,
   par exemple en interprétant le code source fourni. Ce chapitre

postgresql/plpgsql.xml

@@ -3726,7 +3726,7 @@ ASSERT <replaceable class="parameter">condition</replaceable> <optional> , <repl
    <type>trigger</type> (pour les triggers sur les modifications de données)
    ou <type>event_trigger</type> (pour les triggers sur les événements en
    base). Des variables locales spéciales, nommées
-   <varname>PG_<replaceable>quelquechose</replaceable></varname> sont
+   <varname>TG_<replaceable>quelquechose</replaceable></varname> sont
    automatiquement définies pour décrire la condition qui a déclenché l'appel.
   </para>
 

postgresql/ref/create_policy.xml

@@ -508,8 +508,7 @@ CREATE POLICY <replaceable class="parameter">nom</replaceable> ON <replaceable c
       <row>
        <entry><command>INSERT ... RETURNING</command></entry>
        <entry>
-        Nouvelle ligne
-        <footnote id="rls-select-priv">
+        Nouvelle ligne <footnote id="rls-select-priv">
          <para>
           Si l'accès en lecture est requis pour une ligne nouvelle ou
           existante (par exemple, une clause <literal>WHERE</literal> ou
@@ -526,8 +525,7 @@ CREATE POLICY <replaceable class="parameter">nom</replaceable> ON <replaceable c
       <row>
        <entry><command>UPDATE</command></entry>
        <entry>
-        Lignes nouvelles et existantes
-        <footnoteref linkend="rls-select-priv"/>
+        Lignes nouvelles et existantes <footnoteref linkend="rls-select-priv"/>
        </entry>
        <entry>&mdash;</entry>
        <entry>Ligne existante</entry>
@@ -537,8 +535,7 @@ CREATE POLICY <replaceable class="parameter">nom</replaceable> ON <replaceable c
       <row>
        <entry><command>DELETE</command></entry>
        <entry>
-        Ligne existante
-        <footnoteref linkend="rls-select-priv"/>
+        Ligne existante <footnoteref linkend="rls-select-priv"/>
        </entry>
        <entry>&mdash;</entry>
        <entry>&mdash;</entry>