Skip to content

Commit

Permalink
Mise à jour en version 13.5
Browse files Browse the repository at this point in the history
  • Loading branch information
gleu committed Nov 21, 2021
1 parent 0442ab8 commit c269585
Show file tree
Hide file tree
Showing 17 changed files with 2,032 additions and 42 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 notification
asynchrones, soit en utilisant la commande <command>NOTIFY</command> via
<acronym>SPI</acronym>, soit directement via <function>Async_Notify
()</function>. Ces notifications seront envoyées aux moment de la
validation de la transaction. Les processus en tâche de fond ne doivent pas
s'enregistrer comme recevant des notifications asynchrones avec la commande
<command>LISTEN</command> car il n'existe pas d'infrastructure pour qu'un
tel processus puisse consommer des notifications.
</para>

<para>
Expand Down
10 changes: 3 additions & 7 deletions postgresql/charset.xml
Original file line number Diff line number Diff line change
Expand Up @@ -774,8 +774,8 @@ CREATE COLLATION german (provider = libc, locale = 'de_DE');
utilisateurs sont encouragés à définir leur propres objets de collation
utilisant ces fonctionnalités pour rendre le comportement de tri
compatible avec leurs besoins.
Voir <ulink url="http://userguide.icu-project.org/locale"></ulink>
et <ulink url="http://userguide.icu-project.org/collation/api"></ulink>
Voir <ulink url="https://unicode-org.github.io/icu/userguide/locale/"></ulink>
et <ulink url="https://unicode-org.github.io/icu/userguide/collation/api.html"></ulink>
pour plus d'informations sur le nommage des locales ICU. L'ensemble de
noms et attributs acceptables dépend de la version ICU spécifique.
</para>
Expand Down Expand Up @@ -874,11 +874,7 @@ CREATE COLLATION german (provider = libc, locale = 'de_DE');
La liste des types de collationnement possibles (sous-ensemble
<literal>co</literal>) peut être trouvée dans le <ulink
url="https://github.com/unicode-org/cldr/blob/master/common/bcp47/collation.xml">dépôt
CLDR</ulink>. Le <ulink url="https://ssl.icu-project.org/icu-
bin/locexp">ICU Locale Explorer</ulink> peut être utilisé pour vérifier
les détails de la définition d'une locale particulière. Les exemples
utilisant les sous-balises <literal>k*</literal> requièrent au moins la
version 54 d'ICU.
CLDR</ulink>.
</para>

<para>
Expand Down
7 changes: 5 additions & 2 deletions postgresql/config.xml
Original file line number Diff line number Diff line change
Expand Up @@ -1626,8 +1626,11 @@ include 'nom_fichier'
</para>

<para>
Pour le moment, ce paramètre n'est supporté que sur Linux et Windows.
Il est ignoré sur les autres systèmes quand il est à <literal>try</literal>.
Pour le moment, ce paramètre n'est supporté que sur Linux et Windows. Il
est ignoré sur les autres systèmes quand il est à
<literal>try</literal>. Sur Linux, il est seulement supporté quand
<varname>shared_memory_type</varname> est configuré à
<literal>mmap</literal> (la valeur par défaut).
</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 @@ -434,7 +434,7 @@ pg_int64 lo_tell64(PGconn *conn, int fd);
<indexterm><primary>lo_truncate</primary></indexterm>
Pour tronquer un objet large avec une longueur donnée, on utilise
<synopsis>
int lo_truncate(PGcon *conn, int fd, size_t len);
int lo_truncate(PGconn *conn, int fd, size_t len);
</synopsis>
Cette fonction tronque le « Large Object » décrit par
<parameter>fd</parameter> avec la longueur <parameter>len</parameter>.
Expand Down Expand Up @@ -462,7 +462,7 @@ int lo_truncate(PGcon *conn, int fd, size_t len);
Lors de la gestion de « Large Objects » 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
12 changes: 7 additions & 5 deletions postgresql/monitoring.xml
Original file line number Diff line number Diff line change
Expand Up @@ -5657,11 +5657,13 @@ SELECT pid, wait_event_type, wait_event FROM pg_stat_activity WHERE wait_event i
<entry><literal>vacuuming indexes</literal></entry>
<entry>
<command>VACUUM</command> est en train de nettoyer les index. Si une
table a des index, ceci surviendra au moins une fois par vacuum, après
le parcours complet de la table. Cela pourrait arriver plusieurs fois
par vacuum si <xref linkend="guc-maintenance-work-mem"/> n'est pas
suffisamment important pour y enregistrer le nombre de lignes mortes
trouvées.
table a des index, ceci surviendra au moins une fois par vacuum,
après le parcours complet de la table. Cela pourrait arriver
plusieurs fois par vacuum si <xref
linkend="guc-maintenance-work-mem"/> (ou, dans le cas de
l'autovacuum, <xref linkend="guc-autovacuum-work-mem"/> s'il est
configuré) n'est pas suffisamment important pour y enregistrer le
nombre de lignes mortes trouvées.
</entry>
</row>
<row>
Expand Down
7 changes: 7 additions & 0 deletions postgresql/pgcrypto.xml
Original file line number Diff line number Diff line change
Expand Up @@ -1272,6 +1272,13 @@ gen_random_uuid() returns uuid
</tgroup>
</table>

<para>
Lorsqu'elle est compilée avec <productname>OpenSSL</productname> 3.0.0 ou
une version ultérieure, le fournisseur hérité doit être activé dans le
fichier de configuration <filename>openssl.cnf</filename> pour utiliser
les anciens chiffrements tels que DES or Blowfish.
</para>

<para>
Notes&nbsp;:
</para>
Expand Down
18 changes: 15 additions & 3 deletions postgresql/postgres-fdw.xml
Original file line number Diff line number Diff line change
Expand Up @@ -93,7 +93,7 @@
lâche sur les conversions de type de données, des anomalies sémantiques
surprenantes peuvent survenir quand les types ou les collationnements ne
correspondent pas dans le cas où le serveur distant interprète légèrement
différemment les clauses <literal>WHERE</literal>.
différemment les conditions de la requête.
</para>

<para>
Expand Down Expand Up @@ -450,7 +450,19 @@ OPTIONS (ADD password_required 'false');
<literal>true</literal>. Vous pourriez avoir besoin de la désactiver si
le serveur distant possède un ensemble de noms de collation différent
de celui du serveur local, ce qui risque d'être le cas s'il utilise un
autre système d'exploitation.
autre système d'exploitation. Néanmoins, si vous le faites, il existe
un risque sévère que les collations importées des colonnes de la table
ne correspondent pas aux données, résultant en un comportement
anormale de la requête.
</para>

<para>
Même quand ce paramètre est configuré à <literal>true</literal>,
importer des colonnes dont la collation est la valeur par défaut du
serveur distant peut se révéler risqué. Elles seront importées avec
<literal>COLLATE "default"</literal>, qui sélectionnera la collation
par défaut du serveur local, qui pourrait bien être différente de
celle du serveur distant.
</para>
</listitem>
</varlistentry>
Expand All @@ -472,7 +484,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
30 changes: 30 additions & 0 deletions postgresql/protocol.xml
Original file line number Diff line number Diff line change
Expand Up @@ -1473,6 +1473,21 @@ SELCT 1/0;<!-- l'erreur est intentionnelle -->
nouvelle connexion et procéder sans <acronym>SSL</acronym>.
</para>

<para>
Quand le chiffrement <acronym>SSL</acronym> doit être réalisé, le serveur
doit envoyer seulement l'octet <literal>S</literal>, puis attendre que le
client initie une poignée de main <acronym>SSL</acronym>. Si des octets
supplémentaires sont disponibles en lecture à ce moment, cela pourrait
signifier qu'une attaque <foreignphrase>man-in-the-middle</foreignphrase>
tente de réaliser une attaque
<foreignphrase>buffer-stuffing</foreignphrase>
(<ulink
url="https://www.postgresql.org/support/security/CVE-2021-23222/">CVE-2021-23222</ulink>).
Les clients doivent être codés pour soit lire exactement un octet du
socket avant de rendre le socket à la bibliothèque SSL, soit traiter
comme une violation de protocole tout octet supplémentaire.
</para>

<para>
Un SSLRequest initial peut également être utilisé dans une connexion en
cours d'ouverture pour envoyer un message CancelRequest.
Expand Down Expand Up @@ -1532,6 +1547,21 @@ SELCT 1/0;<!-- l'erreur est intentionnelle -->
connexion et continuer sans demander le chiffrement <acronym>GSSAPI</acronym>.
</para>

<para>
Quand le chiffrement <acronym>GSSAPI</acronym> peut être réalisé, le serveur
doit envoyer seulement l'octet <literal>G</literal>, puis attendre que le
client initie une poignée de main <acronym>GSSAPI</acronym>. Si des octets
supplémentaires sont disponibles en lecture à ce moment, cela pourrait
signifier qu'une attaque <foreignphrase>man-in-the-middle</foreignphrase>
tente de réaliser une attaque
<foreignphrase>buffer-stuffing</foreignphrase>
(<ulink
url="https://www.postgresql.org/support/security/CVE-2021-23222/">CVE-2021-23222</ulink>).
Les clients doivent être codés pour soit lire exactement un octet du
socket avant de rendre le socket à la bibliothèque GSSAPI, soit traiter
comme une violation de protocole tout octet supplémentaire.
</para>

<para>
Un GSSENCRequest initial peut aussi être utilisé dans une connexion en
train d'être ouverte pour envoyer un message CancelRequest.
Expand Down
50 changes: 44 additions & 6 deletions postgresql/queries.xml
Original file line number Diff line number Diff line change
Expand Up @@ -1649,13 +1649,9 @@ SELECT a "value", b + c AS somme FROM ...
<synopsis><replaceable>requete1</replaceable> UNION <optional>ALL</optional> <replaceable>requete2</replaceable>
<replaceable>requete1</replaceable> INTERSECT <optional>ALL</optional> <replaceable>requete2</replaceable>
<replaceable>requete1</replaceable> EXCEPT <optional>ALL</optional> <replaceable>requete2</replaceable></synopsis>
<replaceable>requete1</replaceable> et
<replaceable>requete1</replaceable> et
<replaceable>requete2</replaceable> sont les requêtes pouvant utiliser
toutes les fonctionnalités discutées ici. Les opérations d'ensemble peuvent
aussi être combinées et chaînées, par exemple
<synopsis><replaceable>requete1</replaceable> UNION <replaceable>requete2</replaceable> UNION <replaceable>requete3</replaceable></synopsis>
est exécuté ainsi&nbsp;:
<synopsis>(<replaceable>requete1</replaceable> UNION <replaceable>requete2</replaceable>) UNION <replaceable>requete3</replaceable></synopsis>
toutes les fonctionnalités discutées ici.
</para>

<para>
Expand Down Expand Up @@ -1689,6 +1685,48 @@ SELECT a "value", b + c AS somme FROM ...
colonnes correspondantes doivent avoir des types de données compatibles,
comme décrit dans la <xref linkend="typeconv-union-case"/>.
</para>

<para>
Les opérations sur les ensembles peuvent être combinées, par exemple&nbsp;:
<synopsis>
<replaceable>requete1</replaceable> UNION <replaceable>requete2</replaceable> EXCEPT <replaceable>requete3</replaceable>
</synopsis>
qui est équivalent à&nbsp;:
<synopsis>
(<replaceable>requete1</replaceable> UNION <replaceable>requete2</replaceable>) EXCEPT <replaceable>requete3</replaceable>
</synopsis>
Comme indiqué ici, vous pouvez utiliser les parenthèses pour contrôler
l'ordre d'évaluation. Sans les parenthèses, <literal>UNION</literal> et
<literal>EXCEPT</literal> font une association de gauche à droite, mais
<literal>INTERSECT</literal> a une priorité plus forte que ces deux
opérateurs. De ce fait&nbsp;:
<synopsis>
<replaceable>requete1</replaceable> UNION <replaceable>requete2</replaceable> INTERSECT <replaceable>requete3</replaceable>
</synopsis>
signifie
<synopsis>
<replaceable>requete1</replaceable> UNION (<replaceable>requete2</replaceable> INTERSECT <replaceable>requete3</replaceable>)
</synopsis>
Vous pouvez aussi entourer une <replaceable>requête</replaceable>
individuelle avec des parenthèses. C'est important si la
<replaceable>requête</replaceable> a besoin d'utiliser une des clauses
discutées dans les sections suivantes, telles que
<literal>LIMIT</literal>. Sans les parenthèses, vous obtiendrez soit une
erreur de syntaxe soit une interprétation de cette clausse comme
s'appliquant à la sortie de l'opération ensembliste plutôt que sur une de
ses entrées. Par exemple&nbsp;:
<synopsis>
SELECT a FROM b UNION SELECT x FROM y LIMIT 10
</synopsis>
est acceptée, mais signifie&nbsp;:
<synopsis>
(SELECT a FROM b UNION SELECT x FROM y) LIMIT 10
</synopsis>
et non pas&nbsp;:
<synopsis>
SELECT a FROM b UNION (SELECT x FROM y LIMIT 10)
</synopsis>
</para>
</sect1>


Expand Down
13 changes: 10 additions & 3 deletions postgresql/ref/copy.xml
Original file line number Diff line number Diff line change
Expand Up @@ -645,13 +645,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 @@ -684,6 +684,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 d'antislash sont interprétées après la conversion
d'encodage. Les octets indiquées avec des séquences d'encodage octales et
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
2 changes: 1 addition & 1 deletion postgresql/ref/create_event_trigger.xml
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@
<synopsis>
CREATE EVENT TRIGGER <replaceable class="parameter">nom</replaceable>
ON <replaceable class="parameter">evenement</replaceable>
[ WHEN <replaceable class="parameter">variable_filtre</replaceable> IN (valeur_filtre [, ... ]) [ AND ... ] ]
[ WHEN <replaceable class="parameter">variable_filtre</replaceable> IN (<replaceable class="parameter">valeur_filtre</replaceable> [, ... ]) [ AND ... ] ]
EXECUTE { FUNCTION | PROCEDURE } <replaceable class="parameter">nom_fonction</replaceable>()
</synopsis>
</refsynopsisdiv>
Expand Down
25 changes: 25 additions & 0 deletions postgresql/ref/pg_receivewal.xml
Original file line number Diff line number Diff line change
Expand Up @@ -79,6 +79,31 @@
laisser au moins une session disponible pour le flux.
</para>

<para>
Le point de démarrage du flux des journaux de transactions est calculé
quand <application>pg_receivewal</application> démarre&nbsp;:
<orderedlist>
<listitem>
<para>
Tout d'abord, il parcourt le répertoire où les segments de journaux de
transactions sont écrits et trouver le segment terminé le plus récent
pour l'utiliser comme point de départ du prochain segment. Ceci est
calculé indépendamment de la méthode de compression utilisée pour
compresser chaque segment.
</para>
</listitem>

<listitem>
<para>
Si un point de démarrage ne peut pas être calculé avec la méthode
précédente, l'emplacement de vidage des journaux de transactions est
utilisé comme indiqué par le serveur à partir d'une commande
<literal>IDENTIFY_SYSTEM</literal>.
</para>
</listitem>
</orderedlist>
</para>

<para>
Si la connexion est perdue ou si elle ne peux pas être établie
initialement, via une erreur non fatale,
Expand Down
2 changes: 1 addition & 1 deletion postgresql/ref/reindexdb.xml
Original file line number Diff line number Diff line change
Expand Up @@ -207,7 +207,7 @@
<term><option>--system</option></term>
<listitem>
<para>
Réindexe les catalogues système de la base de données.
Réindexe seulement les catalogues système de la base de données.
</para>
</listitem>
</varlistentry>
Expand Down
3 changes: 2 additions & 1 deletion postgresql/ref/select.xml
Original file line number Diff line number Diff line change
Expand Up @@ -1487,7 +1487,8 @@ FETCH { FIRST | NEXT } [ <replaceable class="parameter">compte</replaceable> ] {
<literal>WITH TIES</literal> est utilisée pour renvoyer toute ligne
supplémentaire qui se lie pour la dernière place dans le jeu de résultats
selon la clause <literal>ORDER BY</literal>&nbsp;; <literal>ORDER
BY</literal> est requis dans ce cas. <literal>ROW</literal> et
BY</literal> est requis dans ce cas, et <literal>SKIP LOCKED</literal>
n'est pas autorisé. <literal>ROW</literal> et
<literal>ROWS</literal> ainsi que <literal>FIRST</literal> et
<literal>NEXT</literal> sont des mots qui n'influencent pas les effets de
ces clauses. D'après le standard, la clause <literal>OFFSET</literal> doit
Expand Down

0 comments on commit c269585

Please sign in to comment.