Skip to content

Commit

Permalink
Travaux du 2è jour
Browse files Browse the repository at this point in the history
  • Loading branch information
gleu committed Jun 20, 2022
1 parent b11d135 commit f7e4051
Show file tree
Hide file tree
Showing 15 changed files with 392 additions and 390 deletions.
53 changes: 28 additions & 25 deletions postgresql/backup.xml
Original file line number Diff line number Diff line change
Expand Up @@ -668,13 +668,13 @@ pg_restore -d <replaceable class="parameter">nom_base</replaceable> <replaceable
</para>

<para>
Another way to archive is to use a custom archive module as the
<varname>archive_library</varname>. Since such modules are written in
<literal>C</literal>, creating your own may require considerably more effort
than writing a shell command. However, archive modules can be more
performant than archiving via shell, and they will have access to many
useful server resources. For more information about archive modules, see
<xref linkend="archive-modules"/>.
Une autre façon d'archiver est d'utiliser un module d'archivage personnalisé
avec <varname>archive_library</varname>. Comme de tels modules sont écrits
en C, créer son propre module nécessite considérablement plus d'effort que
d'écrire une commande shell. Néanmoins, les modules d'archivage peuvent être
plus performants que l'archivage via le shell, et ils auront accès à un
grand nombre de ressources serveurs utiles. Pour plus d'informations sur
les modules d'archivage, voir <xref linkend="archive-modules"/>.
</para>

<para>
Expand Down Expand Up @@ -702,14 +702,15 @@ pg_restore -d <replaceable class="parameter">nom_base</replaceable> <replaceable
</para>

<para>
If the archive function emits an <literal>ERROR</literal> or
<literal>FATAL</literal>, the archiver process aborts and gets restarted by
the postmaster. If you are archiving via shell command, FATAL is emitted if
the command is terminated by a signal (other than
<systemitem>SIGTERM</systemitem> that is used as part of a server shutdown)
or an error by the shell with an exit status greater than 125 (such as
command not found). In such cases, the failure is not reported in
<xref linkend="pg-stat-archiver-view"/>.
Si la fonction d'archivage émet un message de niveau
<literal>ERROR</literal> ou <literal>FATAL</literal>, le processus
d'archivage quitte, puis est relancé par le processus postmaster. Si vous
archivez via une commande, un message de niveau FATAL est émis si la
commande se termine avec un signal (autre que
<systemitem>SIGTERM</systemitem> qui est utilisé pour l'arrêt du serveur) ou
avec une erreur du shell avec un code de sortie supérieur à 125 (tel que
commande introuvable). Dans ces cas, l'échec n'est pas rapporté dans <xref
linkend="pg-stat-archiver-view"/>.
</para>

<para>
Expand Down Expand Up @@ -941,16 +942,18 @@ pg_restore -d <replaceable class="parameter">nom_base</replaceable> <replaceable
</para>

<para>
Online backups are always started at the beginning of a checkpoint.
By default, <function>pg_backup_start</function> will wait for the next
regularly scheduled checkpoint to complete, which may take a long time (see the
configuration parameters <xref linkend="guc-checkpoint-timeout"/> and
<xref linkend="guc-checkpoint-completion-target"/>). This is
usually preferable as it minimizes the impact on the running system. If you
want to start the backup as soon as possible, pass <literal>true</literal> as
the second parameter to <function>pg_backup_start</function> and it will
request an immediate checkpoint, which will finish as fast as possible using
as much I/O as possible.
Les sauvegardes en ligne sont toujours démarrées au début d'un
checkpoint. Par défaut, <function>pg_backup_start</function> attendra
le prochain checkpoint planifié pour se terminer, ce qui peut prendre un
long moment (voir les paramètres de configuration <xref
linkend="guc-checkpoint-timeout"/> et <xref
linkend="guc-checkpoint-completion-target"/>). C'est généralement
préférable car cela minimise l'impact sur le système en cours
d'exécution. Si vous voulez démarrer la sauvegarde aussi vite que
possible, passez <literal>true</literal> sur le second paramètre de
<function>pg_backup_start</function> et il demandera un checkpoint
immédiat, qui finira aussi rapidement que possible en utilisant autant
de bande passante disque que possible.
</para>
</listitem>

Expand Down
22 changes: 11 additions & 11 deletions postgresql/bki.xml
Original file line number Diff line number Diff line change
Expand Up @@ -447,17 +447,17 @@
</para>

<para>
Objects with OIDs below <symbol>FirstUnpinnedObjectId</symbol> (12000)
are considered <quote>pinned</quote>, preventing them from being
deleted. (There are a small number of exceptions, which are
hard-wired into <function>IsPinnedObject()</function>.)
<application>initdb</application> forces the OID counter up
to <symbol>FirstUnpinnedObjectId</symbol> as soon as it's ready to
create unpinned objects. Thus objects created during the later phases
of <application>initdb</application>, such as objects created while
running the <filename>information_schema.sql</filename> script, will
not be pinned, while all objects known
to <filename>genbki.pl</filename> will be.
Les objets dont l'OID est en-dessous de
<symbol>FirstUnpinnedObjectId</symbol> (12000) sont considérés comme
<quote>fixes</quote>, les empêchant d'être supprimés. (Il existe un petit
nombre d'exceptions, qui sont gérées en dur par la fonction
<function>IsPinnedObject()</function>.) <application>initdb</application>
force le compteur d'OID à <symbol>FirstUnpinnedObjectId</symbol> dès qu'il
est prêt à créer des objets non fixes. De ce fait, les objets créés dans les
phases ultérieures de <application>initdb</application>, comme des objets
créés lors de l'exécution du script
<filename>information_schema.sql</filename>, ne seront pas fixes alors que
tous les objets connus de <filename>genbki.pl</filename> le seront.
</para>

<para>
Expand Down
52 changes: 26 additions & 26 deletions postgresql/datatype.xml
Original file line number Diff line number Diff line change
Expand Up @@ -578,48 +578,48 @@
<para>
Si l'échelle d'une valeur à stocker est supérieure à celle de la colonne,
le système arrondit la valeur au nombre de décimales indiqué pour la
colonne. Si le nombre de chiffres à gauche du point décimal est supérieur
à la différence entre la précision déclarée et l'échelle déclarée, une
erreur est levée.
For example, a column declared as
colonne. Si le nombre de chiffres à gauche du point décimal est supérieur à
la différence entre la précision déclarée et l'échelle déclarée, une erreur
est levée. Par exemple, une colonne déclarée comme
<programlisting>
NUMERIC(3, 1)
</programlisting>
will round values to 1 decimal place and can store values between
-99.9 and 99.9, inclusive.
voit ses valeurs arrondies à une place décimale et peut enregistrer
des valeurs entre -99,9 et 99,9, valeurs inclues.
</para>

<para>
Beginning in <productname>PostgreSQL</productname> 15, it is allowed
to declare a <type>numeric</type> column with a negative scale. Then
values will be rounded to the left of the decimal point. The
precision still represents the maximum number of non-rounded digits.
Thus, a column declared as
À partir de <productname>PostgreSQL</productname>, il est autorisé de
déclarer une colonne de type <type>numeric</type> avec une échelle
négative. Les valeurs sont alors arrondies à partir de la gauche du point
décimal. La précision représente toujours le nombre maximum de chiffres non
arrondis. De ce fait, une colonne déclarée ainsi
<programlisting>
NUMERIC(2, -3)
</programlisting>
will round values to the nearest thousand and can store values
between -99000 and 99000, inclusive.
It is also allowed to declare a scale larger than the declared
precision. Such a column can only hold fractional values, and it
requires the number of zero digits just to the right of the decimal
point to be at least the declared scale minus the declared precision.
For example, a column declared as
arrondira les valeurs au millier le plus proche et peut enregistre des
valeurs entre -99000 et 99000, values inclues. Il est aussi autorisé de
déclarer une échelle plus grand que la précision déclarée. Une telle
colonne peut seulement contenir des valeurs fractionnelles, et elle
nécessite le nombre de chiffres zéro juste à droite du point décimal pour
être au moins l'échelle déclarée moins la précision déclarée. Par exemple,
une colonne déclarée ainsi
<programlisting>
NUMERIC(3, 5)
</programlisting>
will round values to 5 decimal places and can store values between
-0.00999 and 0.00999, inclusive.
arrondira les valeurs aux 5 places décimales et peut enregistrer des
valeurs comprises entre -0,00999 et 0,00999, valeurs inclues.
</para>

<note>
<para>
<productname>PostgreSQL</productname> permits the scale in a
<type>numeric</type> type declaration to be any value in the range
-1000 to 1000. However, the <acronym>SQL</acronym> standard requires
the scale to be in the range 0 to <replaceable>precision</replaceable>.
Using scales outside that range may not be portable to other database
systems.
<productname>PostgreSQL</productname> permet à l'échelle dans une
déclaration de type <type>numeric</type> d'être toute valeur dans
l'échelle de -1000 à 1000. Néanmoins, le standard <acronym>SQL</acronym>
requiert que l'échelle soit dans l'intervalle 0 à
<replaceable>precision</replaceable>. Utiliser des échelles en dehors de
cet interval peut ne pas autre portable auprès d'autres systèmes de bases
de données.
</para>
</note>

Expand Down
97 changes: 48 additions & 49 deletions postgresql/libpq.xml
Original file line number Diff line number Diff line change
Expand Up @@ -2652,13 +2652,13 @@ const char *PQsslAttribute(const PGconn *conn, const char *attribute_name);
</para>

<para>
As a special case, the <literal>library</literal> attribute may be
queried without an existing connection by passing NULL as the
<literal>conn</literal> argument. The historical behavior was to return
NULL for any attribute when a NULL <literal>conn</literal> was provided;
client programs needing to differentiate between the newer and older
implementations may check the
<literal>LIBPQ_HAS_SSL_LIBRARY_DETECTION</literal> feature macro.
Comme cas particulier, l'attribut <literal>library</literal> peut être
requêté sans connexion existante en passant NULL à l'argument
<literal>conn</literal>. Le comportement historique était de renvoyer
NULL pour tout attribut quand <literal>conn</literal> NULL était
fourni&nbsp;; les programmes clients qui ont besoin de différencier
entrer les implémentations nouvelle et ancienne peuvent vérifier la macro
<literal>LIBPQ_HAS_SSL_LIBRARY_DETECTION</literal>.
</para>
</listitem>
</varlistentry>
Expand Down Expand Up @@ -6869,7 +6869,7 @@ char *PQencryptPassword(const char *passwd, const char *user);
<literal>PG_COPYRES_EVENTS</literal> indique la copie des événements du
résultat source. (Mais toute instance de données associée avec la source
n'est pas copiée.)
The event procedures receive <literal>PGEVT_RESULTCOPY</literal> events.
Les procédures événement reçoivent les événements <literal>PGEVT_RESULTCOPY</literal>.
</para>
</listitem>
</varlistentry>
Expand Down Expand Up @@ -7224,15 +7224,14 @@ size_t PQresultMemorySize(const PGresult *res);
<term><literal>PGEVT_CONNRESET</literal></term>
<listitem>
<para>
L'événement de réinitialisation de connexion est déclenché après un
<xref linkend="libpq-PQreset"/> ou un <function>PQresetPoll</function>. Dans
L'événement de réinitialisation de connexion est déclenché après un <xref
linkend="libpq-PQreset"/> ou un <function>PQresetPoll</function>. Dans
les deux cas, l'événement est seulement déclenché si la ré-initialisation
est réussie.
The return value of the event procedure is ignored
in <productname>PostgreSQL</productname> v15 and later.
With earlier versions, however, it's important to return success
(nonzero) or the connection will be aborted.

est réussie. La valeur de retour de la procédure événement est ignoré
dans les versions 15 et ultérieures de
<productname>PostgreSQL</productname>. Avec les versions précédentes, il
est important de renvoyer le succès (différent de zéro), sinon la
connexion sera annulée.
<synopsis>
typedef struct
{
Expand Down Expand Up @@ -7305,11 +7304,12 @@ size_t PQresultMemorySize(const PGresult *res);
<parameter>conn</parameter> est la connexion utilisée pour générer le
résultat. C'est le moment idéal pour initialiser tout
<literal>instanceData</literal> qui doit être associé avec le résultat.
If an event procedure fails (returns zero), that event
procedure will be ignored for the remaining lifetime of the result;
that is, it will not receive <literal>PGEVT_RESULTCOPY</literal>
or <literal>PGEVT_RESULTDESTROY</literal> events for this result or
results copied from it.
Si une procédure d'événement échoue (renvoie zéro), cet événement de
procédure sera ignoré pour la durée de vie restante du résultat&nbsp;;
autrement dit, il ne recevra pas les événements
<literal>PGEVT_RESULTCOPY</literal> ou
<literal>PGEVT_RESULTDESTROY</literal> pour ce résultat ou les résultats
copiés à partir de lui.
</para>
</listitem>
</varlistentry>
Expand Down Expand Up @@ -7341,12 +7341,12 @@ size_t PQresultMemorySize(const PGresult *res);
destination. Cet événement peut être utilisé pour fournir une copie
complète de <literal>instanceData</literal>, ce que
<literal>PQcopyResult</literal> ne peut pas faire.
If an event
procedure fails (returns zero), that event procedure will be
ignored for the remaining lifetime of the new result; that is, it
will not receive <literal>PGEVT_RESULTCOPY</literal>
or <literal>PGEVT_RESULTDESTROY</literal> events for that result or
results copied from it.
Si une procédure d'événement échoue (renvoie zéro), cet événement de
procédure sera ignoré pour la durée de vie restante du résultat&nbsp;;
autrement dit, il ne recevra pas les événements
<literal>PGEVT_RESULTCOPY</literal> ou
<literal>PGEVT_RESULTDESTROY</literal> pour ce résultat ou les résultats
copiés à partir de lui.
</para>
</listitem>
</varlistentry>
Expand Down Expand Up @@ -8396,32 +8396,31 @@ ldap://ldap.mycompany.com/dc=mycompany,dc=com?description?one?(cn=mydatabase)
</para>

<para>
En mode <literal>verify-full</literal>, le nom de l'hôte est mis
en correspondance avec le ou les attributs <literal>Subject Alternative
Name</literal> (SAN) du certificat, ou avec l'attribut
<literal>Common Name</literal> si aucun SAN de type
<literal>dNSName</literal> n'est présent. Si le nom du
certificat débute avec le caractère étoile (<literal>*</literal>),
l'étoile sera traitée comme un métacaractère qui
correspondra à tous les caractères <emphasis>à l'exception
</emphasis> du point. Cela signifie que le certificat ne pourra pas
correspondre à des sous-domaines. Si la connexion se
fait en utilisant une adresse IP au lieu d'un nom d'hôte, l'adresse
IP sera vérifiée (sans faire de résolution DNS) against SANs of
type <literal>iPAddress</literal> or <literal>dNSName</literal>. If no
<literal>iPAddress</literal> SAN is present and no
matching <literal>dNSName</literal> SAN is present, the host IP address is
matched against the Common Name attribute.
En mode <literal>verify-full</literal>, le nom de l'hôte est mis en
correspondance avec le ou les attributs <literal>Subject Alternative
Name</literal> (SAN) du certificat, ou avec l'attribut <literal>Common
Name</literal> si aucun SAN de type <literal>dNSName</literal> n'est
présent. Si le nom du certificat débute avec le caractère étoile
(<literal>*</literal>), l'étoile sera traitée comme un métacaractère qui
correspondra à tous les caractères <emphasis>à l'exception </emphasis> du
point. Cela signifie que le certificat ne pourra pas correspondre à des
sous-domaines. Si la connexion se fait en utilisant une adresse IP au lieu
d'un nom d'hôte, l'adresse IP sera vérifiée (sans faire de résolution DNS)
avec les SAN de type <literal>iPAddress</literal> ou
<literal>dNSName</literal>. Si aucun SAN <literal>iPAddress</literal> n'est
présent et qu'aucun SAN <literal>dNSName</literal> correspondant n'est
présent, l'adresse IP de l'hôte est vérifié avec l'attribut Common Name.
</para>

<note>
<para>
For backward compatibility with earlier versions of PostgreSQL, the host
IP address is verified in a manner different
from <ulink url="https://tools.ietf.org/html/rfc6125">RFC 6125</ulink>.
The host IP address is always matched against <literal>dNSName</literal>
SANs as well as <literal>iPAddress</literal> SANs, and can be matched
against the Common Name attribute if no relevant SANs exist.
Pour la compatibilité avec les anciennes versions de PostgreSQL, l'adresse
IP de l'hôte est vérifiée d'une façon différente à partir de <ulink
url="https://tools.ietf.org/html/rfc6125">RFC 6125</ulink>. L'adresse IP
de l'hôte est toujours vérifiée avec avec les SAN
<literal>dNSName</literal> ainsi qu'avec les SAN
<literal>iPAddress</literal> et peut être vérifiée avec l'attribut Common
Name si aucun SAN n'existe.
</para>
</note>

Expand Down

0 comments on commit f7e4051

Please sign in to comment.