Mise à jour en version 10.23

postgresql/config.xml

@@ -5349,6 +5349,13 @@ local0.*    /var/log/postgresql
 <sect2 id="runtime-config-logging-what">
  <title>Que tracer</title>
 
+ <note>
+  <para>
+   Ce que vous choisissez de tracer peut avoir des implications sur la sécurité&nbsp;;
+   voir <xref linkend="logfile-maintenance"/>.
+  </para>
+ </note>
+
  <variablelist>
 
   <varlistentry id="guc-application-name" xreflabel="application_name">
@@ -5799,6 +5806,10 @@ log_line_prefix = '%m [%p] %q%u@%d/%a '
       <varname>log_min_error_statement</varname> doit être positionné à
       <literal>ERROR</literal> pour tracer ce type d'instructions.
      </para>
+     <para>
+      Les requêtes tracées peuvent révéler des données sensibles et même
+      contenir des mots de passe en clair.
+     </para>
     </note>
    </listitem>
   </varlistentry>

postgresql/datatype.xml

@@ -1145,6 +1145,8 @@ SELECT '52093.89'::money::numeric::float8;
     <type>char(<replaceable>n</replaceable>)</type> sont des alias de
     <type>character varying(<replaceable>n</replaceable>)</type> et
     <type>character(<replaceable>n</replaceable>)</type>, respectivement.
+    Si indiqué, la longueur doit être supérieure à zéro et ne peut pas
+    excéder 10485760.
     <type>character</type> sans indication de taille est équivalent à
     <type>character(1)</type>. Si <type>character varying</type> est
     utilisé sans indicateur de taille, le type accepte des chaînes de

postgresql/docguide.xml

@@ -73,13 +73,13 @@
    formats de sortie finaux. DocBook est maintenu par le groupe
    <ulink url="http://www.oasis-open.org">OASIS</ulink> . Le <ulink
    url="http://www.oasis-open.org/docbook">site officiel de
-    DocBook</ulink> présente une bonne documentation d'introduction et
+   DocBook</ulink> présente une bonne documentation d'introduction et
    de référence ainsi qu'un livre complet de chez O'Reilly disponible à la
    lecture en ligne. Le <ulink
    url="http://newbiedoc.sourceforge.net/metadoc/docbook-guide.html">guide
-    DocBook des nouveaux venus</ulink> est très utile pour les débutants. Le
-   <ulink url="http://www.freebsd.org/docproj/docproj.html">projet de
-    documentation FreeBSD</ulink> utilise également DocBook et fournit
+   DocBook des nouveaux venus</ulink> est très utile pour les débutants. Le
+   <ulink url="https://www.freebsd.org/docproj/">projet de
+   documentation FreeBSD</ulink> utilise également DocBook et fournit
    également de bonnes informations, incluant un certain nombre de
    lignes directrices qu'il peut être bon de prendre en considération.
   </para>

postgresql/func.xml

@@ -11575,7 +11575,12 @@ transformation-table2
    linkend="functions-comparison-op-table"/> sont disponibles pour le type
    <type>jsonb</type>, mais pas pour le type <type>json</type>. Ils suivent les
    règles de tri des opérations B-tree soulignées dans <xref
-   linkend="json-indexing"/>.
+   linkend="json-indexing"/>.  Voir aussi <xref linkend="functions-aggregate"/>
+   pour la fonction d'agrégat <function>json_agg</function> qui agrège les
+   valeurs d'enregistrement sous la forme d'un document JSON, la fonction
+   d'agrégat <function>json_object_agg</function> qui agrège les paires de
+   valeurs dans un objet JSON, et leurs équivalents <type>jsonb</type>, à savoir
+   <function>jsonb_agg</function> et <function>jsonb_object_agg</function>.
   </para>
   <para>
    Des opérateurs supplémentaires existent seulement pour le type
@@ -12440,15 +12445,6 @@ transformation-table2
         <type>jsonb</type> n'ont jamais des noms de champs dupliqués.
        </para>
       </note>
-
-      <para>
-       Voir aussi <xref linkend="functions-aggregate"/> pour la fonction d'agrégat
-       <function>json_agg</function> qui agrège les valeurs en tant que JSON, et
-       la fonction d'agrégat <function>json_object_agg</function> qui agrège les
-       paires de valeurs en un objet JSON, et leurs équivalents <type>jsonb</type>,
-       <function>jsonb_agg</function> et <function>jsonb_object_agg</function>.
-      </para>
-
      </sect1>
 
      <sect1 id="functions-sequence">

postgresql/indices.xml

@@ -115,7 +115,9 @@
 
   <para>
    <productname>PostgreSQL</productname> propose plusieurs types d'index&nbsp;:
-   B-tree, Hash, GiST, SP-GiST, GIN et BRIN. Chaque type d'index utilise un algorithme
+   B-tree, Hash, GiST, SP-GiST, GIN, BRIN et l'extension <link
+   linkend="bloom">bloom</link>.
+   Chaque type d'index utilise un algorithme
    différent qui convient à un type particulier de requêtes. Par défaut, la
    commande <command>CREATE INDEX</command> crée un index B-tree, ce qui
    convient dans la plupart des situations.

postgresql/install-windows.xml

@@ -125,7 +125,7 @@
   </para>
 
   <para>
-   Avant de lancer la construction, vous aurez besoin d'éditer le fichier
+   Avant de lancer la construction, vous pouvez créer le fichier
    <filename>config.pl</filename> pour y modifier toutes les options de
    configuration nécessaires, ainsi que les chemins utilisés par les
    bibliothèques de tierces parties. La configuration complète est déterminée

postgresql/installation.xml

@@ -927,7 +927,7 @@ su - postgres
        <listitem>
         <para>
          <option>bsd</option> pour utiliser les fonctions UUID trouvées dans
-         FreeBSD, NetBSD et quelques autres systèmes dérivés de BSD
+         FreeBSD et quelques autres systèmes dérivés de BSD
         </para>
        </listitem>
        <listitem>

postgresql/libpq.xml

@@ -2169,10 +2169,8 @@ const char *PQsslAttribute(const PGconn *conn, const char *attribute_name);
          <term><literal>compression</literal></term>
          <listitem>
           <para>
-           Si la compression SSL est utilisée, renvoie le nom de
-           l'algorithme de compression, ou "on" si la compression est
-           utilisée mais que l'algorithme est inconnu. Si la compression
-           n'est pas utilisée, renvoie "off".
+           Renvoie <literal>on</literal> si la compression SSL est en cours
+           d'utilisation. Renvoie <literal>off</literal> dans le cas contraire.
           </para>
          </listitem>
         </varlistentry>

postgresql/maintenance.xml

@@ -997,9 +997,29 @@ HINT:  Stop the postmaster and vacuum that database in single-user mode.
 
   <para>
    Sauvegarder les journaux de trace du serveur de bases de données dans un
-   fichier plutôt que dans <filename>/dev/NULL</filename> est une bonne idée. Les
+   fichier plutôt que dans <filename>/dev/null</filename> est une bonne idée. Les
    journaux sont d'une utilité incomparable lorsqu'arrive le moment où des
-   problèmes surviennent. Néanmoins, les journaux ont tendance à être
+   problèmes surviennent.
+  </para>
+
+  <note>
+   <para>
+    Les traces d'un serveur peuvent contenir des informations sensibles et ont
+    besoin d'être protégées, peu importe où et comment ils sont enregistrés, ou
+    leur destination d'envoi. Par exemple, certaines requêtes DDL pourraient
+    contenir des mots de passe en clair ou d'autres détails d'authentification.
+    Les instructions tracées au niveau <literal>ERROR</literal> pourraient
+    afficher le code source SQL des applications, et pourraient aussi contenir
+    une partie des lignes de données. Enregistrer des données, événements et
+    informations relatives est le but assumé de cette fonctionnalité, donc il ne
+    s'agit pas d'une fuite d'information ou d'un bug. Merci de vous assurer que
+    les traces du serveur sont visibles uniquement par les personnes
+    appropriées.
+   </para>
+  </note>
+
+  <para>
+   Les journaux ont tendance à être
    volumineux (tout spécialement à des niveaux de débogage importants) et vous
    ne voulez pas les sauvegarder indéfiniment. Vous avez besoin de faire une
    <quote>rotation</quote> des journaux pour que les nouveaux journaux sont

postgresql/monitoring.xml

@@ -3273,6 +3273,19 @@ SELECT pid, wait_event_type, wait_event FROM pg_stat_activity WHERE wait_event i
     </tgroup>
    </table>
 
+   <warning>
+    <para>
+     Utiliser <function>pg_stat_reset()</function> réinitialise aussi les
+     compteurs que l'autovacuum utilise pour déterminer quand déclencher une
+     opération VACUUM ou une opération ANALYZE. Réinitialiser ces compteurs peut
+     empêcher l'autovacuum de réaliser un travail pourtant nécessaire, ce qui
+     entrainerait comme conséquence une fragmentation des tables ou des
+     statistiques obsolètes sur les données des tables. Un
+     <command>ANALYZE</command> sur la base est recommandé après avoir
+     réinitialisé les statistiques.
+    </para>
+   </warning>
+
    <para>
     <function>pg_stat_get_activity</function>, la fonction sous-jacente de
     la vue <structname>pg_stat_activity</structname>, retourne un ensemble

postgresql/queries.xml

@@ -2112,8 +2112,10 @@ SELECT sum(n) FROM t;</programlisting>
   <note>
    <para>
     Dans son appellation stricte, ce processus est une itération, pas une
-    récursion, mais <literal>RECURSIVE</literal> est la terminologie choisie
-    par le comité de standardisation de SQL.
+    récursion, mais <literal>RECURSIVE</literal> est la terminologie choisie par
+    le comité de standardisation de SQL. Alors que <literal>RECURSIVE</literal>
+    autorise la spécification récursive des requêtes, en interne, ce type de
+    requêtes est évalué itérativement.
    </para>
   </note>
 
@@ -2133,7 +2135,7 @@ SELECT sum(n) FROM t;</programlisting>
 <programlisting>WITH RECURSIVE parties_incluses(sous_partie, partie, quantite) AS (
     SELECT sous_partie, partie, quantite FROM parties WHERE partie = 'notre_produit'
   UNION ALL
-    SELECT p.sous_partie, p.partie, p.quantite
+    SELECT p.sous_partie, p.partie, p.quantite * pr.quantite
     FROM parties_incluses pr, parties p
     WHERE p.partie = pr.sous_partie
   )

postgresql/query.xml

@@ -679,24 +679,25 @@ ORDER BY ville;</programlisting>
     ce qui nous donne une ligne par ville dans le résultat. Chaque résultat
     d'agrégat est calculé avec les lignes de la table correspondant à la ville.
     Nous pouvons filtrer ces lignes groupées en utilisant
-    <literal>HAVING</literal>&nbsp;:
+    <literal>HAVING</literal> et le décompte en sortie en utilisant
+    <literal>FILTER</literal> &nbsp;:
 
-<programlisting>SELECT ville, max(t_basse)
+<programlisting>SELECT ville, max(t_basse), count(*) FILTER (WHERE t_basse &lt; 30)
     FROM temps
     GROUP BY ville
     HAVING max(t_basse) &lt; 40;</programlisting>
 
-<screen>  ville  | max
----------+-----
- Hayward |  37
-(1 row)</screen>
+<screen>  ville  | max | count
+---------+-----+-------
+ Hayward |  37 |     5
+</screen>
 
     ce qui nous donne le même résultat uniquement pour les villes qui ont
     toutes leurs valeurs de  <structfield>t_basse</structfield> en dessous de
     40. Pour finir, si nous nous préoccupons seulement des villes dont le nom
     commence par <quote><literal>S</literal></quote>, nous pouvons faire&nbsp;:
 
-<programlisting>SELECT ville, max(t_basse)
+<programlisting>SELECT ville, max(t_basse), count(*) FILTER (WHERE t_basse &lt; 30)
     FROM temps
     WHERE ville LIKE 'S%' -- <co id="co.tutorial-agg-like"/>
     GROUP BY ville

postgresql/ref/analyze.xml

@@ -200,17 +200,17 @@
   </para>
 
   <para>
-   Si la table en cours d'analyse a un ou plusieurs enfants,
-   <command>ANALYZE</command> récupérera deux fois les statistiques&nbsp;:
-   une fois sur les lignes de la table parent seulement et une deuxième fois
-   sur les lignes de la table parent et de tous ses enfants. Ce deuxième
-   ensemble de statistiques est nécessaire lors de la planification des
-   requêtes qui traversent l'arbre d'héritage complet. Néanmoins, le
-   démon autovacuum ne considérera que les insertions et mises à jour sur la
-   table parent elle-même pour décider du lancement automatique d'un ANALYZE sur cette table. Si des
-   lignes sont rarement insérées ou mises à jour dans cette table, les
-   statistiques d'héritage ne seront à jour que si vous lancez manuellement
-   un <command>ANALYZE</command>.
+   Si la table en cours d'analyse a des enfants, <command>ANALYZE</command>
+   récupère deux ensembles de statistiques&nbsp;: un sur les lignes de la table
+   parent seulement et un autre sur les lignes de la table parent et de tous ses
+   enfants. Ce deuxième ensemble de statistiques est nécessaire lors de la
+   planification des requêtes qui traversent l'arbre d'héritage complet. Les
+   tables enfants ne sont pas analysées individuellement dans ce cas. Néanmoins,
+   le démon autovacuum ne considérera que les insertions et mises à jour sur la
+   table parent elle-même pour décider du lancement automatique d'un ANALYZE sur
+   cette table. Si des lignes sont rarement insérées ou mises à jour dans cette
+   table, les statistiques d'héritage ne seront à jour que si vous lancez
+   manuellement un <command>ANALYZE</command>.
   </para>
 
   <para>
@@ -224,16 +224,6 @@
    garantie d'être vide.
   </para>
 
-  <para>
-   Par contre, si la table en cours d'analyse a des enfants par héritage,
-   <command>ANALYZE</command> récupère les deux ensembles de statistiques&nbsp;:
-   une sur les lignes de la table parent seule, et une autre incluant les lignes
-   de la table parent et des tables filles. Ce deuxième ensemble de statistiques
-   est nécessaire pour planifier des requêtes qui traitent l'arbre d'héritage
-   dans son ensemble. Les tables filles elles-mêmes ne sont pas analysées
-   individuellement dans ce cas.
-  </para>
-
   <para>
    Le démon autovacuum ne traite pas les tables partitionnées, pas plus qu'il ne
    traite les parents en héritage si seules les tables filles sont modifiées.

postgresql/ref/create_database.xml

@@ -17,15 +17,15 @@
 
  <refsynopsisdiv>
   <synopsis>CREATE DATABASE <replaceable class="parameter">nom</replaceable>
-    [ [ WITH ] [ OWNER [=] <replaceable class="parameter">nom_utilisateur</replaceable> ]
+    [ WITH ] [ OWNER [=] <replaceable class="parameter">nom_utilisateur</replaceable> ]
                [ TEMPLATE [=] <replaceable class="parameter">modèle</replaceable> ]
                [ ENCODING [=] <replaceable class="parameter">codage</replaceable> ]
                [ LC_COLLATE [=] <replaceable class="parameter">lc_collate</replaceable> ]
                [ LC_CTYPE [=] <replaceable class="parameter">lc_ctype</replaceable> ]
                [ TABLESPACE [=] <replaceable class="parameter">tablespace</replaceable> ]
                [ ALLOW_CONNECTIONS [=] <replaceable class="parameter">connexion_autorisee</replaceable> ]
                [ CONNECTION LIMIT [=] <replaceable class="parameter">limite_connexion</replaceable> ]
-               [ IS_TEMPLATE [=] <replaceable class="parameter">est_template</replaceable> ] ]
+               [ IS_TEMPLATE [=] <replaceable class="parameter">est_template</replaceable> ]
   </synopsis>
  </refsynopsisdiv>
 

postgresql/ref/create_index.xml

@@ -172,8 +172,9 @@
       Le nom de la méthode à utiliser pour l'index. Les choix sont
       <literal>btree</literal>, <literal>hash</literal>,
       <literal>gist</literal>, <literal>spgist</literal>,
-      <literal>gin</literal> et <literal>brin</literal>. La méthode par défaut
-      est <literal>btree</literal>.
+      <literal>gin</literal>, <literal>brin</literal> ou les méthodes d'accès
+      installés par les utilisateurs comme <link linkend="bloom">bloom</link>.
+      La méthode par défaut est <literal>btree</literal>.
      </para>
     </listitem>
    </varlistentry>

postgresql/ref/create_publication.xml

@@ -165,10 +165,9 @@ CREATE PUBLICATION <replaceable class="parameter">nom</replaceable>
 
   <para>
    Pour une commande <command>INSERT ... ON CONFLICT</command>, la publication
-   publiera l'opération qui résulte réellement de la commande.  Ainsi, en
-   fonction du résultat, cela pourrait être publiée comme un
-   <command>INSERT</command> ou un <command>UPDATE</command>, ou cela pourrait
-   ne pas être publié du tout.
+   publiera l'opération qui résulte de la commande. Ainsi, en fonction du
+   résultat, cela pourrait être publiée comme un <command>INSERT</command> ou un
+   <command>UPDATE</command>, ou cela pourrait ne pas être publié du tout.
   </para>
 
   <para>

postgresql/ref/create_sequence.xml

@@ -288,7 +288,7 @@
    les valeurs 1..10 et récupérer <function>nextval</function>=1&nbsp;; la
    session B peut alors réserver les valeurs 11..20 et récupérer
    <function>nextval</function>=11 avant que la session A n'ait engendré
-   <literal>nextval</literal>=2.
+   <function>nextval</function>=2.
    De ce fait, un paramétrage de <replaceable class="parameter">cache</replaceable> à un
    permet d'assumer que les valeurs retournées par <function>nextval</function> sont
    engendrées séquentiellement&nbsp;; avec un

postgresql/ref/create_statistics.xml

@@ -110,7 +110,9 @@ CREATE STATISTICS [ IF NOT EXISTS ] <replaceable class="parameter">nom_statistiq
     <listitem>
      <para>
       Le nom (éventuellement qualifié du nom du schéma) de la table contenant
-      le(s) colonne(s) sur lesquelles les statistiques sont calculées.
+      le(s) colonne(s) sur lesquelles les statistiques sont calculées&nbsp;;
+      voir <xref linkend="sql-analyze"/> pour une explication de la gestion de
+      l'héritage et des partitions.
      </para>
     </listitem>
    </varlistentry>

postgresql/ref/create_table_as.xml

@@ -86,9 +86,8 @@
     <term><literal>IF NOT EXISTS</literal></term>
     <listitem>
      <para>
-      Ne renvoie pas une erreur si une relation de même nom existe déjà. Un
-      message d'avertissement est renvoyé dans ce cas. Merci de vous référer à
-      <xref linkend="sql-createtable"/> pour plus de détails.
+      Ne renvoie pas une erreur si une relation de même nom existe déjà&nbsp;;
+      envoie un message d'avertissement et laisse la table sans modification.
      </para>
     </listitem>
    </varlistentry>

postgresql/ref/fetch.xml

@@ -21,9 +21,9 @@
  </refnamediv>
 
  <refsynopsisdiv>
-  <synopsis>FETCH [ <replaceable class="parameter">direction</replaceable> [ FROM | IN ] ] <replaceable class="parameter">nom_curseur</replaceable>
+  <synopsis>FETCH [ <replaceable class="parameter">direction</replaceable> ] [ FROM | IN ] <replaceable class="parameter">nom_curseur</replaceable>
 
-<phrase>où <replaceable class="parameter">direction</replaceable> peut être vide ou être&nbsp;:</phrase>
+<phrase>où <replaceable class="parameter">direction</replaceable> peut être&nbsp;:</phrase>
 
     NEXT
     PRIOR

postgresql/ref/move.xml

@@ -21,10 +21,9 @@
  </refnamediv>
 
  <refsynopsisdiv>
-  <synopsis>MOVE [ <replaceable class="parameter">direction</replaceable> [ FROM | IN ] ] <replaceable class="parameter">nom_curseur</replaceable>
+  <synopsis>MOVE [ <replaceable class="parameter">direction</replaceable> ] [ FROM | IN ] <replaceable class="parameter">nom_curseur</replaceable>
 
-<phrase>où <replaceable class="parameter">direction</replaceable> peut être
-vide ou faire partie de&nbsp;:</phrase>
+<phrase>où <replaceable class="parameter">direction</replaceable> peut faire partie de&nbsp;:</phrase>
 
     NEXT
     PRIOR