Skip to content

Commit

Permalink
Traduction v15 pgwalinspect
Browse files Browse the repository at this point in the history
  • Loading branch information
@gleu
Thibaud W authored and gleu committed Jul 10, 2022
1 parent ba0cb85 commit aaf6bbd
Showing 1 changed file with 51 additions and 51 deletions.
102 changes: 51 additions & 51 deletions postgresql/pgwalinspect.xml
View file
Original file line number Diff line number Diff line change
Expand Up @@ -9,47 +9,48 @@
</indexterm>

<para>
The <filename>pg_walinspect</filename> module provides SQL functions that
allow you to inspect the contents of write-ahead log of
a running <productname>PostgreSQL</productname> database cluster at a low
level, which is useful for debugging or analytical or reporting or
educational purposes. It is similar to <xref linkend="pgwaldump"/>, but
accessible through SQL rather than a separate utility.
Le module <filename>pg_walinspect</filename> fournit des fonctions SQL qui
vous permettent d'inspecter, à un bas niveau, le contenu des journaux de
transactions d'une instance <productname>PostgreSQL</productname> en cours
d'exécution, ce qui est utile pour le débogage, l'analyse, la création de
rapports ou à des fins pédagogiques. Il est similaire à <xref linkend="pgwaldump"/>,
mais est accessible via SQL plutôt que via un utilitaire séparé.
</para>

<para>
All the functions of this module will provide the WAL information using the
current server's timeline ID.
Toutes les fonctions de ce module fourniront des informations sur les WAL
utilisant l'ID de la timeline actuelle du serveur.
</para>

<para>
All the functions of this module will try to find the first valid WAL record
that is at or after the given <replaceable>in_lsn</replaceable> or
<replaceable>start_lsn</replaceable> and will emit error if no such record
is available. Similarly, the <replaceable>end_lsn</replaceable> must be
available, and if it falls in the middle of a record, the entire record must
be available.
Toutes les fonctions de ce module essaieront de trouver le premier
enregistrement WAL valide qui est situé à l'endroit ou après
<replaceable>in_lsn</replaceable> ou <replaceable>start_lsn</replaceable>
donné et émettra une erreur si un tel enregistrement n'est pas présent.
De même, <replaceable>end_lsn</replaceable> doit être présent, et s'il
tombe au milieu d'un enregistrement, l'intégralité de l'enregistrement doit
être disponible.
</para>

<note>
<para>
Some functions, such as <function><link
Certaines fonctions, telles que <function><link
linkend="pg-logical-emit-message">pg_logical_emit_message</link></function>,
return the LSN <emphasis>after</emphasis> the record just
inserted. Therefore, if you pass that LSN as
<replaceable>in_lsn</replaceable> or <replaceable>start_lsn</replaceable>
to one of these functions, it will return the <emphasis>next</emphasis>
record.
renvoient le LSN <emphasis>après</emphasis> l'enregistrement qui vient d'être
inséré. Par conséquent, si vous transmettez ce LSN comme <replaceable>in_lsn</replaceable>
ou <replaceable>start_lsn</replaceable> à l'une de ces fonctions, elle
renverra l'enregistrement <emphasis>suivant</emphasis>.
</para>
</note>
<para>
By default, use of these functions is restricted to superusers and members of
the <literal>pg_read_server_files</literal> role. Access may be granted by
superusers to others using <command>GRANT</command>.
Par défaut, l'utilisation de ces fonctions est réservée aux super-utilisateurs
et aux membres du rôle <literal>pg_read_server_files</literal>. L'accès peut
être accordé par des super-utilisateurs à d'autres utilisateurs grâce à la
commande <command>GRANT</command>.
</para>

<sect2>
<title>General Functions</title>
<title>Fonctions générales</title>

<variablelist>
<varlistentry>
Expand All @@ -72,9 +73,10 @@

<listitem>
<para>
Gets WAL record information of a given LSN. If the given LSN isn't
at the start of a WAL record, it gives the information of the next
available valid WAL record; or an error if no such record is found.
Obtient les informations d'enregistrement WAL pour un LSN donné. Si le
LSN fourni n'est pas au début d'un enregistrement WAL, elle retourne les
informations du prochain enregistrement WAL valide disponible&nbsp;;
ou une erreur si aucun enregistrement de ce type n'est trouvé.
</para>
</listitem>
</varlistentry>
Expand All @@ -101,12 +103,12 @@

<listitem>
<para>
Gets information of all the valid WAL records between
<replaceable>start_lsn</replaceable> and <replaceable>end_lsn</replaceable>.
Returns one row per WAL record. If <replaceable>start_lsn</replaceable>
or <replaceable>end_lsn</replaceable> are not yet available, the
function will raise an error. For example, usage of the function is as
follows:
Obtient des informations sur tous les enregistrements WAL valides entre
<replaceable>start_lsn</replaceable> et <replaceable>end_lsn</replaceable>.
Renvoie une ligne par enregistrement WAL. Si <replaceable>start_lsn</replaceable>
ou <replaceable>end_lsn</replaceable> ne sont pas encore disponibles, la
fonction renvoie une erreur. Exemple d'utilisation de la fonction :

<screen>
postgres=# select start_lsn, end_lsn, prev_lsn, xid, resource_manager, record_type, record_length, main_data_length, fpi_length, description from pg_get_wal_records_info('0/14F9A30', '0/15011D7');
start_lsn | end_lsn | prev_lsn | xid | resource_manager | record_type | record_length | main_data_length | fpi_length | description
Expand Down Expand Up @@ -150,9 +152,9 @@ postgres=# select start_lsn, end_lsn, prev_lsn, xid, resource_manager, record_ty

<listitem>
<para>
This function is same as <function>pg_get_wal_records_info()</function>
except that it gets information of all the valid WAL records from
<replaceable>start_lsn</replaceable> till the end of WAL.
Cette fonction est identique à <function>pg_get_wal_records_info()</function>
sauf qu'elle obtient des informations sur tous les enregistrements WAL
valides depuis <replaceable>start_lsn</replaceable> jusqu'à la fin du WAL.
</para>
</listitem>
</varlistentry>
Expand All @@ -178,16 +180,14 @@ postgres=# select start_lsn, end_lsn, prev_lsn, xid, resource_manager, record_ty

<listitem>
<para>
Gets statistics of all the valid WAL records between
<replaceable>start_lsn</replaceable> and
<replaceable>end_lsn</replaceable>. By default, it returns one row per
<replaceable>resource_manager</replaceable> type. When
<replaceable>per_record</replaceable> is set to <literal>true</literal>,
it returns one row per <replaceable>record_type</replaceable>.
If <replaceable>start_lsn</replaceable>
or <replaceable>end_lsn</replaceable> are not yet available, the
function will raise an error. For example, usage of the function is as
follows:
Récupère les statistiques de tous les enregistrements WAL valides entre
<replaceable>start_lsn</replaceable> et <replaceable>end_lsn</replaceable>.
Par défaut, elle renvoie une ligne par type <replaceable>resource_manager</replaceable>.
Lorsque <replaceable>per_record</replaceable> est défini sur <literal>true</literal>,
elle renvoie une ligne par <replaceable>record_type</replaceable>.
Si <replaceable>start_lsn</replaceable> ou <replaceable>end_lsn</replaceable>
ne sont pas encore disponibles, la fonction retourne une erreur.
Exemple d'utilisation de la fonction :
<screen>
postgres=# select * from pg_get_wal_stats('0/12FBA30', '0/15011D7') where count > 0;
resource_manager/record_type | count | count_percentage | record_size | record_size_percentage | fpi_size | fpi_size_percentage | combined_size | combined_size_percentage
Expand All @@ -203,7 +203,7 @@ postgres=# select * from pg_get_wal_stats('0/12FBA30', '0/15011D7') where count
(8 rows)
</screen>

With <replaceable>per_record</replaceable> passed as <literal>true</literal>:
Avec <replaceable>per_record</replaceable> mis à <literal>true</literal> :

<screen>
postgres=# select * from pg_get_wal_stats('0/14AFC30', '0/15011D7', true) where count > 0;
Expand Down Expand Up @@ -255,9 +255,9 @@ postgres=# select * from pg_get_wal_stats('0/14AFC30', '0/15011D7', true) where

<listitem>
<para>
This function is same as <function>pg_get_wal_stats()</function> except
that it gets statistics of all the valid WAL records from
<replaceable>start_lsn</replaceable> till end of WAL.
Cette fonction est identique à <function>pg_get_wal_stats()</function>
sauf qu'elle obtient les statistiques de tous les enregistrements WAL
valides depuis <replaceable>start_lsn</replaceable> jusqu'à la fin du WAL.
</para>
</listitem>
</varlistentry>
Expand All @@ -266,7 +266,7 @@ postgres=# select * from pg_get_wal_stats('0/14AFC30', '0/15011D7', true) where
</sect2>

<sect2>
<title>Author</title>
<title>Auteur</title>

<para>
Bharath Rupireddy <email>bharath.rupireddyforpostgres@gmail.com</email>
Expand Down

0 comments on commit aaf6bbd

Please sign in to comment.