Mise à jour en version 9.6.9

gleu · May 10, 2018 · ae0fed3 · ae0fed3
1 parent e13ed9c
commit ae0fed3
Show file tree

Hide file tree

Showing 20 changed files with 1,969 additions and 51 deletions.
diff --git a/postgresql/backup.xml b/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>.)

diff --git a/postgresql/config.xml b/postgresql/config.xml
@@ -3193,7 +3193,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>). Les autres
      serveurs standards apparaissant plus tard dans cette liste
      sont des serveurs standbys synchrones potentiels. Si un des serveurs
@@ -3413,7 +3413,7 @@ block : bloc vidé,  dirty bloc : bloc à vider ?
      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,

diff --git a/postgresql/datatype.xml b/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>
 
@@ -3179,19 +3179,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">

diff --git a/postgresql/extend.xml b/postgresql/extend.xml
@@ -930,13 +930,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)

diff --git a/postgresql/external-projects.xml b/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>

diff --git a/postgresql/func.xml b/postgresql/func.xml
@@ -10467,6 +10467,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>
 
@@ -12631,7 +12650,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>

diff --git a/postgresql/high-availability.xml b/postgresql/high-availability.xml
@@ -918,7 +918,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_xlog_location</function> et
      <literal>sent_location</literal> peuvent indiquer que le serveur maître est en surcharge,
      tandis que des différences entre <literal>sent_location</literal> et

diff --git a/postgresql/ltree.xml b/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>

diff --git a/postgresql/pgtrgm.xml b/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>

diff --git a/postgresql/plpgsql.xml b/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>
 

diff --git a/postgresql/ref/create_policy.xml b/postgresql/ref/create_policy.xml
@@ -471,8 +471,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
@@ -489,8 +488,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>
@@ -500,8 +498,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>

diff --git a/postgresql/ref/create_trigger.xml b/postgresql/ref/create_trigger.xml
@@ -426,6 +426,19 @@ UPDATE OF <replaceable>nom_colonne_1</replaceable> [, <replaceable>nom_colonne_2
    le trigger a besoin d'être déclencher pour quelques lignes.
   </para>
 
+  <para>
+   Les triggers de niveau instruction sur une vue sont déclenchés uniquement
+   si l'action sur la vue est géré par un trigger niveau ligne
+   <literal>INSTEAD OF</literal>. Si l'action est gérée par une règle
+   <literal>INSTEAD</literal>, alors toute instruction émise par la règle est
+   exécutée à la place de l'instruction originale nommant la vue, pour que les
+   triggers qui seront déclenchés soient ceux des tables nommées dans les
+   instructions de remplacement. De façon similaire, si la vue est en mise à
+   jour automatique, alors l'action est gérée en réécrivant automatiquement
+   l'instruction en une action sur la table de base de la vue pour que les
+   triggers niveau instruction de la table de base soient déclenchés.
+  </para>
+
   <para>
    Dans les versions de <productname>PostgreSQL</productname> antérieures à la
    7.3, il était nécessaire de déclarer un type <type>opaque</type> de

diff --git a/postgresql/release-9.1.xml b/postgresql/release-9.1.xml
@@ -9666,7 +9666,7 @@ Branch: REL9_0_STABLE [9d6af7367] 2015-08-15 11:02:34 -0400
       <listitem>
        <para>
         Add system view <link
-        linkend="monitoring-stats-views-table"><structname>pg_stat_replication</structname></link>
+        linkend="pg-stat-replication-view"><structname>pg_stat_replication</structname></link>
         which displays activity of <acronym>WAL</acronym> sender processes (Itagaki
         Takahiro, Simon Riggs)
        </para>