Skip to content

Commit

Permalink
Mise à jour en version 15 RC2
Browse files Browse the repository at this point in the history
  • Loading branch information
gleu committed Oct 8, 2022
1 parent 42352eb commit af0adcf
Show file tree
Hide file tree
Showing 29 changed files with 1,802 additions and 963 deletions.
273 changes: 137 additions & 136 deletions postgresql/backup.xml

Large diffs are not rendered by default.

208 changes: 97 additions & 111 deletions postgresql/config.xml
Original file line number Diff line number Diff line change
Expand Up @@ -3656,17 +3656,17 @@ block : bloc vidé, dirty bloc : bloc à vider ?
</term>
<listitem>
<para>
Taille maximale de l'augmentation des WAL entre deux points de
vérification automatique des WAL. C'est une limite souple&nbsp;; la
taille des WAL peut excéder <varname>max_wal_size</varname> sous
certaines circonstances, comme une surcharge du serveur, une commande
<varname>archive_library</varname> qui échoue, ou une configuration haute
pour <varname>wal_keep_size</varname>. Si cette valeur est indiquée
sans unité, elle est considérée être un nombre de Mo. La valeur par
défaut est 1 Go. Augmenter ce paramètre peut augmenter le temps
nécessaire pour le rejeu suite à un crash. Ce paramètre ne peut être
configuré que dans le fichier <filename>postgresql.conf</filename> ou
indiqué sur la ligne de commande.
Taille maximale de l'augmentation des WAL entre deux points de vérification
automatique des WAL. C'est une limite souple&nbsp;; la taille des WAL peut
excéder <varname>max_wal_size</varname> sous certaines circonstances, comme
une surcharge du serveur, une commande <varname>archive_command</varname>
ou <varname>archive_library</varname> qui échoue, ou une configuration
haute pour <varname>wal_keep_size</varname>. Si cette valeur est indiquée
sans unité, elle est considérée être un nombre de Mo. La valeur par défaut
est 1 Go. Augmenter ce paramètre peut augmenter le temps nécessaire pour le
rejeu suite à un crash. Ce paramètre ne peut être configuré que dans le
fichier <filename>postgresql.conf</filename> ou indiqué sur la ligne de
commande.
</para>
</listitem>
</varlistentry>
Expand Down Expand Up @@ -3706,49 +3706,28 @@ block : bloc vidé, dirty bloc : bloc à vider ?
<primary>paramètre de configuration <varname>archive_mode</varname></primary>
</indexterm>
<para>
Quand <varname>archive_mode</varname> est activé, les segments
WAL remplis peuvent être archivés en configurant <xref
linkend="guc-archive-library"/>. En plus de
<literal>off</literal>, pour désactiver, il y a deux autres
modes&nbsp;: <literal>on</literal>, et <literal>always</literal>. Lors
du fonctionnement normal du serveur, il n'y a pas de différences
entre les deux modes, mais lorsqu'il est positionné sur
<literal>always</literal>, l'archiveur des WAL est aussi activé lors
d'un rejeu des archives et en mode standby. Dans le
mode <literal>always</literal>, tous les fichiers restaurés
à partir de l'archive ou envoyés lors de la réplication en
continue seront archivés (à nouveau). Voir
<xref linkend="continuous-archiving-in-standby"/> pour des détails.
</para>

<para>
Ce paramètre ne peut être configuré qu'au lancement du serveur.
<varname>archive_mode</varname> ne peut pas être activé quand
<varname>wal_level</varname> est configuré à
<literal>minimal</literal>.
Quand <varname>archive_mode</varname> est activé, les segments WAL remplis
peuvent être archivés en configurant <xref linkend="guc-archive-command"/>
ou <xref linkend="guc-archive-library"/>. En plus de
<literal>off</literal>, pour désactiver, il y a deux autres modes&nbsp;:
<literal>on</literal>, et <literal>always</literal>. Lors du fonctionnement
normal du serveur, il n'y a pas de différences entre les deux modes, mais
lorsqu'il est positionné sur <literal>always</literal>, l'archiveur des WAL
est aussi activé lors d'un rejeu des archives et en mode standby. Dans le
mode <literal>always</literal>, tous les fichiers restaurés à partir de
l'archive ou envoyés lors de la réplication en continue seront archivés (à
nouveau). Voir <xref linkend="continuous-archiving-in-standby"/> pour des
détails.
</para>
</listitem>
</varlistentry>

<varlistentry id="guc-archive-library" xreflabel="archive_library">
<term><varname>archive_library</varname> (<type>string</type>)
<indexterm>
<primary>paramètre de configuration <varname>archive_library</varname></primary>
</indexterm>
</term>
<listitem>
<para>
Bibliothèque à utiliser pour l'archivage des journaux de transactions
terminés. Si configuré à une chaîne vide (valeur par défaut), l'archivage
via le shell est activé et <xref linkend="guc-archive-command"/> est
utilisé. Sinon, la bibliothèque partagée est utilisée pour l'archivage.
Pour plus d'informations, voir <xref linkend="backup-archiving-wal"/> et
<xref linkend="archive-modules"/>.
</para>
<para>
Ce paramètre peut seulement être configuré dans le fichier
<filename>postgresql.conf</filename> et sur la ligne de commande du
serveur.
<varname>archive_mode</varname> est un paramétrage séparé de
<varname>archive_command</varname> et <varname>archive_library</varname>
pour que <varname>archive_command</varname> et
<varname>archive_library</varname> puissent être modifiés sans abandonner
le mode d'archivage. Ce paramètre ne peut être configuré qu'au lancement
du serveur. <varname>archive_mode</varname> ne peut pas être activé quand
<varname>wal_level</varname> est configuré à <literal>minimal</literal>.
</para>
</listitem>
</varlistentry>
Expand All @@ -3775,20 +3754,42 @@ block : bloc vidé, dirty bloc : bloc à vider ?
Ce paramètre ne peut être configuré que dans le fichier
<filename>postgresql.conf</filename> ou indiqué sur la ligne de commande.
Il est ignoré sauf si <varname>archive_mode</varname> a été activé au
lancement du serveur et <varname>archive_library</varname> indique que
l'archivage se fait via une commande shell. Si
<varname>archive_command</varname> est une chaîne vide (la valeur par
défaut) alors que <varname>archive_mode</varname> est activé et
qu'<varname>archive_library</varname> précise un archivage par commande
shell, alors l'archivage des journaux de transactions est désactivé
temporairement mais le serveur continue d'accumuler les fichiers des
journaux de transactions dans l'espoir qu'une commande lui soit rapidement
proposée. Configurer <varname>archive_command</varname> à une commande qui
ne fait rien tout en renvoyant true, par exemple
<literal>/bin/true</literal> (<literal>REM</literal> sur Windows),
désactive l'archivage mais casse aussi la chaîne des fichiers des journaux
de transactions nécessaires pour la restauration d'une archive. Cela ne
doit donc être utilisé quand lors de circonstances inhabituelles.
lancement du serveur et <varname>archive_library</varname> est configuré à
une chaîne vide. Si <varname>archive_command</varname> est une chaîne vide
(la valeur par défaut) alors que <varname>archive_mode</varname> est activé
(et qu'<varname>archive_library</varname> est configuré à une chaîne vide),
alors l'archivage des journaux de transactions est désactivé temporairement
mais le serveur continue d'accumuler les fichiers des journaux de
transactions dans l'espoir qu'une commande lui soit rapidement proposée.
Configurer <varname>archive_command</varname> à une commande qui ne fait
rien tout en renvoyant true, par exemple <literal>/bin/true</literal>
(<literal>REM</literal> sur Windows), désactive l'archivage mais casse
aussi la chaîne des fichiers des journaux de transactions nécessaires pour
la restauration d'une archive. Cela ne doit donc être utilisé quand lors de
circonstances inhabituelles.
</para>
</listitem>
</varlistentry>

<varlistentry id="guc-archive-library" xreflabel="archive_library">
<term><varname>archive_library</varname> (<type>string</type>)
<indexterm>
<primary>paramètre de configuration <varname>archive_library</varname></primary>
</indexterm>
</term>
<listitem>
<para>
Bibliothèque à utiliser pour l'archivage des journaux de transactions
terminés. Si configuré à une chaîne vide (valeur par défaut), l'archivage
via le shell est activé et <xref linkend="guc-archive-command"/> est
utilisé. Sinon, la bibliothèque partagée est utilisée pour l'archivage.
Pour plus d'informations, voir <xref linkend="backup-archiving-wal"/> et
<xref linkend="archive-modules"/>.
</para>
<para>
Ce paramètre peut seulement être configuré dans le fichier
<filename>postgresql.conf</filename> et sur la ligne de commande du
serveur.
</para>
</listitem>
</varlistentry>
Expand All @@ -3800,32 +3801,31 @@ block : bloc vidé, dirty bloc : bloc à vider ?
<primary>paramètre de configuration <varname>archive_timeout</varname></primary>
</indexterm>
<para>
Le <xref linkend="guc-archive-library"/> n'est appelé que pour les
segments WAL remplis. De ce fait, si le serveur n'engendre que peu de trafic
WAL (ou qu'il y a des périodes de plus faible activité), il se peut qu'un long moment
s'écoule entre la fin d'une transaction et son archivage certain.
Le <xref linkend="guc-archive-command"/> ou le <xref
linkend="guc-archive-library"/> n'est appelé que pour les segments WAL
remplis. De ce fait, si le serveur n'engendre que peu de trafic WAL (ou
qu'il y a des périodes de plus faible activité), il se peut qu'un long
moment s'écoule entre la fin d'une transaction et son archivage certain.
Pour limiter l'âge des données non encore archivées,
<varname>archive_timeout</varname> peut être configuré pour forcer le
serveur à basculer périodiquement sur un nouveau segment WAL.
Lorsque ce paramètre est positif, le serveur bascule sur un nouveau
segment à chaque fois que cette durée
s'est écoulée depuis le dernier changement de segment et qu'il n'y a pas
eu d'activité de la base de données, y compris un seul CHECKPOINT.
(les points de reprise sont ne sont pas effectués s'il n'y a pas
d'activité sur les bases.)
Les fichiers archivés clos par anticipation suite à une
bascule imposée sont toujours de la même taille que les fichiers
complets. Il est donc déconseillé de configurer un temps très
court pour <varname>archive_timeout</varname> &mdash; cela va faire exploser
la taille du stockage des archives. Un paramétrage
serveur à basculer périodiquement sur un nouveau segment WAL. Lorsque ce
paramètre est positif, le serveur bascule sur un nouveau segment à chaque
fois que cette durée s'est écoulée depuis le dernier changement de segment
et qu'il n'y a pas eu d'activité de la base de données, y compris un seul
CHECKPOINT. (les points de reprise sont ne sont pas effectués s'il n'y a
pas d'activité sur les bases.) Les fichiers archivés clos par anticipation
suite à une bascule imposée sont toujours de la même taille que les
fichiers complets. Il est donc déconseillé de configurer un temps très
court pour <varname>archive_timeout</varname> &mdash; cela va faire
exploser la taille du stockage des archives. Un paramétrage
d'<varname>archive_timeout</varname> de l'ordre de la minute est
habituellement raisonnable. Cependant, vous devriez considérer
l'utilisation de la réplication en flux à la place de l'archivage si
vous voulez que les données soient envoyées du serveur primaire plus
rapidement que cela. Si cette valeur est indiquée sans unité, elle est
considérée comme un nombre de secondes. Ce paramètre ne peut être
configuré que dans le fichier <filename>postgresql.conf</filename> ou
indiqué sur la ligne de commande.
l'utilisation de la réplication en flux à la place de l'archivage si vous
voulez que les données soient envoyées du serveur primaire plus rapidement
que cela. Si cette valeur est indiquée sans unité, elle est considérée
comme un nombre de secondes. Ce paramètre ne peut être configuré que dans
le fichier <filename>postgresql.conf</filename> ou indiqué sur la ligne de
commande.
</para>
</listitem>
</varlistentry>
Expand Down Expand Up @@ -5279,21 +5279,6 @@ ANY <replaceable class="parameter">nb_sync</replaceable> ( <replaceable class="p
</listitem>
</varlistentry>

<varlistentry id="guc-enable-groupby-reordering" xreflabel="enable_group_by_reordering">
<term><varname>enable_group_by_reordering</varname> (<type>boolean</type>)
<indexterm>
<primary><varname>enable_group_by_reordering</varname> configuration parameter</primary>
</indexterm>
</term>
<listitem>
<para>
Active ou désactive le réordonnancement des clés dans la clause
<literal>GROUP BY</literal>. La valeur par défaut est
<literal>on</literal>.
</para>
</listitem>
</varlistentry>

<varlistentry id="guc-enable-hashagg" xreflabel="enable_hashagg">
<term><varname>enable_hashagg</varname> (<type>boolean</type>)</term>
<listitem>
Expand Down Expand Up @@ -11165,15 +11150,16 @@ SET XML OPTION { DOCUMENT | CONTENT };
</para>

<para>
Comme les options personnalisées peuvent avoir besoin d'être configurées
par des processus qui n'ont pas chargé le module d'extension associé,
<productname>PostgreSQL</productname> acceptera une configuration pour
tout paramètre ayant un nom en deux parties. Ces variables sont traitées
comme des espaces réservés et n'ont pas de fonction tant que le module qui
les définit n'est pas chargé. Quand un module d'extension est chargé, il
ajoute ses définitions de variables, convertit les valeurs déjà initialisées
suivant leur définition, et envoie des avertissements pour toute variable
non reconnue dont le nom commence par son nom d'extension.
Comme les options personnalisées peuvent avoir besoin d'être configurées par
des processus qui n'ont pas chargé le module d'extension associé,
<productname>PostgreSQL</productname> acceptera une configuration pour tout
paramètre ayant un nom en deux parties. Ces variables sont traitées comme
des espaces réservés et n'ont pas de fonction tant que le module qui les
définit n'est pas chargé. Quand un module d'extension est chargé, il ajoute
ses définitions de variables, et convertit les valeurs déjà initialisées
suivant leur définition. S'il existe des variables non reconnues dont le nom
commence par son nom d'extension, des avertissements sont envoyés et ces
variables sont supprimées.
</para>
</sect1>

Expand Down
2 changes: 1 addition & 1 deletion postgresql/custom-rmgr.xml
Original file line number Diff line number Diff line change
Expand Up @@ -70,7 +70,7 @@ typedef struct RmgrData
*
* Les ID de gestionnaire de ressources doivent être uniques au monde pour
* toutes les extensions. Se référer à
* https://wiki.postgresql.org/wiki/CustomWALResourceManager pour réserver un
* https://wiki.postgresql.org/wiki/CustomWALResourceManagers pour réserver un
* RmgrId unique pour votre extension, afin d'éviter les conflits avec les
* extensions d'autres développeurs. Lors du développement, utilisez
* RM_EXPERIMENTAL_ID pour éviter la réservation inutile d'un nouvel ID.
Expand Down
2 changes: 1 addition & 1 deletion postgresql/docguide.xml
Original file line number Diff line number Diff line change
Expand Up @@ -65,7 +65,7 @@
lecture en ligne. Le <ulink
url="http://newbiedoc.sourceforge.net/metadoc/docbook-guide.html">guide
DocBook des nouveaux venus</ulink> est très utile pour les débutants. Le
<ulink url="https://www.freebsd.org/docproj/docproj.html">projet de
<ulink url="https://www.freebsd.org/docproj/">projet de
documentation FreeBSD</ulink> utilise également DocBook et fournit
également de bonnes informations, incluant un certain nombre de
lignes directrices qu'il peut être bon de prendre en considération.
Expand Down
4 changes: 2 additions & 2 deletions postgresql/func.xml
Original file line number Diff line number Diff line change
Expand Up @@ -26625,7 +26625,7 @@ postgres=# SELECT * FROM pg_walfile_name_offset((pg_backup_stop()).lsn);
<indexterm>
<primary>pg_create_physical_replication_slot</primary>
</indexterm>
<function>pg_create_physical_replication_slot</function> ( <parameter>slot_name</parameter> <type>name</type> <optional>, <parameter>immediately_reserve</parameter> <type>boolean</type>, <parameter>temporary</parameter> <type>boolean</type>, <parameter>two_phase</parameter> <type>boolean</type> </optional> )
<function>pg_create_physical_replication_slot</function> ( <parameter>slot_name</parameter> <type>name</type> <optional>, <parameter>immediately_reserve</parameter> <type>boolean</type>, <parameter>temporary</parameter> <type>boolean</type>, <parameter>twophase</parameter> <type>boolean</type> </optional> )
<returnvalue>record</returnvalue>
( <parameter>slot_name</parameter> <type>name</type>,
<parameter>lsn</parameter> <type>pg_lsn</type> )
Expand All @@ -26645,7 +26645,7 @@ postgres=# SELECT * FROM pg_walfile_name_offset((pg_backup_stop()).lsn);
permanente sur disque et qu'il a seulement pour but d'être utilisé
dans la session en cours. Les slots temporaires sont aussi supprimés
dès qu'une erreur survient. Le quatrième paramètre optionnel,
<parameter>two_phase</parameter>, quand il vaut true, indique
<parameter>twophase</parameter>, quand il vaut true, indique
que le décodage des transactions préparées est autorisé pour ce
slot. Cette fonction correspond à la commande
<literal>CREATE_REPLICATION_SLOT ... PHYSICAL</literal> du protocole
Expand Down

0 comments on commit af0adcf

Please sign in to comment.