Mise à jour en version 12.1

gleu · Nov 21, 2019 · 0699fd7 · 0699fd7
1 parent 84db684
commit 0699fd7
Show file tree

Hide file tree

Showing 22 changed files with 1,564 additions and 371 deletions.
diff --git a/postgresql/catalogs.xml b/postgresql/catalogs.xml
@@ -6666,30 +6666,6 @@ SCRAM-SHA-256$<replaceable>&lt;nombre d'itération&gt;</replaceable>:<replaceabl
    l'utilisateur courant.
   </para>
 
-  <para>
-   <structname>pg_statistic</structname> ne doit pas être lisible par le
-   public, car même les informations statistiques sur le contenu de la table
-   pourraient être considérées comme sensibles. (Par exemple, les valeurs
-   minimale et maximale de la colonne salaire pourraient être très
-   intéressantes.) <link
-   linkend="view-pg-stats"><structname>pg_stats</structname></link> est une
-   vue, lisible par tout le monde, interrogeant
-   <structname>pg_statistic</structname> en exposant uniquement les
-   informations sur les tables visibles par l'utilisateur courant.
-  </para>
-
-  <para>
-   De la même façon, <structname>pg_statistic_ext_data</structname> ne doit
-   pas être lisible par tout le monde car son contenu peut être considéré
-   comme sensible. (Par exemple, les combinaisons de valeurs les plus communes
-   des colonnes  pourraient être intéressantes.) <link
-   linkend="view-pg-stats-ext"><structname>pg_stats_ext</structname></link>
-   est une vue, lisible par tout le monde, interrogeant
-   <structname>pg_statistic_ext_data</structname> (après une jointure sur
-   <structname>pg_statistic_ext</structname>) en exposant uniquement les
-   informations sur les tables et colonnes visibles par l'utilisateur courant.
-  </para>
-
   <table>
    <title>Colonnes de <structname>pg_statistic</structname></title>
 
@@ -6843,6 +6819,19 @@ SCRAM-SHA-256$<replaceable>&lt;nombre d'itération&gt;</replaceable>:<replaceabl
    avec <xref linkend="sql-createstatistics"/>.
   </para>
 
+  <para>
+   Tout comme <structname>pg_statistic</structname>,
+   <structname>pg_statistic_ext_data</structname> ne doit
+   pas être lisible par tout le monde car son contenu peut être considéré
+   comme sensible. (Par exemple, les combinaisons de valeurs les plus communes
+   des colonnes  pourraient être intéressantes.) <link
+   linkend="view-pg-stats-ext"><structname>pg_stats_ext</structname></link>
+   est une vue, lisible par tout le monde, interrogeant
+   <structname>pg_statistic_ext_data</structname> (après une jointure sur
+   <structname>pg_statistic_ext</structname>) en exposant uniquement les
+   informations sur les tables et colonnes visibles par l'utilisateur courant.
+  </para>
+
   <table>
    <title>Colonnes de <structname>pg_statistic_ext</structname></title>
 
@@ -6916,10 +6905,11 @@ SCRAM-SHA-256$<replaceable>&lt;nombre d'itération&gt;</replaceable>:<replaceabl
   </table>
 
   <para>
-   Le champ <structfield>stxkind</structfield> est rempli à la création de
-   l'objet statistique, indiquant le (ou les) type(s) de statistiques
-   désiré(s). Les statistiques (une fois calculées par
-   <command>ANALYZE</command>) sont enregistrées dans le catalogue <link
+   Un enregistrement de <structname>pg_statistic_ext</structname> est rempli
+   complètement lors du <command>CREATE STATISTICS</command>, mais les
+   vraies valeurs statistiques ne sont pas calculées à ce moment-là.
+   Les commandes <command>ANALYZE</command> ultérieures calculent les
+   valeurs souhaitées et peuplent l'enregistrement dans <link
    linkend="catalog-pg-statistic-ext-data"><structname>pg_statistic_ext_data</structname></link>.
   </para>
  </sect1>
@@ -6958,7 +6948,7 @@ SCRAM-SHA-256$<replaceable>&lt;nombre d'itération&gt;</replaceable>:<replaceabl
       <entry><structfield>stxoid</structfield></entry>
       <entry><type>oid</type></entry>
       <entry><literal><link linkend="catalog-pg-statistic-ext"><structname>pg_statistic_ext</structname></link>.oid</literal></entry>
-      <entry>Statistique étendue contenant la définition pour cette donnée.</entry>
+      <entry>Objet statistique étendu contenant la définition pour cette donnée.</entry>
      </row>
 
      <row>

diff --git a/postgresql/config.xml b/postgresql/config.xml
diff --git a/postgresql/datatype.xml b/postgresql/datatype.xml
@@ -2250,17 +2250,17 @@ SELECT 'abc \153\154\155 \052\251\124'::bytea;
          <row>
           <entry><literal>today</literal></entry>
           <entry><type>date</type>, <type>timestamp</type></entry>
-          <entry>aujourd'hui minuit</entry>
+          <entry>aujourd'hui minuit (<literal>00:00</literal>)</entry>
          </row>
          <row>
           <entry><literal>tomorrow</literal></entry>
           <entry><type>date</type>, <type>timestamp</type></entry>
-          <entry>demain minuit</entry>
+          <entry>demain minuit (<literal>00:00</literal>)</entry>
          </row>
          <row>
           <entry><literal>yesterday</literal></entry>
           <entry><type>date</type>, <type>timestamp</type></entry>
-          <entry>hier minuit</entry>
+          <entry>hier minuit (<literal>00:00</literal>)</entry>
          </row>
          <row>
           <entry><literal>allballs</literal></entry>
@@ -4362,6 +4362,12 @@ a0ee-bc99-9c0b-4ef8-bb6d-6bb9-bd38-0a11
       linkend="xml-limits-conformance"/>.
      </para>
 
+     <para>
+      Les limites et notes de compatibilité pour le type de données
+      <type>xml</type> sont disponibles dans <xref
+      linkend="xml-limits-conformance"/>.
+     </para>
+
      <sect2>
       <title>Créer des valeurs XML</title>
       <para>

diff --git a/postgresql/ddl.xml b/postgresql/ddl.xml
@@ -4033,13 +4033,12 @@ ALTER TABLE measurement ATTACH PARTITION measurement_y2008m02
      recommandé de créer une contrainte <literal>CHECK</literal> sur la table
      à attacher décrivant la contrainte de partition désirée. De
      cette manière, le système n'aura pas besoin d'effectuer un parcours de la
-     table pour valider la contrainte de partitionnement implicite. Sans une telle
-     contrainte, la table sera parcourue pour valider la contrainte de
-     partition tout en ayant un verrou de niveau <literal>ACCESS
-     EXCLUSIVE</literal> sur la partition et un verrou de niveau
-     <literal>SHARE UPDATE EXCLUSIVE</literal> sur la table parente.
-     On pourra ensuite supprimer la contrainte après que <command>ATTACH
-     PARTITION</command> a fini, car elle n'est plus nécessaire.
+     table pour valider la contrainte de partition implicite. Sans la
+     contrainte <literal>CHECK</literal>, la table sera parcourue pour valider
+     la contrainte de partition tout en ayant un verrou de niveau
+     <literal>ACCESS EXCLUSIVE</literal> sur la table parente. Vous pouvez
+     alors supprimer la contrainte <literal>CHECK</literal> redondante après
+     que <command>ATTACH PARTITION</command> soit fini.
     </para>
 
     <para>

diff --git a/postgresql/extend.xml b/postgresql/extend.xml
@@ -873,7 +873,7 @@ SELECT pg_catalog.pg_extension_config_dump('my_config', 'WHERE NOT standard_entr
     sa base de données dynamiquement d'une version à une autre, vous pouvez
     fournir <firstterm>des scripts de mise à jour</firstterm> qui feront les
     modifications nécessaires. Les scripts de mise à jour ont un nom qui correspond au format
-    <literal><replaceable>extension</replaceable>--<replaceable>oldversion</replaceable>--<replaceable>newversion</replaceable>.sql</literal>
+    <literal><replaceable>extension</replaceable>--<replaceable>ancienne_version</replaceable>--<replaceable>nouvelle_version</replaceable>.sql</literal>
     (par exemple, <literal>foo--1.0--1.1.sql</literal> contient les commandes pour modifier
     la version <literal>1.0</literal> de l'extension <literal>foo</literal> en la version
     <literal>1.1</literal>).

diff --git a/postgresql/high-availability.xml b/postgresql/high-availability.xml
@@ -266,8 +266,9 @@ ce que les nœuds s'accordent dans un système transactionnel sérialisable.
     <listitem>
 
      <para>
-      Pour les serveurs qui ne sont pas connectés en permanence, comme les
-      ordinateurs portables ou les serveurs distants, conserver la cohérence des données
+      Pour les serveurs qui ne sont pas connectés en permanence ou qui ont des
+      liens de communication lents, comme les ordinateurs portables ou les
+      serveurs distants, conserver la cohérence des données
       entre les serveurs est un challenge. L'utilisation de la réplication asynchrone
       multi-primaires permet à chaque serveur de fonctionner indépendamment. Il
       communique alors périodiquement avec les autres serveurs pour identifier les transactions
@@ -289,10 +290,11 @@ ce que les nœuds s'accordent dans un système transactionnel sérialisable.
       transaction.
      </para>
      <para>
-      Une activité importante en écriture peut être la cause d'un
-      verrouillage excessif et conduire à un effondrement des performances. Dans
-      les faits, les performances en écriture sont souvent pis que celles d'un
-      simple serveur.
+      Une activité importante en écriture peut être la cause d'un verrouillage
+      excessif et de délai dans la validation des transactions, ce qui peut
+      conduire à un effondrement des performances. Dans les faits, les
+      performances en écriture sont souvent pis que celles d'un simple
+      serveur.
      </para>
      <para>
       Tous les serveurs acceptent les requêtes en lecture.

diff --git a/postgresql/maintenance.xml b/postgresql/maintenance.xml
@@ -390,6 +390,28 @@
     très largement plus petite que la table, donc elle peut facilement être
     mise en cache même quand la table est très grosse.
    </para>
+
+   <para>
+    Les autovacuum workers ne bloquent généralement pas d'autres commandes. Si
+    un processus tente d'acquérir un verrou qui entre en conflit avec le verrou
+    <literal>SHARE UPDATE EXCLUSIVE</literal> détenu par autovacuum, l'acquisition
+    du verrou interrompera l'autovacuum. Pour les modes de verrou en conflit,
+    voir <xref linkend="table-lock-compatibility"/>. Néanmoins, si l'autovacuum
+    est en cours d'exécution pour empêcher un bouclage des identifiants de
+    transaction (autrement dit, nom de la requête de l'autovacuum dans la vue
+    <structname>pg_stat_activity</structname> se termine avec
+    <literal>(to prevent wraparound)</literal>), l'autovacuum n'est pas
+    automatiquement interrompu.
+   </para>
+
+   <warning>
+    <para>
+     Exécuter régulièrement des commandes qui acquièrent des verrous entrant
+     en conflit avec un verrou <literal>SHARE UPDATE EXCLUSIVE</literal> (par
+     exemple ANALYZE) peut fortement empêcher les autovacuum de se terminer
+     correctement.
+    </para>
+   </warning>
   </sect2>
 
   <sect2 id="vacuum-for-wraparound">

diff --git a/postgresql/monitoring.xml b/postgresql/monitoring.xml
@@ -4330,6 +4330,13 @@ référez-vous au <xref linkend="mvcc"/>.
        <command>CLUSTER</command> trie les lignes.
      </entry>
     </row>
+    <row>
+     <entry><literal>writing new heap</literal></entry>
+     <entry>
+       <command>CLUSTER</command> est en cours d'écriture du nouveau fichier
+       de la table.
+     </entry>
+    </row>
     <row>
      <entry><literal>swapping relation files</literal></entry>
      <entry>
@@ -4919,7 +4926,7 @@ D'autres peuvent être ajoutées pour améliorer la surveillance de
   </row>
   <row>
    <entry><type>bool</type></entry>
-   <entry><type>char</type></entry>
+   <entry><type>unsigned char</type></entry>
   </row>
 
  </tbody>

diff --git a/postgresql/pageinspect.xml b/postgresql/pageinspect.xml
@@ -149,6 +149,40 @@ test=# SELECT page_checksum(get_raw_page('pg_class', 0), 0);
       nœud d'une page FSM. Par exemple&nbsp;:
 <screen>
 test=# SELECT fsm_page_contents(get_raw_page('pg_class', 'fsm', 0));
+</screen>
+      La sortie est une chaîne de texte multiligne, avec
+      une ligne par nœud dans l'arbre binaire au sein de la page.  Seuls ces
+      nœuds qui ne valent pas zéro sont affichés.  Le pointeur appelé « next »,
+      qui pointe vers le prochain slot à être retourné depuis la page, est
+      également affiché.
+     </para>
+     <para>
+      Voir <filename>src/backend/storage/freespace/README</filename> pour plus
+      d'information sur la structure d'une page FSM.
+     </para>
+    </listitem>
+   </varlistentry>
+   </variablelist>
+  </sect2>
+
+  <sect2>
+   <title>Fonctions Heap</title>
+
+   <variablelist>
+   <varlistentry>
+    <term>
+     <function>fsm_page_contents(page bytea) returns text</function>
+     <indexterm>
+      <primary>fsm_page_contents</primary>
+     </indexterm>
+    </term>
+
+    <listitem>
+     <para>
+      <function>fsm_page_contents</function> montre la structure interne du
+      nœud d'une page FSM. Par exemple&nbsp;:
+<screen>
+test=# SELECT fsm_page_contents(get_raw_page('pg_class', 'fsm', 0));
 </screen>
       La sortie est une chaîne de texte multiligne, avec
       une ligne par nœud dans l'arbre binaire au sein de la page.  Seuls ces

diff --git a/postgresql/pgtrgm.xml b/postgresql/pgtrgm.xml
@@ -347,24 +347,6 @@
       </para>
      </listitem>
     </varlistentry>
-    <varlistentry id="guc-pgtrgm-strict-word-similarity-threshold" xreflabel="pg_trgm.strict_word_similarity_threshold">
-     <term>
-      <varname>pg_trgm.strict_word_similarity_threshold</varname> (<type>real</type>)
-      <indexterm>
-       <primary>
-        paramètre de configuration <varname>pg_trgm.strict_word_similarity_threshold</varname>
-       </primary>
-      </indexterm>
-     </term>
-     <listitem>
-      <para>
-       Configure la limite stricte actuelle de similarité utilisée par les
-       opérateurs <literal>&lt;&lt;%</literal> et
-       <literal>%&gt;&gt;</literal>. La limite doit être comprise entre 0 et 1
-       (la valeur par défaut est 0,5).
-      </para>
-     </listitem>
-    </varlistentry>
   </variablelist>
  </sect2>
 

diff --git a/postgresql/postgres-fdw.xml b/postgresql/postgres-fdw.xml
@@ -510,6 +510,11 @@
     COMMITTED</literal>. Une prochaine version de
    <productname>PostgreSQL</productname> pourrait modifier ce comportement.
   </para>
+
+  <para>
+   Notez que <filename>postgres_fdw</filename> ne supporte pas actuellement de
+   préparer la transaction distante pour une validation en deux phases (2PC).
+  </para>
  </sect2>
 
  <sect2>

diff --git a/postgresql/ref/alter_table.xml b/postgresql/ref/alter_table.xml
@@ -885,19 +885,19 @@ WITH ( MODULUS <replaceable class="parameter">litéral_numérique</replaceable>,
       <literal>PRIMARY KEY</literal> de la table parent seront créées dans la
       partition si elles n'existent pas déjà. Si une seule des contraintes
       <literal>CHECK</literal> de la table étant attachée est marquée comme
-      <literal>NO INHERIT</literal>, la commande échouera; une telle
-      contrainte doit être recrée sans la clause <literal>NO
+      <literal>NO INHERIT</literal>, la commande échouera&nbsp;; de telles
+      contraintes doivent être recréées sans la clause <literal>NO
       INHERIT</literal>.
      </para>
 
      <para>
       Si la nouvelle partition est une table standard, un parcours complet de
-      la table est effectué pour vérifier qu'elle ne contient pas de lignes qui
-      violent la contrainte de partition.  Il est possible d'éviter ce parcours
+      la table est effectué pour vérifier que les lignes existantes ne
+      violent pas la contrainte de partition.  Il est possible d'éviter ce parcours
       en ajoutant une contrainte <literal>CHECK</literal> valide à la table qui
       n'autoriserait que les lignes satisfaisant la contrainte de partition
-      désirée avant de lancer cette commande.  Une telle contrainte permettra
-      de déterminer si le parcours de la table est nécessaire pour valider la
+      désirée avant de lancer cette commande.  La contrainte <literal>CHECK</literal>
+      sera utilisée pour déterminer si le parcours de la table est nécessaire pour valider la
       contrainte de partition.  Cependant, cela ne fonctionne pas si l'une des
       clés de la partition est une expression et que la partition n'accepte pas
       de valeurs <literal>NULL</literal>.  Si une partition de type liste qui
@@ -924,6 +924,13 @@ WITH ( MODULUS <replaceable class="parameter">litéral_numérique</replaceable>,
       parcours de la nouvelle partition, c'est toujours ignoré quand la
       partition par défaut est une table distante.
      </para>
+
+     <para>
+      Attacher une partition nécessite l'acquisition d'un verrou
+      <literal>SHARE UPDATE EXCLUSIVE</literal> sur la table parent, en plus
+      des verrous <literal>ACCESS EXCLUSIVE</literal> sur la table à attacher
+      et sur la partition par défaut (s'il y en a une).
+     </para>
     </listitem>
    </varlistentry>
 

diff --git a/postgresql/ref/analyze.xml b/postgresql/ref/analyze.xml
@@ -153,6 +153,16 @@ ANALYZE [ VERBOSE ] [ <replaceable class="parameter">table_et_colonnes</replacea
  <refsect1>
   <title>Notes</title>
 
+  <para>
+   Pour analyser une table, l'utilisateur doit être le propriétaire de la
+   table ou un superutilisateur. Néanmoins, les propriétaires des bases ont le
+   droit d'analyser toutes les tables situées dans leur bases, sauf les
+   catalogues partagés. (La restriction pour les catalogues partagées signifie
+   qu'un <command>ANALYZE</command> sur une base complète peut seulement être
+   réalisé par un superutilisateur.) <command>ANALYZE</command> ignorera
+   toutes les tables pour lesquelles l'utilisateur n'a pas le droit d'analyse.
+  </para>
+
   <para>
    Les tables distantes sont analysées seulement lorsqu'elles sont explicitement
    ciblées. Certains wrappers de données distantes ne supportent pas encore

diff --git a/postgresql/ref/copy.xml b/postgresql/ref/copy.xml
@@ -1058,22 +1058,22 @@ ZW      ZIMBABWE
     FROM { '<replaceable class="parameter">nomfichier</replaceable>' | STDIN }
     [ [ WITH ]
         [ BINARY ]
-	[ DELIMITER [ AS ] '<replaceable class="parameter">délimiteur</replaceable>' ]
+	[ DELIMITER [ AS ] '<replaceable class="parameter">caractère_délimiteur</replaceable>' ]
 	[ NULL [ AS ] '<replaceable class="parameter">chaîne NULL</replaceable>' ]
 	[ CSV [ HEADER ]
-	      [ QUOTE [ AS ] '<replaceable class="parameter">guillemet</replaceable>' ]
-	      [ ESCAPE [ AS ] '<replaceable class="parameter">échappement</replaceable>' ]
+	      [ QUOTE [ AS ] '<replaceable class="parameter">caractère_guillemet</replaceable>' ]
+	      [ ESCAPE [ AS ] '<replaceable class="parameter">caractère_échappement</replaceable>' ]
 	      [ FORCE NOT NULL <replaceable class="parameter">colonne</replaceable> [, ...] ] ] ]
 
 COPY { <replaceable class="parameter">nomtable</replaceable> [ ( <replaceable class="parameter">colonne</replaceable> [, ...] ) ] | ( <replaceable class="parameter">requête</replaceable> ) }
     TO { '<replaceable class="parameter">nomfichier</replaceable>' | STDOUT }
     [ [ WITH ]
         [ BINARY ]
-	[ DELIMITER [ AS ] '<replaceable class="parameter">délimiteur</replaceable>' ]
+	[ DELIMITER [ AS ] '<replaceable class="parameter">caractère_délimiteur</replaceable>' ]
 	[ NULL [ AS ] '<replaceable class="parameter">chaîne NULL</replaceable>' ]
 	[ CSV [ HEADER ]
-	      [ QUOTE [ AS ] '<replaceable class="parameter">guillemet</replaceable>' ]
-	      [ ESCAPE [ AS ] '<replaceable class="parameter">échappement</replaceable>' ]
+	      [ QUOTE [ AS ] '<replaceable class="parameter">caractère_guillemet</replaceable>' ]
+	      [ ESCAPE [ AS ] '<replaceable class="parameter">caractère_échappement</replaceable>' ]
 	      [ FORCE QUOTE <replaceable class="parameter">colonne</replaceable> [, ...] | * } ] ] ]
    </synopsis>
 

diff --git a/postgresql/ref/prepare.xml b/postgresql/ref/prepare.xml
@@ -173,7 +173,7 @@ class="parameter">instruction</replaceable>
    utilise pour une instruction préparée, utilisez <xref linkend="sql-explain"/>,
    par exemple&nbsp;:
 <programlisting>
-EXPLAIN EXECUTE <replaceable>nom_requete</replaceable>(<replaceable>valeurs_parametres</replaceable>);
+EXPLAIN EXECUTE <replaceable>nom</replaceable>(<replaceable>valeurs_parametres</replaceable>);
 </programlisting>
    Si un plan générique est utilisé, il contiendra des symboles
    <literal>$<replaceable>n</replaceable></literal>, alors qu'un plan