Skip to content

Commit

Permalink
Merge v14 RC1
Browse files Browse the repository at this point in the history
  • Loading branch information
gleu committed Sep 26, 2021
1 parent 84647e6 commit 5d6b955
Show file tree
Hide file tree
Showing 20 changed files with 967 additions and 550 deletions.
17 changes: 8 additions & 9 deletions postgresql/bgworker.xml
Original file line number Diff line number Diff line change
Expand Up @@ -303,15 +303,14 @@ typedef struct BackgroundWorker
</para>

<para>
Si un processus en tâche de fond envoie des notifications asynchrones avec
la commande <command>NOTIFY</command> via <acronym>SPI</acronym>), il devrait
appeler <function>ProcessCompletedNotifies</function> explicitement après
avoir validé la transaction englobante pour que les notifications soient
envoyées. Si un processus en tâche de fond se déclare pour recevoir des
notifications asynchrones avec <command>LISTEN</command> via
<acronym>SPI</acronym>, le processus tracera les notifications. Cependant,
il n'existe pas de façon programmé pour que le processus intercepte et
réponde à ces notifications.
Les processus en tâche de fond peuvent envoyer des messages de notificatio
asynchrones, soit en utilisant la commande <command>NOTIFY</command> via
<acronym>SPI</acronym>, soit directement avec <function>Async_Notify
()</function>. De telles notifications seront envoyées au moment du commit.
Les processus en tâche de fond ne doivent pas s'enregistrer pour recevoir
des notifications asynchrones avec la commande <command>LISTEN</command>,
car il n'existe pas d'infrastructure pour qu'un tel processus puisse
consommer ce type de notifications.
</para>

<para>
Expand Down
8 changes: 4 additions & 4 deletions postgresql/fdwhandler.xml
Original file line number Diff line number Diff line change
Expand Up @@ -688,10 +688,10 @@ ExecForeignInsert (EState *estate,
<programlisting>
TupleTableSlot **
ExecForeignBatchInsert(EState *estate,
ResultRelInfo *rinfo,
TupleTableSlot **slots,
TupleTableSlot **planSlots,
int *numSlots);
ResultRelInfo *rinfo,
TupleTableSlot **slots,
TupleTableSlot **planSlots,
int *numSlots);
</programlisting>

Insère plusieurs lignes en bloc dans la table distante. Les paramètres
Expand Down
2 changes: 1 addition & 1 deletion postgresql/high-availability.xml
Original file line number Diff line number Diff line change
Expand Up @@ -2118,7 +2118,7 @@ LOG: entering standby mode
... puis, plus loin ...

LOG: consistent recovery state reached
LOG: database system is ready to accept read only connections
LOG: database system is ready to accept read-only connections
</programlisting>

L'information sur la cohérence est enregistrée une fois par checkpoint sur le primaire.
Expand Down
7 changes: 4 additions & 3 deletions postgresql/libpq.xml
Original file line number Diff line number Diff line change
Expand Up @@ -1864,9 +1864,10 @@ postgresql://user@localhost:5433/mydb?options=-c%20synchronous_commit%3Doff
<term><literal>sslsni</literal><indexterm><primary>Server Name Indication</primary></indexterm></term>
<listitem>
<para>
Par défaut, libpq configure l'extension TLS <quote>Server Name
Indication</quote> (<acronym>SNI</acronym>) sur les connexions SSL.
En configurant ce paramètre à 0, il est désactivé.
Si ce paramètre est configuré à A (sa valeur par défaut), libpq
configure l'extension TLS <quote>Server Name Indication</quote>
(<acronym>SNI</acronym>) sur les connexions SSL. En configurant ce
paramètre à 0, il est désactivé.
</para>

<para>
Expand Down
4 changes: 2 additions & 2 deletions postgresql/lobj.xml
Original file line number Diff line number Diff line change
Expand Up @@ -457,7 +457,7 @@
<indexterm><primary>lo_truncate</primary></indexterm>
Pour tronquer un «&nbsp;Large Object&nbsp;» avec une longueur donnée, on
utilise
<synopsis>int lo_truncate(PGcon *conn, int fd, size_t len);
<synopsis>int lo_truncate(PGconn *conn, int fd, size_t len);
</synopsis>
Cette fonction tronque le «&nbsp;Large Object&nbsp;» décrit par
<parameter>fd</parameter> avec la longueur <parameter>len</parameter>.
Expand Down Expand Up @@ -486,7 +486,7 @@
Lors de la gestion de «&nbsp;Large Objects&nbsp;» qui pourraient dépasser
2 Go, utilisez à la place
<synopsis>
int lo_truncate64(PGcon *conn, int fd, pg_int64 len);
int lo_truncate64(PGconn *conn, int fd, pg_int64 len);
</synopsis>
Cette fonction a le même comportement que <function>lo_truncate</function>
mais elle peut accepter une valeur supérieure à 2 Go pour le paramètre
Expand Down
9 changes: 1 addition & 8 deletions postgresql/maintenance.xml
Original file line number Diff line number Diff line change
Expand Up @@ -892,14 +892,7 @@ limite insertion vacuum = limite insertion base vacuum + facteur échelle insert
définie comme <programlisting>limite du analyze = limite de base du
analyze + facteur d'échelle du analyze * nombre de
lignes</programlisting> est comparée au nombre de lignes insérées, mises
à jour et supprimées depuis le dernier <command>ANALYZE</command>. Pour
les tables partitionnées, les insertions, mises à jour et suppressions
sur des partitions sont comptabilisées our la comparaison avec cette
limite&nbsp;; néanmoins, les opérations DDL telles que
<literal>ATTACH</literal>, <literal>DETACH</literal> et
<literal>DROP</literal> ne le sont pas, donc l'exécution d'un
<command>ANALYZE</command> manuel est recommandé si la partition ajoutée
ou supprimée contient un volume statistiquement significatif de données.
à jour et supprimées depuis le dernier <command>ANALYZE</command>.
</para>

<para>
Expand Down
2 changes: 1 addition & 1 deletion postgresql/perform.xml
Original file line number Diff line number Diff line change
Expand Up @@ -1850,7 +1850,7 @@ WHERE quelquechosedautre;</programlisting>
l'intérieur d'une table, exécuter <link
linkend="sql-analyze"><command>ANALYZE</command></link> est fortement
recommandé. Ceci inclut le chargement de grosses quantités de données
dans la table ainsi qu'attacher, détacher ou supprimer des partitions.
dans la table.
Exécuter <command>ANALYZE</command> (ou <command>VACUUM
ANALYZE</command>) vous assure que le planificateur dispose de
statistiques à jour sur la table. Sans statistiques ou avec des
Expand Down
2 changes: 1 addition & 1 deletion postgresql/postgres-fdw.xml
Original file line number Diff line number Diff line change
Expand Up @@ -592,7 +592,7 @@ OPTIONS (ADD password_required 'false');
</listitem>
</varlistentry>
<varlistentry>
<term><literal>import_generated</literal> (<type>boolean</type>)</term>
<term><literal>import_generated</literal></term>
<listitem>
<para>
Cette option contrôle si les expressions <literal>GENERATED</literal>
Expand Down
2 changes: 1 addition & 1 deletion postgresql/protocol.xml
Original file line number Diff line number Diff line change
Expand Up @@ -7240,7 +7240,7 @@ Message

<para>

Les message suivants (Stream Start, Stream End, Stream Commit, et Stream Abort)
Les message suivants (Stream Start, Stream Stop, Stream Commit, et Stream Abort)
sont disponibles à partir de la version 2 du protocole.

</para>
Expand Down
10 changes: 4 additions & 6 deletions postgresql/ref/alter_subscription.xml
Original file line number Diff line number Diff line change
Expand Up @@ -112,9 +112,7 @@ ALTER SUBSCRIPTION <replaceable class="parameter">nom</replaceable> RENAME TO <r
publications de la liste des publications. Voir <xref
linkend="sql-createsubscription"/> pour plus d'informations. Par
défaut, cette commande agira aussi comme <literal>REFRESH
PUBLICATION</literal>, sauf que, dans le cas de <literal>ADD</literal>
ou <literal>DROP</literal>, seules les publications ajoutées ou
supprimées sont rafraichies.
PUBLICATION</literal>.
</para>

<para>
Expand All @@ -136,9 +134,9 @@ ALTER SUBSCRIPTION <replaceable class="parameter">nom</replaceable> RENAME TO <r
</varlistentry>
</variablelist>

De plus, les options de rafraichissement décrites sous <literal>REFRESH
PUBLICATION</literal> peuvent être spécifiées, sauf dans le cas de
<literal>DROP PUBLICATION</literal>.
De plus, les options décrites sous <literal>REFRESH
PUBLICATION</literal> peuvent être spécifiées pour contrôler
l'opération implicite de rafraichissement.
</para>
</listitem>
</varlistentry>
Expand Down
42 changes: 12 additions & 30 deletions postgresql/ref/analyze.xml
Original file line number Diff line number Diff line change
Expand Up @@ -253,39 +253,21 @@ ANALYZE [ VERBOSE ] [ <replaceable class="parameter">table_et_colonnes</replacea
</para>

<para>
Si la table en cours d'analyse est partitionnée, <command>ANALYZE</command>
récupérera les statistiques avec des échantillons de blocs au hasard dans
les partitions&nbsp;; de plus, il parcourera récursivement chaque
partition et mettra à jour leurs statistiques. (Néanmoins, dans les
scénarios de partitionnement multi-niveaux, chaque partition du dernier
niveau sera analysée une seule fois.) Par contre, si la table en cours
d'analyse a des tables héritées, <command>ANALYZE</command> récupérera ses
statistiques deux fois&nbsp;: une fois sur les lignes de la table parent
seule, et une deuxième fois sur les lignes de la table parent et de tous
ses enfants. Ce deuxième ensemble de statistiques est nécessaire pour
planifier des requêtes qui traversent l'arbre complet d'héritage. Les
tables enfants elles-mêmes ne sont pas analysées individuellement dans ce
cas.
Si la table en cours d'analyse a un ou plusieurs enfants,
<command>ANALYZE</command> récupérera les statistiques deux fois&nbsp;:
une fois pour la table parent seule, et une deuxième fois sur les lignes
de la table parent et de tous ses enfants. Le deuxième ensemble de
statistiques est nécessaire lors de la planification de requêtes qui
traversent l'arbre d'héritage complet. Néanmoins, le démon autovacuum ne
prendra en considération que les insertions et les mises à jour sur la
table parent elle-même pour décider de déclencher une analyse automatique
sur cette table. Si cette table a rarement des insertions ou des mises à
jour, les statistiques sur l'arbre d'héritage complet ne seront pas à jour
tant que vous n'exécuterez pas <command>ANALYZE</command> manuellement.
</para>

<para>
Le processus autovacuum compte les insertions, mises à jour, suppressions
dans les partitions pour déterminer si l'auto-analyze est nécessaire.
Néanmoins, ajouter ou supprimer des partitions n'affecte pas les décisions
du processus autovacuum, donc déclencher un <command>ANALYZE</command>
manuel est recommandé dans ce cas s'il survient.
</para>

<para>
Les lignes modifiées dans les tables héritées ne comptent pas pour
l'analyse de la table parent. Si la table parent est vide ou rarement
modifiée, elle pourrait ne jamais être traitée par autovacuum. Il est
nécessaire d'exécuter périodiquement un <command>ANALYZE</command> manuel
pour conserver à jour les statistiques de la hiérarchie de tables.
</para>

<para>
Si certaines tables filles ou partitions sont des tables externes dont les wrappers de
Si certaines tables filles sont des tables externes dont les wrappers de
données externes ne supportent pas <command>ANALYZE</command>, ces tables
filles sont ignorées lors de la récupération de statistiques pour
l'héritage.
Expand Down
13 changes: 10 additions & 3 deletions postgresql/ref/copy.xml
Original file line number Diff line number Diff line change
Expand Up @@ -654,13 +654,13 @@ COPY <replaceable class="parameter">nombre</replaceable>
</row>
<row>
<entry><literal>\</literal><replaceable>chiffres</replaceable></entry>
<entry>Antislash suivi d'un à trois chiffres en octal représente le
caractère qui possède ce code numérique</entry>
<entry>Antislash suivi d'un à trois chiffres en octal représente
l'octet qui possède ce code numérique</entry>
</row>
<row>
<entry><literal>\x</literal><replaceable>digits</replaceable></entry>
<entry>Antislash <literal>x</literal> suivi d'un ou deux chiffres hexadécimaux
représente le caractère qui possède ce code numérique</entry>
représente l'octet qui possède ce code numérique</entry>
</row>
</tbody>
</tgroup>
Expand Down Expand Up @@ -693,6 +693,13 @@ COPY <replaceable class="parameter">nombre</replaceable>
est transféré sur d'autres plateformes (d'un Unix vers un Windows ou inversement, par exemple).
</para>

<para>
Toutes les séquences avec antislash sont interprétées après la conversion
d'encodage. Les octets indiquées avec des séquences octales ou
hexadécimales doivent former des caractères valides dans l'encodage de la
base.
</para>

<para>
<command>COPY TO</command> termine chaque ligne par une
nouvelle ligne de style Unix (<quote><literal>\n</literal></quote>). Les serveurs
Expand Down
9 changes: 3 additions & 6 deletions postgresql/ref/create_table.xml
Original file line number Diff line number Diff line change
Expand Up @@ -1442,10 +1442,9 @@ contrainte <literal>EXCLUDE</literal> peut valoir&nbsp;:</phrase>
<xref linkend="storage-toast"/> pour plus d'informations sur TOAST). Si
une valeur de paramètre d'une table est configuré et que le paramètre
équivalent <literal>toast.</literal> ne l'est pas, la partie TOAST
utilisera la valeur du paramètre de la table.
Sauf quand cela est noté, ces paramètres ne sont pas supportés sur les
tables partitionnées. Néanmoins, vous pouvez les indiquer sur des
partitions enfants individuelles.
utilisera la valeur du paramètre de la table. Ces paramètres ne sont pas
supportés sur les tables partitionnées mais vous pouvez les indiquer sur
des partitions enfants individuelles.
</para>

<variablelist>
Expand Down Expand Up @@ -1534,8 +1533,6 @@ contrainte <literal>EXCLUDE</literal> peut valoir&nbsp;:</phrase>
<command>VACUUM</command> et/ou <command>ANALYZE</command> automatiques
sur cette table en suivant les règles discutées dans <xref
linkend="autovacuum"/>.
Ce paramètre peut être configuré pour empêcher l'autovacuum d'exécuter
<command>ANALYZE</command> sur les tables partitionnées.
À false, cette table ne sera pas traitée par le
démon autovacuum, sauf s'il y a un risque de réutilisation des
identifiants de transaction. Voir <xref
Expand Down
4 changes: 4 additions & 0 deletions postgresql/ref/create_trigger.xml
Original file line number Diff line number Diff line change
Expand Up @@ -176,6 +176,10 @@
</para>

<para>
<indexterm>
<primary>trigger</primary>
<secondary>constraint trigger</secondary>
</indexterm>
Lorsque l'option <literal>CONSTRAINT</literal> est spécifiée, cette
commande crée un <firstterm>déclencheur contrainte</firstterm>. Ce nouvel
objet est identique aux déclencheurs normaux excepté le fait que le moment
Expand Down
14 changes: 1 addition & 13 deletions postgresql/ref/pg_amcheck.xml
Original file line number Diff line number Diff line change
Expand Up @@ -289,9 +289,7 @@
<literal>--table</literal>, <literal>--index</literal>
ou <literal>--relation</literal> ne correspond à aucun objet,
ceci est traité comme une erreur fatale. Cette option diminue
le niveau de l'erreur à un simple message d'avertissement. Si
cette option est utilisée avec <literal>--quiet</literal>, le
message d'avertissement est lui-aussi supprimé.
le niveau de l'erreur à un simple message d'avertissement.
</para>
</listitem>
</varlistentry>
Expand Down Expand Up @@ -569,16 +567,6 @@
</listitem>
</varlistentry>

<varlistentry>
<term><option>-q</option></term>
<term><option>--quiet</option></term>
<listitem>
<para>
Affiche moins de messages et moins de détails sur les erreurs du serveur.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><option>-P</option></term>
<term><option>--progress</option></term>
Expand Down
8 changes: 3 additions & 5 deletions postgresql/ref/pg_restore.xml
Original file line number Diff line number Diff line change
Expand Up @@ -958,11 +958,9 @@
<para>
Une fois la restauration terminée, il est conseillé de lancer
<command>ANALYZE</command> sur chaque table restaurée de façon à ce que
l'optimiseur dispose de statistiques utiles. Si la table est une partition
ou une table enfant d'héritage, il pourrait aussi être utile d'analyser le
parent pour mettre à jour les statistiques de la hiérarchie de tables.
Voir <xref linkend="vacuum-for-statistics"/> et <xref
linkend="autovacuum"/> pour plus d'informations.
l'optimiseur dispose de statistiques utiles. Voir <xref
linkend="vacuum-for-statistics"/> et <xref linkend="autovacuum"/> pour
plus d'informations.
</para>

</refsect1>
Expand Down

0 comments on commit 5d6b955

Please sign in to comment.