Mise à jour en version 11.20

postgresql/Makefile

@@ -39,11 +39,15 @@ endif
 
 XMLINCLUDE = --path .
 
-ifndef XMLLINT
+ifdef XMLLINT
+XMLLINT := $(XMLLINT) --nonet
+else
 XMLLINT = $(missing) xmllint
 endif
-
-ifndef XSLTPROC
+
+ifdef XSLTPROC
+XSLTPROC := $(XSLTPROC) --nonet
+else
 XSLTPROC = $(missing) xsltproc
 endif
 

postgresql/datatype.xml

@@ -1421,7 +1421,12 @@ SELECT b, char_length(b) FROM test2;
    <para>
     Exemple&nbsp;:
 <programlisting>
-SELECT '\xDEADBEEF';
+SET bytea_output = 'hex';
+
+SELECT '\xDEADBEEF'::bytea;
+   bytea
+------------
+ \xdeadbeef
     </programlisting>
    </para>
   </sect2>

postgresql/ddl.xml

@@ -1860,7 +1860,7 @@ postgres=> table passwd;
 postgres=> set role alice;
 SET
 postgres=> table passwd;
-ERROR:  permission denied for relation passwd
+ERROR:  permission denied for table passwd
 postgres=> select user_name,real_name,home_phone,extra_info,home_dir,shell from passwd;
  user_name | real_name |  home_phone  | extra_info | home_dir    |   shell
 -----------+-----------+--------------+------------+-------------+-----------
@@ -1870,7 +1870,7 @@ postgres=> select user_name,real_name,home_phone,extra_info,home_dir,shell fr
 (3 rows)
 
 postgres=> update passwd set user_name = 'joe';
-ERROR:  permission denied for relation passwd
+ERROR:  permission denied for table passwd
 -- Alice est autorisée à modifier son propre nom (real_name), mais pas celui des autres
 postgres=> update passwd set real_name = 'Alice Doe';
 UPDATE 1
@@ -1879,9 +1879,9 @@ UPDATE 0
 postgres=> update passwd set shell = '/bin/xx';
 ERROR:  new row violates WITH CHECK OPTION for "passwd"
 postgres=> delete from passwd;
-ERROR:  permission denied for relation passwd
+ERROR:  permission denied for table passwd
 postgres=> insert into passwd (user_name) values ('xxx');
-ERROR:  permission denied for relation passwd
+ERROR:  permission denied for table passwd
 -- Alice peut modifier son propre mot de passe; RLS empêche silencieusement la mise à jour d'autres lignes
 postgres=> update passwd set pwhash = 'abc';
 UPDATE 1

postgresql/docguide.xml

@@ -140,7 +140,8 @@
      <listitem>
       <para>
        Il s'agit d'un programme pour convertir, entre autres choses, du XML
-       vers du PDF.
+       vers du PDF. Il est uniquement nécessaire si vous voulez construire la
+       documentation au format PDF.
       </para>
      </listitem>
     </varlistentry>
@@ -157,25 +158,13 @@
    documentation, afin d'inclure ces informations ici-même.
   </para>
 
-  <para>
-   Vous pouvez vous en sortir en n'installant ni DocBook XML ni les feuilles
-   de style DocBook XSLT localement, puisque les fichiers nécessaires seront
-   téléchargé par Internet et mis en cache localement.  Cela pourrait en fait
-   être la solution préférable si les paquets de votre système d'exploitation
-   ne fournissent qu'une version ancienne de ces fichiers ou si aucun paquet
-   n'est disponible. Si vous voulez empêcher toute tentative d'accàs à
-   Internet lors de la construction de la documentation, vous devrez passer
-   l'option <option>--nonet</option> à <command>xmllint</command> et
-   <command>xsltproc</command>&nbsp;; voir ci-dessous pour un exemple.
-  </para>
-
   <sect2>
    <title>Installation sur Fedora, RHEL et dérivés</title>
 
    <para>
     Pour installer les packages requis, lancez&nbsp;:
     <programlisting>
-yum install docbook-dtds docbook-style-xsl fop libxslt
+yum install docbook-dtds docbook-style-xsl libxslt fop
     </programlisting>
    </para>
   </sect2>
@@ -186,7 +175,7 @@ yum install docbook-dtds docbook-style-xsl fop libxslt
    <para>
     Pour installer les paquets requis avec <command>pkg</command>, utiliser :
     <programlisting>
-pkg install docbook-xml docbook-xsl fop libxslt
+pkg install docbook-xml docbook-xsl libxslt fop
     </programlisting>
    </para>
 
@@ -205,7 +194,7 @@ pkg install docbook-xml docbook-xsl fop libxslt
     Un ensemble complet de paquetages d'outils de documentation est
     disponible pour <productname>Debian GNU/Linux</productname>.
     Pour l'installer, il suffit de taper&nbsp;:
-    <programlisting>apt-get install docbook-xml docbook-xsl fop libxml2-utils xsltproc
+    <programlisting>apt-get install docbook-xml docbook-xsl libxml2-utils xsltproc fop
     </programlisting>
    </para>
   </sect2>
@@ -214,22 +203,42 @@ pkg install docbook-xml docbook-xsl fop libxslt
    <title>macOS</title>
 
    <para>
-    Sur macOS, vous pouvez construire la documentation HTML et man sans
-    installation supplémentaire. Si vous voulez construire les PDF ou si vous
-    voulez installer une copie locale de DocBook, vous pouvez les obtenir de
-    votre gestionnaire de paquets préféré.
+    Si vous utilisez MacPorts, les commandes suivantes vous aideront à la
+    configuration du système&nbsp;:
+<programlisting>
+sudo port install docbook-xml docbook-xsl-nons libxslt fop
+</programlisting>
+    Si vous utilisez Homebrew, utilisez plutôt ceci&nbsp;:
+<programlisting>
+brew install docbook docbook-xsl libxslt fop
+</programlisting>
    </para>
 
    <para>
-    Si vous utilisez MacPorts, voici comment configurer cela&nbsp;:
-    <programlisting>
-sudo port install docbook-xml-4.2 docbook-xsl fop
-    </programlisting>
-    Si vous utilisez Homebrew, utilisez ceci&nbsp;:
-    <programlisting>
-brew install docbook docbook-xsl fop
+    Le programme fourni par Homebrew requiert la configuration de la variable
+    d'environnement suivante&nbsp;:
+<programlisting>
+export XML_CATALOG_FILES=/usr/local/etc/xml/catalog
+</programlisting>
+    Sur les machines Apple Silicon, utilisez ceci&nbsp;:
+<programlisting>
+export XML_CATALOG_FILES=/opt/homebrew/etc/xml/catalog
+</programlisting>
+    Sans cela, <command>xsltproc</command> renverra ce genre d'erreurs&nbsp;:
+<programlisting>
+I/O error : Attempt to load network entity http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd
+postgres.sgml:21: warning: failed to load external entity "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"
+...
     </programlisting>
    </para>
+
+   <para>
+    Alors qu'il est possible d'utiliser les versions fournies par Apple de
+    <command>xmllint</command> et <command>xsltproc</command> à la place de
+    celles fournies par MacPorts ou Homebrew, vous aurez toujours besoin
+    d'installer les DTD et feuilles de style DocBook, et de configurer un
+    fichier catalogue qui poine vers eux.
+   </para>
   </sect2>
 
   <sect2>
@@ -368,12 +377,6 @@ checking for dbtoepub... dbtoepub</computeroutput></screen>
    trouver ces programmes, par exemple
 <screen>
 ./configure ... XMLLINT=/opt/local/bin/xmllint ...
-</screen>
-   De plus, si vous voulez vous assurer que <filename>xmllint</filename> et
-   <filename>xsltproc</filename> ne réaliseront aucun accès réseau, vous
-   pouvez le faire ainsi
-<screen>
-./configure ... XMLLINT="xmllint --nonet" XSLTPROC="xsltproc --nonet" ...
 </screen>
   </para>
   </sect2>

postgresql/libpq.xml

@@ -7751,7 +7751,9 @@ ldap://ldap.mycompany.com/dc=mycompany,dc=com?description?one?(cn=mydatabase)
     <literal>libssl</literal> et/ou <literal>libcrypto</literal> ont été
     initialisées par votre application, de façon à ce que
     <application>libpq</application> n'initialise pas elle aussi ces
-    bibliothèques.
+    bibliothèques. Néanmoins, ceci n'est pas nécessaire lors de l'utilisation
+    d'<productname>OpenSSL</productname> version 1.1.0 ou supérieure, car les
+    initialisations dupliquées ne sont plus problématiques.
    </para>
 
    <para>

postgresql/monitoring.xml

@@ -3349,6 +3349,30 @@ SELECT pid, wait_event_type, wait_event FROM pg_stat_activity WHERE wait_event i
         Supprime l'image statistique courante.
        </entry>
       </row>
+
+      <row>
+       <entry><literal><function>pg_stat_get_xact_blocks_fetched</function>(oid)</literal><indexterm><primary>pg_stat_get_xact_blocks_fetched</primary></indexterm></entry>
+       <entry><type>bigint</type></entry>
+       <entry>
+        Renvoie le nombre de demandes de lecture de bloc pour la table ou
+        l'index dans la transaction en cours. Ce nombre soustrait à
+        <function>pg_stat_get_xact_blocks_hit</function> donne le nombre
+        d'appels à la fonction noyau <function>read()</function>&nbsp;; le
+        nombre de lectures physiques réelles est généralement plus basse grâce
+        au cache au niveau noyau.
+       </entry>
+      </row>
+
+      <row>
+       <entry><literal><function>pg_stat_get_xact_blocks_hit</function>(oid)</literal><indexterm><primary>pg_stat_get_xact_blocks_hit</primary></indexterm></entry>
+       <entry><type>bigint</type></entry>
+       <entry>
+        Renvoie le nombre de demandes de lecture de bloc pour la table ou
+        l'index dans la transaction en cours, trouvé dans le cache (donc
+        ne déclenchant pas les appels à la fonction noyau
+        <function>read()</function>).
+       </entry>
+      </row>
 
       <row>
        <entry><literal><function>pg_stat_reset()</function></literal><indexterm><primary>pg_stat_reset</primary></indexterm></entry>

postgresql/plperl.xml

@@ -394,7 +394,7 @@ SELECT * FROM perl_set();</programlisting>
    <variablelist>
     <varlistentry>
      <term>
-      <literal><function>spi_exec_query</function>(<replaceable>query</replaceable> [, <replaceable>max-rows</replaceable>])</literal>
+      <literal><function>spi_exec_query</function>(<replaceable>query</replaceable> [, <replaceable>limit</replaceable>])</literal>
       <indexterm>
        <primary>spi_exec_query</primary>
        <secondary>en PL/Perl</secondary>
@@ -404,9 +404,18 @@ SELECT * FROM perl_set();</programlisting>
       <para>
        <literal>spi_exec_query</literal> exécute une commande SQL et renvoie
        l'ensemble complet de la ligne comme une référence à un table de
-       références hachées. <emphasis>Vous ne devez utiliser cette commande
-        que lorsque vous savez que l'ensemble de résultat sera relativement
-        petit.</emphasis>  Voici un exemple d'une requête (commande
+       références hachées. Si <replaceable>limit</replaceable> est indiqué et
+       est supérieur à zéro, alors <function>spi_exec_query</function> récupère
+       au plus <replaceable>limit</replaceable> lignes, tout comme si la requête
+       avait une clause <literal>LIMIT</literal>. Omettre
+       <replaceable>limit</replaceable> ou indiquer 0 fait disparaître la limite
+       de lignes.
+      </para>
+
+      <para>
+       <emphasis>Vous ne devez utiliser cette commande
+       que lorsque vous savez que l'ensemble de résultat sera relativement
+       petit.</emphasis> Voici un exemple d'une requête (commande
        <command>SELECT</command>) avec le nombre optionnel maximum de
        lignes&nbsp;:
        <programlisting>$rv = spi_exec_query('SELECT * FROM ma_table', 5);</programlisting>
@@ -581,13 +590,15 @@ $plan = spi_prepare('SELECT * FROM test WHERE id &gt; $1 AND name = $2', 'INTEGE
        <literal>spi_prepare</literal>, le plan peut être utilisé à la place de la
        requête, soit dans <literal>spi_exec_prepared</literal>, où le résultat est
        identique à celui renvoyé par <literal>spi_exec_query</literal>, soit dans
-       <literal>spi_query_prepared</literal> qui renvoi un curseur exactement comme
+       <literal>spi_query_prepared</literal> qui renvoit un curseur exactement comme
        le fait <literal>spi_query</literal>, qui peut ensuite être passé à
        <literal>spi_fetchrow</literal>. Le deuxième paramètre, optionnel, de
        <literal>spi_exec_prepared</literal> est une référence hachée des
        attributs&nbsp;; le seul attribut actuellement supporté est
        <literal>limit</literal>, qui configure le nombre maximum de lignes renvoyées
        par une requête.
+       Omettre <literal>limit</literal> ou le configurer à zéro fait qu'il n'y
+       a pas de limite de lignes.
       </para>
 
       <para>

postgresql/plpython.xml

@@ -944,14 +944,23 @@ $$ LANGUAGE plpythonu;
 
    <variablelist>
     <varlistentry>
-     <term><literal>plpy.<function>execute</function>(<replaceable>query</replaceable> [, <replaceable>max-rows</replaceable>])</literal></term>
+     <term><literal>plpy.<function>execute</function>(<replaceable>query</replaceable> [, <replaceable>limit</replaceable>])</literal></term>
      <listitem>
       <para>
        L'appel à <function>plpy.execute</function> avec une chaîne pour la requête
        et une limite de ligne optionnelle permet d'exécuter la requête et de
        retourner le résultat dans un objet résultant.
       </para>
 
+      <para>
+       Si <replaceable>limit</replaceable> est indiqué et supérieur à zéro,
+       alors <function>plpy.execute</function> récupère au plus
+       <replaceable>limit</replaceable> lignes, tout comme si la requête
+       incluait une clause <literal>LIMIT</literal>. Omettre
+       <replaceable>limit</replaceable> ou le configurer à zéro fait qu'il n'y a
+       pas de limite de lignes.
+      </para>
+
       <para>
        L'objet résultant émule une liste ou un objet dictionnaire. L'objet
        résultant peut être accédé par le numéro de ligne et le nom de colonne.
@@ -1046,7 +1055,7 @@ $$ LANGUAGE plpythonu;
 
     <varlistentry>
      <term><literal>plpy.<function>prepare</function>(<replaceable>query</replaceable> [, <replaceable>argtypes</replaceable>])</literal></term>
-     <term><literal>plpy.<function>execute</function>(<replaceable>plan</replaceable> [, <replaceable>arguments</replaceable> [, <replaceable>max-rows</replaceable>]])</literal></term>
+     <term><literal>plpy.<function>execute</function>(<replaceable>plan</replaceable> [, <replaceable>arguments</replaceable> [, <replaceable>limit</replaceable>]])</literal></term>
      <listitem>
       <para>
        <indexterm><primary>Préparer une requête</primary><secondary>en PL/Python</secondary></indexterm>

postgresql/pltcl.xml

@@ -352,10 +352,11 @@ $$ LANGUAGE pltcl;
       </para>
       <para>
        La valeur optionnelle <literal>-count</literal> indique à
-       <function>spi_exec</function> le nombre maximum de lignes à travailler
-       dans la commande. L'effet de ceci est comparable à l'initialisation
-       d'une requête en tant que curseur et de dire <literal>FETCH
-        <replaceable>n</replaceable></literal>.
+       <function>spi_exec</function> d'arrêter une fois que
+       <replaceable>n</replaceable> lignes ont été récupérées, tout comme si la
+       requête incluait une clause <literal>LIMIT</literal>. Si
+       <replaceable>n</replaceable> vaut zéro, la requête est exécutée jusqu'à
+       sa fin, tout comme si <literal>-count</literal> était omis.
       </para>
       <para>
        Si la commande est une instruction <command>SELECT</command>, les

postgresql/ref/pg_dump.xml

@@ -827,17 +827,6 @@
        définition différente du collationnement utilisé pour tier la colonne
        de partitionnement.
       </para>
-
-      <para>
-       Il est préférable de ne pas utiliser le parallélisme lors de la
-       restauration d'une archive construite avec cette option parce que
-       <application>pg_restore</application> ne saura pas exactement quel
-       partition sera utilisée par un élément donné de l'archive. Ceci
-       pourrait résulter en une inefficacité due à des conflits de verrou
-       entre des jobs parallèles, voire même des échecs de rechargement dûs à
-       des contraintes de clés étrangères configurées avant que les données
-       adéquates ne soient chargées.
-      </para>
      </listitem>
     </varlistentry>
 

postgresql/ref/pg_dumpall.xml

@@ -351,10 +351,6 @@
        définition différente du collationnement utilisé pour tier la colonne
        de partitionnement.
       </para>
-
-      <!-- Currently, we don't need pg_dump's warning about parallelism here,
-       since parallel restore from a pg_dumpall script is impossible.
-      -->
      </listitem>
     </varlistentry>