Mise à jour en version 14.1

gleu · Nov 21, 2021 · 91b752a · 91b752a
1 parent ce608e9
commit 91b752a
Show file tree

Hide file tree

Showing 20 changed files with 1,298 additions and 70 deletions.
diff --git a/postgresql/catalogs.xml b/postgresql/catalogs.xml
@@ -13384,7 +13384,7 @@ SELECT * FROM pg_locks pl LEFT JOIN pg_prepared_xacts ppx
    <structname>pg_stats_ext_exprs</structname> est aussi conçu pour présenter
    l'information dans un format plus lisible que les catalogues sous-jacents
    &mdash; au coût que ce schéma doit être étendu quand la structure des
-   statistiques change dans <link linkend="catalog-pg-statistic"><structname>pg_statistic</structname></link>.
+   statistiques change dans <structname>pg_statistic_ext</structname>.
   </para>
 
   <table>

diff --git a/postgresql/charset.xml b/postgresql/charset.xml
@@ -770,8 +770,8 @@ CREATE COLLATION german (provider = libc, locale = 'de_DE');
       pré-enregistré langue/pays, préchargé par <command>initdb</command>. Les
       utilisateurs sont encouragés à définir leur propres objets de collation
       pour adapter le comportement du tri à leurs besoins.
-      Voir <ulink url="http://userguide.icu-project.org/locale"></ulink>
-      et <ulink url="http://userguide.icu-project.org/collation/api"></ulink>
+      Voir <ulink url="https://unicode-org.github.io/icu/userguide/locale/"></ulink>
+      et <ulink url="https://unicode-org.github.io/icu/userguide/collation/api.html"></ulink>
       pour plus d'informations sur le nommage des locales ICU. L'ensemble des
       noms et attributs acceptables dépend de la version ICU précise.
      </para>
@@ -870,11 +870,7 @@ CREATE COLLATION german (provider = libc, locale = 'de_DE');
       La liste des types de collationnement possibles (sous-ensemble
       <literal>co</literal>) peut être trouvée dans le <ulink
       url="https://github.com/unicode-org/cldr/blob/master/common/bcp47/collation.xml">dépôt
-       CLDR</ulink>. Le <ulink url="https://ssl.icu-project.org/icu-
-      bin/locexp">ICU Locale Explorer</ulink> peut être utilisé pour vérifier
-      les détails de la définition d'une locale particulière. Les exemples
-      utilisant les sous-balises <literal>k*</literal> requièrent au moins la
-      version 54 d'ICU.
+       CLDR</ulink>.
      </para>
 
      <para>

diff --git a/postgresql/config.xml b/postgresql/config.xml
@@ -1739,8 +1739,11 @@ include 'nom_fichier'
     </para>
 
     <para>
-     Pour le moment, ce paramètre n'est supporté que sur Linux et Windows.
-     Il est ignoré sur les autres systèmes quand il est à <literal>try</literal>.
+     Pour le moment, ce paramètre n'est supporté que sur Linux et Windows. Il
+     est ignoré sur les autres systèmes quand il est à
+     <literal>try</literal>. Sur Linux, il est seulement supporté quand
+     <varname>shared_memory_type</varname> est configuré à
+     <literal>mmap</literal> (la valeur par défaut).
     </para>
 
     <para>
@@ -9087,7 +9090,7 @@ COPY postgres_log FROM '/chemin/complet/vers/le/logfile.csv' WITH csv;
    </listitem>
   </varlistentry>
 
-  <varlistentry id="guc-multixact-failsafe-age" xreflabel="vacuum_multixact_failsafe_age">
+  <varlistentry id="guc-vacuum-multixact-failsafe-age" xreflabel="vacuum_multixact_failsafe_age">
    <term><varname>vacuum_multixact_failsafe_age</varname> (<type>integer</type>)
    <indexterm>
     <primary>paramètre de configuration <varname>vacuum_multixact_failsafe_age</varname></primary>

diff --git a/postgresql/gist.xml b/postgresql/gist.xml
@@ -283,7 +283,7 @@ CREATE INDEX ON ma_table USING GIST (ma_colonne_inet inet_ops);
 
   <para>
    Une classe d'opérateur d'index <acronym>GiST</acronym> doit fournir cinq
-   méthodes, et cinq supplémentaires optionnelles. La précision de l'index
+   méthodes, et six supplémentaires optionnelles. La précision de l'index
    est assurée par l'implantation des méthodes <function>same</function>,
    <function>consistent</function> et <function>union</function> alors que
    l'efficacité (taille et rapidité) de l'index dépendra des méthodes
@@ -307,9 +307,9 @@ CREATE INDEX ON ma_table USING GIST (ma_colonne_inet inet_ops);
    classe d'opérateur souhaite supporter les parcours d'index seuls, sauf
    quand la méthode <function>compress</function> est omise. La dixième
    méthode, optionnelle, est <function>options</function> et est nécessaire
-   si l'opérateur de classe fournit des paramètres définis par l'utilisateur.
-   La méthode <function>sortsupport</function> est aussi optionnelle et est
-   utilisée pour accélérer la construction d'un index
+   si l'opérateur de classe a des paramètres définis par l'utilisateur.
+   La onzième méthode, <function>sortsupport</function>, est aussi optionnelle
+   et est utilisée pour accélérer la construction d'un index
    <acronym>GiST</acronym>.
   </para>
 

diff --git a/postgresql/libpq.xml b/postgresql/libpq.xml
@@ -4623,6 +4623,11 @@ char *PQresultVerboseErrorMessage(const PGresult *res,
        <xref linkend="libpq-PQgetResult"/> ne renvoie pas de pointeur NULL,
        indiquant que la commande a terminé.
       </para>
+
+      <para>
+       Dans le mode pipeline, les chaînes de commande contenant plus d'une
+       commande SQL sont interdites.
+      </para>
      </listitem>
     </varlistentry>
 
@@ -5046,8 +5051,9 @@ char *PQresultVerboseErrorMessage(const PGresult *res,
     linkend="libpq-PQenterPipelineMode"/>.
     <xref linkend="libpq-PQpipelineStatus"/> peut être utilisé pour tester si
     le mode pipeline est actif. Dans le mode pipeline, seules les <link
-    linkend="libpq-async">opérations asynchrones</link> sont autorisées, et
-    <literal>COPY</literal> est interdit. Utiliser les fonctions d'exécution
+    linkend="libpq-async">opérations asynchrones</link> sont autorisées, les
+    chaînes de commandes contenant plusieurs commandes SQL et
+    <literal>COPY</literal> sont interdits. Utiliser les fonctions d'exécution
     de commandes synchrones telles que
     <function>PQfn</function>,
     <function>PQexec</function>,

diff --git a/postgresql/monitoring.xml b/postgresql/monitoring.xml
@@ -339,15 +339,6 @@ postgres   27093  0.0  0.0  30096  2752 ?        Ss   11:34   0:00 postgres: ser
        </entry>
       </row>
 
-     <row>
-      <entry><structname>pg_stat_replication_slots</structname><indexterm><primary>pg_stat_replication_slots</primary></indexterm></entry>
-      <entry>Une ligne par slot de réplication, affichant les statistiques
-       de l'utilisation du slot de réplication.
-       Voir <link linkend="monitoring-pg-stat-replication-slots-view">
-       <structname>pg_stat_replication_slots</structname></link> pour les détails.
-      </entry>
-     </row>
-
       <row>
        <entry><structname>pg_stat_wal_receiver</structname><indexterm><primary>pg_stat_wal_receiver</primary></indexterm></entry>
        <entry>Seulement une ligne, affichant des statistiques sur le récepteur
@@ -657,6 +648,15 @@ postgres   27093  0.0  0.0  30096  2752 ?        Ss   11:34   0:00 postgres: ser
          <structname>pg_stat_slru</structname></link> pour les détails.
        </entry>
       </row>
+
+      <row>
+       <entry><structname>pg_stat_replication_slots</structname><indexterm><primary>pg_stat_replication_slots</primary></indexterm></entry>
+       <entry>Une ligne par slot de réplication, affichant les statistiques
+        de l'utilisation du slot de réplication.
+        Voir <link linkend="monitoring-pg-stat-replication-slots-view">
+        <structname>pg_stat_replication_slots</structname></link> pour les détails.
+       </entry>
+      </row>
      </tbody>
     </tgroup>
    </table>

diff --git a/postgresql/pgcrypto.xml b/postgresql/pgcrypto.xml
@@ -389,6 +389,13 @@
     </tgroup>
    </table>
 
+   <para>
+    Lorsqu'elle est compilée avec <productname>OpenSSL</productname> 3.0.0 ou
+    une version ultérieure, le fournisseur hérité doit être activé dans le
+    fichier de configuration <filename>openssl.cnf</filename> pour utiliser
+    les anciens chiffrements tels que DES or Blowfish.
+   </para>
+
    <para>
     Notes&nbsp;:
    </para>

diff --git a/postgresql/protocol.xml b/postgresql/protocol.xml
@@ -1478,6 +1478,21 @@ SELCT 1/0;<!-- l'erreur est intentionnelle -->
     nouvelle connexion et procéder sans <acronym>SSL</acronym>.
    </para>
 
+   <para>
+    Quand le chiffrement <acronym>SSL</acronym> doit être réalisé, le serveur
+    doit envoyer seulement l'octet <literal>S</literal>, puis attendre que le
+    client initie une poignée de main <acronym>SSL</acronym>. Si des octets
+    supplémentaires sont disponibles en lecture à ce moment, cela pourrait
+    signifier qu'une attaque <foreignphrase>man-in-the-middle</foreignphrase>
+    tente de réaliser une attaque
+    <foreignphrase>buffer-stuffing</foreignphrase>
+    (<ulink
+    url="https://www.postgresql.org/support/security/CVE-2021-23222/">CVE-2021-23222</ulink>).
+    Les clients doivent être codés pour soit lire exactement un octet du
+    socket avant de rendre le socket à la bibliothèque SSL, soit traiter
+    comme une violation de protocole tout octet supplémentaire.
+   </para>
+
    <para>
     Un SSLRequest initial peut également être utilisé dans une connexion en
     cours d'ouverture pour envoyer un message CancelRequest.
@@ -1537,6 +1552,21 @@ SELCT 1/0;<!-- l'erreur est intentionnelle -->
     connexion et continuer sans demander le chiffrement <acronym>GSSAPI</acronym>.
    </para>
 
+   <para>
+    Quand le chiffrement <acronym>GSSAPI</acronym> peut être réalisé, le serveur
+    doit envoyer seulement l'octet <literal>G</literal>, puis attendre que le
+    client initie une poignée de main <acronym>GSSAPI</acronym>. Si des octets
+    supplémentaires sont disponibles en lecture à ce moment, cela pourrait
+    signifier qu'une attaque <foreignphrase>man-in-the-middle</foreignphrase>
+    tente de réaliser une attaque
+    <foreignphrase>buffer-stuffing</foreignphrase>
+    (<ulink
+    url="https://www.postgresql.org/support/security/CVE-2021-23222/">CVE-2021-23222</ulink>).
+    Les clients doivent être codés pour soit lire exactement un octet du
+    socket avant de rendre le socket à la bibliothèque GSSAPI, soit traiter
+    comme une violation de protocole tout octet supplémentaire.
+   </para>
+
    <para>
     Un GSSENCRequest initial peut aussi être utilisé dans une connexion en
     train d'être ouverte pour envoyer un message CancelRequest.

diff --git a/postgresql/queries.xml b/postgresql/queries.xml
@@ -1710,13 +1710,9 @@ SELECT a "from", b + c AS sum FROM ...
 <synopsis><replaceable>requete1</replaceable> UNION <optional>ALL</optional> <replaceable>requete2</replaceable>
 <replaceable>requete1</replaceable> INTERSECT <optional>ALL</optional> <replaceable>requete2</replaceable>
 <replaceable>requete1</replaceable> EXCEPT <optional>ALL</optional> <replaceable>requete2</replaceable></synopsis>
-   <replaceable>requete1</replaceable> et
+   où <replaceable>requete1</replaceable> et
    <replaceable>requete2</replaceable> sont les requêtes pouvant utiliser
-   toutes les fonctionnalités discutées ici. Les opérations d'ensemble peuvent
-   aussi être combinées et chaînées, par exemple
-<synopsis><replaceable>requete1</replaceable> UNION <replaceable>requete2</replaceable> UNION <replaceable>requete3</replaceable></synopsis>
-   est exécuté ainsi&nbsp;:
-<synopsis>(<replaceable>requete1</replaceable> UNION <replaceable>requete2</replaceable>) UNION <replaceable>requete3</replaceable></synopsis>
+   toutes les fonctionnalités discutées ici.
   </para>
 
   <para>
@@ -1750,6 +1746,48 @@ SELECT a "from", b + c AS sum FROM ...
    colonnes correspondantes doivent avoir des types de données compatibles,
    comme décrit dans la <xref linkend="typeconv-union-case"/>.
   </para>
+
+  <para>
+   Les opérations sur les ensembles peuvent être combinées, par exemple&nbsp;:
+<synopsis>
+<replaceable>requete1</replaceable> UNION <replaceable>requete2</replaceable> EXCEPT <replaceable>requete3</replaceable>
+</synopsis>
+   qui est équivalent à&nbsp;:
+<synopsis>
+(<replaceable>requete1</replaceable> UNION <replaceable>requete2</replaceable>) EXCEPT <replaceable>requete3</replaceable>
+</synopsis>
+   Comme indiqué ici, vous pouvez utiliser les parenthèses pour contrôler
+   l'ordre d'évaluation. Sans les parenthèses, <literal>UNION</literal> et
+   <literal>EXCEPT</literal> font une association de gauche à droite, mais
+   <literal>INTERSECT</literal> a une priorité plus forte que ces deux
+   opérateurs. De ce fait&nbsp;:
+<synopsis>
+<replaceable>requete1</replaceable> UNION <replaceable>requete2</replaceable> INTERSECT <replaceable>requete3</replaceable>
+</synopsis>
+   signifie
+<synopsis>
+<replaceable>requete1</replaceable> UNION (<replaceable>requete2</replaceable> INTERSECT <replaceable>requete3</replaceable>)
+</synopsis>
+   Vous pouvez aussi entourer une <replaceable>requête</replaceable>
+   individuelle avec des parenthèses. C'est important si la
+   <replaceable>requête</replaceable> a besoin d'utiliser une des clauses
+   discutées dans les sections suivantes, telles que
+   <literal>LIMIT</literal>. Sans les parenthèses, vous obtiendrez soit une
+   erreur de syntaxe soit une interprétation de cette clausse comme
+   s'appliquant à la sortie de l'opération ensembliste plutôt que sur une de
+   ses entrées. Par exemple&nbsp;:
+<synopsis>
+SELECT a FROM b UNION SELECT x FROM y LIMIT 10
+</synopsis>
+   est acceptée, mais signifie&nbsp;:
+<synopsis>
+(SELECT a FROM b UNION SELECT x FROM y) LIMIT 10
+</synopsis>
+   et non pas&nbsp;:
+<synopsis>
+SELECT a FROM b UNION (SELECT x FROM y LIMIT 10)
+</synopsis>
+  </para>
  </sect1>
 
 

diff --git a/postgresql/ref/alter_subscription.xml b/postgresql/ref/alter_subscription.xml
@@ -1,9 +1,4 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!--
-doc/src/sgml/ref/alter_subscription.sgml
-PostgreSQL documentation
--->
-
 <refentry id="sql-altersubscription">
  <indexterm zone="sql-altersubscription">
   <primary>ALTER SUBSCRIPTION</primary>
@@ -70,8 +65,8 @@ ALTER SUBSCRIPTION <replaceable class="parameter">nom</replaceable> RENAME TO <r
   <para>
    Les commandes <command>ALTER SUBSCRIPTION ... REFRESH PUBLICATION</command>
    et <command>ALTER SUBSCRIPTION ...{SET|ADD|DROP} PUBLICATION ...</command>
-   avec l'option de rafraichissement activée ne peuvent pas être exécutées
-   dans un bloc de transaction.
+   avec l'option <literal>refresh</literal> activée ne peuvent pas être
+   exécutées dans un bloc de transaction.
   </para>
  </refsect1>
 

diff --git a/postgresql/ref/pg_amcheck.xml b/postgresql/ref/pg_amcheck.xml
@@ -442,6 +442,18 @@
    </variablelist>
   </para>
 
+  <warning>
+   <para>
+    Les vérifications supplémentaires réalisées avec les index B-tree quand
+    l'option <option>--parent-check</option> ou l'option
+    <option>--rootdescend</option> sont spécifiées nécessitent des verrous
+    relativement fort sur les relations. Ce sont les seules vérifications qui
+    bloquent les modifications concurrentes de données par les commandes
+    <command>INSERT</command>, <command>UPDATE</command> et
+    <command>DELETE</command>.
+   </para>
+  </warning>
+
   <para>
    Les options en ligne de commande suivantes contrôlent la connexion au
    serveur&nbsp;:

diff --git a/postgresql/ref/pg_receivewal.xml b/postgresql/ref/pg_receivewal.xml
@@ -79,6 +79,31 @@
    laisser au moins une session disponible pour le flux.
   </para>
 
+  <para>
+   Le point de démarrage du flux des journaux de transactions est calculé
+   quand <application>pg_receivewal</application> démarre&nbsp;:
+   <orderedlist>
+    <listitem>
+     <para>
+      Tout d'abord, il parcourt le répertoire où les segments de journaux de
+      transactions sont écrits et trouver le segment terminé le plus récent
+      pour l'utiliser comme point de départ du prochain segment. Ceci est
+      calculé indépendamment de la méthode de compression utilisée pour
+      compresser chaque segment.
+     </para>
+    </listitem>
+
+    <listitem>
+     <para>
+      Si un point de démarrage ne peut pas être calculé avec la méthode
+      précédente, l'emplacement de vidage des journaux de transactions est
+      utilisé comme indiqué par le serveur à partir d'une commande
+      <literal>IDENTIFY_SYSTEM</literal>.
+     </para>
+    </listitem>
+   </orderedlist>
+  </para>
+
   <para>
    Si la connexion est perdue ou si elle ne peux pas être établie
    initialement, via une erreur non fatale,

diff --git a/postgresql/ref/psql-ref.xml b/postgresql/ref/psql-ref.xml
@@ -2008,11 +2008,11 @@ basetest=&gt;
        <para>
         Le statut de chaque type de statistique étendue est affichée dans une
         colonne nommée d'après le type de statistique (par exemple
-        <foreignphrase>Ndistinct</foreignphrase>).
-        <foreignphrase>defined</foreignphrase> signifie qu'il a été réclamé
-        lors de la création des statistiques, et NULL signifie qu'il n'a pas
-        été réclamé. Vous pouvez utiliser pg_stats_ext si vous voulez savoir
-        si la commande <link linkend="sql-analyze">
+        <foreignphrase>Ndistinct</foreignphrase>). <literal>defined</literal>
+        signifie qu'il a été réclamé lors de la création des statistiques, et
+        NULL signifie qu'il n'a pas été réclamé. Vous pouvez utiliser
+        <structname>pg_stats_ext</structname> si vous voulez savoir si la
+        commande <link linkend="sql-analyze">
         <command>ANALYZE</command></link> a été exécutée et si les
         statistiques sont disponibles pour le planificateur.
        </para>

diff --git a/postgresql/ref/reindexdb.xml b/postgresql/ref/reindexdb.xml
@@ -207,7 +207,7 @@
      <term><option>--system</option></term>
      <listitem>
       <para>
-       Réindexe les catalogues système de la base de données.
+       Réindexe seulement les catalogues système de la base de données.
       </para>
      </listitem>
     </varlistentry>

diff --git a/postgresql/ref/select.xml b/postgresql/ref/select.xml
@@ -1558,7 +1558,8 @@ FETCH { FIRST | NEXT } [ <replaceable class="parameter">compte</replaceable> ] {
     <literal>WITH TIES</literal> est utilisée pour renvoyer toute ligne
     supplémentaire qui se lie pour la dernière place dans le jeu de résultats
     selon la clause <literal>ORDER BY</literal>&nbsp;; <literal>ORDER
-     BY</literal> est requis dans ce cas. <literal>ROW</literal> et
+     BY</literal> est requis dans ce cas, et <literal>SKIP LOCKED</literal>
+     n'est pas autorisé. <literal>ROW</literal> et
     <literal>ROWS</literal> ainsi que <literal>FIRST</literal> et
     <literal>NEXT</literal> sont des mots qui n'influencent pas les effets de
     ces clauses. D'après le standard, la clause <literal>OFFSET</literal> doit