Mise à jour en version 11.1

gleu · Nov 9, 2018 · c30d631 · c30d631
1 parent 0c9e94e
commit c30d631
Show file tree

Hide file tree

Showing 21 changed files with 4,303 additions and 91 deletions.
diff --git a/postgresql/bloom.xml b/postgresql/bloom.xml
@@ -269,6 +269,20 @@ DEFAULT FOR TYPE text USING bloom AS
 	   des valeurs <literal>NULL</literal>.
      </para>
     </listitem>
+
+    <listitem>
+     <para>
+       La méthode d'accès <literal>bloom</literal> n'accepte pas les index
+       <literal>UNIQUE</literal>.
+     </para>
+    </listitem>
+
+    <listitem>
+     <para>
+       La méthode d'accès <literal>bloom</literal> ne supporte pas la
+       recherche des valeurs <literal>NULL</literal>.
+     </para>
+    </listitem>
    </itemizedlist>
   </para>
  </sect2>

diff --git a/postgresql/catalogs.xml b/postgresql/catalogs.xml
@@ -2034,7 +2034,7 @@ SCRAM-SHA-256$<replaceable>&lt;nombre d'itération&gt;</replaceable>:<replaceabl
       <entry><structfield>relispartition</structfield></entry>
       <entry><type>bool</type></entry>
       <entry></entry>
-      <entry>True si la table est une partition</entry>
+      <entry>True si la table ou l'index est une partition</entry>
      </row>
 
      <row>

diff --git a/postgresql/charset.xml b/postgresql/charset.xml
@@ -1550,6 +1550,13 @@ by pg_wchar_table.mblen function for each encoding.
          <literal>UTF8</literal>
          </entry>
         </row>
+        <row>
+         <entry><literal>EUC_JIS_2004</literal></entry>
+         <entry><emphasis>EUC_JIS_2004</emphasis>,
+         <literal>SHIFT_JIS_2004</literal>,
+         <literal>UTF8</literal>
+         </entry>
+        </row>
         <row>
          <entry><literal>EUC_KR</literal></entry>
          <entry><emphasis>EUC_KR</emphasis>,
@@ -1716,6 +1723,11 @@ by pg_wchar_table.mblen function for each encoding.
          <entry><emphasis>encodage serveur non supporté</emphasis>
          </entry>
         </row>
+        <row>
+         <entry><literal>SHIFT_JIS_2004</literal></entry>
+         <entry><emphasis>non supporté comme encodage serveur</emphasis>
+         </entry>
+        </row>
         <row>
          <entry><literal>SQL_ASCII</literal></entry>
          <entry><emphasis>tous (aucune conversion n'est réalisée)</emphasis>

diff --git a/postgresql/config.xml b/postgresql/config.xml
@@ -4340,7 +4340,8 @@ ANY <replaceable class="parameter">nb_sync</replaceable> ( <replaceable class="p
      de considérer à la fois les tampons partagés de
      <productname>PostgreSQL</productname> et la portion de cache disque
      du noyau utilisée pour les fichiers de données de
-     <productname>PostgreSQL</productname>. Il faut également tenir
+     <productname>PostgreSQL</productname>, bien que certaines données pourraient
+     être présentes aux deux endroits. Il faut également tenir
      compte du nombre attendu de requêtes concurrentes sur des tables
      différentes car elles partagent l'espace disponible. Ce paramètre n'a
      pas d'inluence sur la taille de la mémoire partagée allouée par

diff --git a/postgresql/func.xml b/postgresql/func.xml
@@ -15622,8 +15622,9 @@ WHERE EXISTS(SELECT 1 FROM tab2 WHERE col2 = tab1.col2);</screen>
    renvoie true pour une ligne quelconque de la sous-requête.
    Le résultat est <quote>false</quote> si la comparaison renvoie false pour
    chaque ligne de la sous-requête (ce qui inclut le cas spécial de la sous-requête
-   ne retournant aucune ligne). Le résultat est NULL si la comparaison ne renvoie
-   true pour aucune ligne, et renvoie NULL pour au moins une ligne.
+   ne retournant aucune ligne). Le résultat est NULL si aucune comparaison
+   avec une ligne de la sous-requête ne renvoie true et qu'au moins une
+   comparaison renvoie NULL.
   </para>
 
   <para>
@@ -15646,8 +15647,9 @@ WHERE EXISTS(SELECT 1 FROM tab2 WHERE col2 = tab1.col2);</screen>
    Le résultat de <token>ALL</token> est vrai (<quote>true</quote>) si toutes les
    lignes renvoient true (ce qui inclut le cas spécial de la sous-requête ne
    retournant aucune ligne). Le résultat est faux (<quote>false</quote>) si un résultat
-   faux est découvert. Le résultat est NULL si la comparaison ne renvoie
-   false pour aucune ligne, mais NULL pour au moins une ligne.
+   faux est découvert. Le résultat est NULL si aucune comparaison
+   avec une ligne de la sous-requête ne renvoie false et qu'au moins une
+   comparaison renvoie NULL.
   </para>
 
   <para>
@@ -15673,9 +15675,9 @@ WHERE EXISTS(SELECT 1 FROM tab2 WHERE col2 = tab1.col2);</screen>
    renvoie true pour toutes les lignes de la sous-requête (ce qui inclut le cas
    spécial de la sous-requête ne retournant aucune ligne).
    Le résultat est <quote>false</quote> si la comparaison renvoie false pour
-   une ligne quelconque de la sous-requête.
-   Le résultat est NULL si la comparaison ne renvoie false pour aucune ligne
-   de la sous-requête, mais NULL pour au moins une ligne.
+   une ligne quelconque de la sous-requête. Le résultat est NULL si aucune
+   comparaison avec une ligne de la sous-requête ne renvoie false et qu'au
+   moins une comparaison renvoie NULL.
   </para>
 
   <para>

diff --git a/postgresql/indexam.xml b/postgresql/indexam.xml
@@ -725,7 +725,9 @@ amendscan (IndexScanDesc scan);
    </programlisting>
    Terminer un parcours et libérer les ressources. La structure <literal>scan</literal>
    elle-même ne doit pas être libérée, mais tout verrou posé en interne par
-   la méthode d'accès doit être libéré.
+   la méthode d'accès doit être libéré, ainsi qu'à tout autre mémoire allouée
+   par <function>ambeginscan</function> et les autres fonctions relatives aux
+   parcours.
   </para>
 
   <para>

diff --git a/postgresql/installation.xml b/postgresql/installation.xml
@@ -2695,6 +2695,60 @@ make MAX_CONNECTIONS=5 check
    </para>
   </sect2>
 
+  <sect2 id="installation-notes-macos">
+   <title>macOS</title>
+
+   <indexterm zone="installation-notes-macos">
+    <primary>macOS</primary>
+    <secondary>installation sur</secondary>
+   </indexterm>
+
+   <para>
+    Sur les versions récentes de <productname>macOS</productname>, il est
+    nécessaire d'embarquer le chemin <quote>sysroot</quote> dans les options
+    d'inclusion utilisées pour trouver les fichiers d'en-tête systèmes. Ceci a
+    pour résultat la génération d'un script
+    <application>configure</application> variant suivant la version du SDK
+    utilisée durant <application>configure</application>. Ceci ne devrait pas
+    poser de problèmes dans les scénarios simples mais si vous essayez de
+    faire quelque chose comme la construction d'une extension sur une machine
+    différente que celle sur laquelle le code serveur a été construit, vous
+    pourriez avoir besoin de forcer l'utilisation d'un chemin sysroot
+    différent. Pour cela, configurez <varname>PG_SYSROOT</varname> ainsi par
+    exemple
+<programlisting>
+make PG_SYSROOT=<replaceable>/desired/path</replaceable> all
+</programlisting>
+    Pour trouver le chemin approprié sur votre machine, lancez
+<programlisting>
+xcodebuild -version -sdk macosx Path
+</programlisting>
+    Notez que construire une extension en utilisant une version sysroot
+    différente que celle utilisée pour construire le serveur n'est pas
+    vraiment recommandée&nbsp;; dans le pire des cas, cela impliquerait des
+    incohérences sur l'ABI difficiles à débugger.
+   </para>
+
+   <para>
+    Vous pouvez aussi sélectionner un chemin sysroot différent de celui par
+    défaut lors du configure en indiquant <varname>PG_SYSROOT</varname> à
+    <application>configure</application>&nbsp;:
+<programlisting>
+./configure ... PG_SYSROOT=<replaceable>/desired/path</replaceable>
+</programlisting>
+   </para>
+
+   <para>
+    La fonctionnalité <quote>System Integrity Protection</quote> (SIP) de
+    <productname>macOS</productname> casse <literal>make check</literal> parce
+    qu'elle empêche de passer la configuration nécessaire de
+    <literal>DYLD_LIBRARY_PATH</literal> vers les exécutables en cours de
+    tests. Vous pouvez contourner cela en exécutant <literal>make
+    install</literal> avant <literal>make check</literal>. Ceci étant dit, la
+    plupart des développeurs Postgres désactivent SIP.
+   </para>
+  </sect2>
+
   <sect2 id="installation-notes-mingw">
    <title>MinGW/Windows Natif</title>
 

diff --git a/postgresql/libpq.xml b/postgresql/libpq.xml
@@ -4954,7 +4954,7 @@ char *PQresultVerboseErrorMessage(const PGresult *res,
  <para>
   <function>PQnotifies</function> ne lit pas réellement les données à partir du
   serveur&nbsp;; il renvoie simplement les messages précédemment absorbés par une
-  autre fonction de <application>libpq</application>. Dans les précédentes
+  autre fonction de <application>libpq</application>. Dans les anciennes
   versions de <application>libpq</application>, la seule façon de s'assurer une
   réception à temps des messages <command>NOTIFY</command> consistait à soumettre
   constamment des commandes de soumission, même vides, puis de vérifier
@@ -8300,6 +8300,7 @@ main(int argc, char **argv)
                     notify->relname, notify->be_pid);
             PQfreemem(notify);
             nnotifies++;
+            PQconsumeInput(conn);
         }
     }
 

diff --git a/postgresql/monitoring.xml b/postgresql/monitoring.xml
@@ -1270,14 +1270,14 @@ postgres   27093  0.0  0.0  30096  2752 ?        Ss   11:34   0:00 postgres: ser
          checkpointer.</entry>
         </row>
         <row>
-         <entry><literal>LogicalLauncherMain</literal></entry>
+         <entry><literal>LogicalApplyMain</literal></entry>
          <entry>Attente dans la boucle principale du processus logical
-         launcher.</entry>
+         apply.</entry>
         </row>
         <row>
-         <entry><literal>LogicalApplyMain</literal></entry>
+         <entry><literal>LogicalLauncherMain</literal></entry>
          <entry>Attente dans la boucle principale du processus logical
-         apply.</entry>
+         launcher.</entry>
         </row>
         <row>
          <entry><literal>PgStatMain</literal></entry>
@@ -1365,6 +1365,10 @@ postgres   27093  0.0  0.0  30096  2752 ?        Ss   11:34   0:00 postgres: ser
          <entry>Attente de la disponibilité du numéro de bloc nécessaire pour
          continuer un parcours parallélisé d'un index B-tree.</entry>
         </row>
+        <row>
+         <entry><literal>ClogGroupUpdate</literal></entry>
+         <entry>Waiting for group leader to update transaction status at transaction end.</entry>
+        </row>
         <row>
          <entry><literal>ExecuteGather</literal></entry>
          <entry>Attente d'activité d'un processus fils lors de l'exécution
@@ -1482,11 +1486,6 @@ postgres   27093  0.0  0.0  30096  2752 ?        Ss   11:34   0:00 postgres: ser
          <entry>Attente de l'envoi d'octets provenant d'une queue de messages
          partagé.</entry>
         </row>
-        <row>
-         <entry><literal>ParallelFinish</literal></entry>
-         <entry>Attente la fin du traitement de processus workers
-         parallélisés.</entry>
-        </row>
         <row>
          <entry><literal>ParallelBitmapScan</literal></entry>
          <entry>Attente de l'initialisation d'un parcours bitmap
@@ -1496,15 +1495,16 @@ postgres   27093  0.0  0.0  30096  2752 ?        Ss   11:34   0:00 postgres: ser
          <entry><literal>ParallelCreateIndexScan</literal></entry>
          <entry>Waiting for parallel <command>CREATE INDEX</command> workers to finish heap scan.</entry>
         </row>
+        <row>
+         <entry><literal>ParallelFinish</literal></entry>
+         <entry>Attente la fin du traitement de processus workers
+         parallélisés.</entry>
+        </row>
         <row>
          <entry><literal>ProcArrayGroupUpdate</literal></entry>
          <entry>Attente de l'effacement de l'identifiant de transactions en
          fin de transaction par le leader du groupe.</entry>
         </row>
-        <row>
-         <entry><literal>ClogGroupUpdate</literal></entry>
-         <entry>Waiting for group leader to update transaction status at transaction end.</entry>
-        </row>
         <row>
          <entry><literal>ReplicationOriginDrop</literal></entry>
          <entry>Attente du placement en inactivité de l'origine de réplication

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

diff --git a/postgresql/plpgsql.xml b/postgresql/plpgsql.xml
@@ -1883,16 +1883,30 @@ SELECT * FROM obtient_idvol_disponibles(CURRENT_DATE);
 
     <para>
      Une procédure n'a pas de valeur de retour. De ce fait, une procédure peut
-     se terminer sans instruction <command>RETURN</command>. Si une
-     instruction <command>RETURN</command> doit quitter le code en avance,
-     alors la valeur <symbol>NULL</symbol> doit être renvoyée. Renvoyer tout
-     autre valeur résultera en une erreur.
+     se terminer sans instruction <command>RETURN</command>. Si vous souhaitez
+     utiliser l'instruction <command>RETURN</command> pour quitter le code en
+     avance, écrivez juste <command>RETURN</command> sans expression.
     </para>
 
     <para>
-     Si une procédure a des paramètres en sortie, alors les valeurs en sortie
-     peuvent être affectées aux paramètres comme s'il s'agissait de variables.
-     Par exemple&nbsp;:
+     Si une procédure a des paramètres en sortie, les valeurs finales des paramètres
+     en sortie seront renvoyées à l'appelant.
+    </para>
+   </sect2>
+
+   <sect2 id="plpgsql-statements-calling-procedure">
+    <title>Appeler une procédure</title>
+
+    <para>
+     Une fonction, une procédure et un bloc <command>DO</command> en
+     <application>PL/pgSQL</application> peut appeler une procédure en
+     appelant <command>CALL</command>. Les paramètres en sortie sont gérées
+     différemment de la façon dont <command>CALL</command> fonctionne en SQL.
+     Chaque paramètre <literal>INOUT</literal> de la procédure doit
+     correspondre à une variable dans l'instruction <command>CALL</command> et
+     le retour de la procédure est affecté à cette variable au retour. Par
+     exemple&nbsp;:
+
 <programlisting>
 CREATE PROCEDURE triple(INOUT x int)
 LANGUAGE plpgsql
@@ -1902,7 +1916,13 @@ BEGIN
 END;
 $$;
 
-CALL triple(5);
+DO $$
+DECLARE myvar int := 5;
+BEGIN
+  CALL triple(myvar);
+  RAISE NOTICE 'myvar = %', myvar;  -- prints 15
+END
+$$;
 </programlisting>
     </para>
    </sect2>

diff --git a/postgresql/ref/call.xml b/postgresql/ref/call.xml
@@ -35,7 +35,7 @@ CALL <replaceable class="parameter">nom</replaceable> ( [ <replaceable class="pa
 
   <para>
    Si la procédure a des arguments en sortie, alors une ligne de résultat sera
-   retournée.
+   retournée, contenant les valeurs de ces paramètres.
   </para>
  </refsect1>
 
@@ -56,7 +56,7 @@ CALL <replaceable class="parameter">nom</replaceable> ( [ <replaceable class="pa
     <term><replaceable class="parameter">argument</replaceable></term>
     <listitem>
      <para>
-      Un argument pour l'appel de la procédure.
+      Un argument en entrée pour l'appel de la procédure.
       Voir <xref linkend="sql-syntax-calling-funcs"/> pour la totalité des
       détails sur la syntaxe d'appel des fonctions et procédures, incluant
       l'utilisation de paramètres nommés.
@@ -85,6 +85,12 @@ CALL <replaceable class="parameter">nom</replaceable> ( [ <replaceable class="pa
    Les ordres de contrôle de transaction ne sont autorisés que si
    <command>CALL</command> est exécuté dans sa propre transaction.
   </para>
+
+  <para>
+   <application>PL/pgSQL</application> gère différemment des paramètres en
+   sortie dans les commandes  <command>CALL</command>&nbsp;; voir <xref
+   linkend="plpgsql-statements-calling-procedure"/>.
+  </para>
  </refsect1>
 
  <refsect1>

diff --git a/postgresql/ref/create_index.xml b/postgresql/ref/create_index.xml
@@ -367,45 +367,9 @@
    <para>
     La clause <literal>WITH</literal> optionnelle spécifie des
     <firstterm>paramètres de stockage</firstterm> pour l'index. Chaque méthode
-    d'indexage peut avoir son propre ensemble de paramètres de stockage. Tous
-    les index acceptent le paramètre suivant&nbsp;:
-   </para>
-
-   <variablelist>
-    <varlistentry>
-     <term><literal>recheck_on_update</literal></term>
-     <listitem>
-      <para>
-       Indique s'il faut vérifier de nouveau la valeur d'un index fonctionnel
-       pour savoir si nous pouvons utiliser une mise à jour HOT. La valeur par
-       défaut est ON pour les index fonctionnels avec un coût total de
-       l'expression inférieur à 1000 et à OFF pour les autres. Vous pouvez
-       décider de le désactiver (OFF) si vous savez qu'une fonction utilisée
-       dans un index a peu de chance de renvoyer la même valeur si une des
-       colonnes en entrée est mise à jour et donc que la vérification serait
-       coûteuse sans raison.
-      </para>
-
-      <para>
-       Les index fonctionnels sont fréquemment utilisés dans le cas où la
-       fonction renvoie un sous-ensemble de l'argument. Des exemples seraient
-       d'accéder une partie d'une chaîne avec <literal>SUBSTR()</literal> ou
-       d'accéder à un seul champ dans un document JSON en utilisant une
-       expression telle que <literal>(bookinfo-&gt;&gt;'isbn')</literal>. Dans
-       cet exemple, le document JSON pourrait être fréquemment mis à jour,
-       alors qu'il est peu fréquent que le champ ISBN d'un livre soit modifié,
-       donc nous voudrions conserver la valeur ON pour ce paramètre avec cet
-       index. Un champ changeant plus fréquemment pourrait avoir un index avec
-       ce paramètre passé à OFF alors que des champs très fréquemment modifiés
-       feraient mieux d'éviter de réindexer tout sous une forte charge.
-      </para>
-     </listitem>
-    </varlistentry>
-   </variablelist>
-
-   <para>
-     Les méthodes d'index B-tree, hash, GiST et SP-GiST acceptent toutes ce
-     paramètre&nbsp;:
+    d'indexage peut avoir son propre ensemble de paramètres de stockage. Les
+    méthodes d'index B-tree, hash, GiST et SP-GiST acceptent toutes ce
+    paramètre&nbsp;:
    </para>
 
    <variablelist>