Skip to content

Commit

Permalink
traduction 9.5 pgstattuple.xml
Browse files Browse the repository at this point in the history
  • Loading branch information
edelamusse authored and gleu committed Feb 15, 2016
1 parent 329dcf0 commit fb0ed70
Showing 1 changed file with 42 additions and 38 deletions.
80 changes: 42 additions & 38 deletions postgresql/pgstattuple.xml
Original file line number Diff line number Diff line change
Expand Up @@ -375,10 +375,11 @@ pending_tuples | 0

<listitem>
<para>
<function>pgstattuple_approx</function> is a faster alternative to
<function>pgstattuple</function> that returns approximate results.
The argument is the target relation's OID.
For example:
<function>pgstattuple_approx</function> est une alternative
plus rapide à <function>pgstattuple</function> qui retourne des
résultats estimés.
L'argument est l'OID de la relation visée.
Par exemple:
<programlisting>
test=> SELECT * FROM pgstattuple_approx('pg_catalog.pg_proc'::regclass);
-[ RECORD 1 ]--------+-------
Expand All @@ -393,41 +394,44 @@ dead_tuple_percent | 0
approx_free_space | 11996
approx_free_percent | 2.09
</programlisting>
The output columns are described in <xref linkend="pgstatapprox-columns"/>.
Les colonnes en sortie sont décrites dans <xref linkend="pgstatapprox-columns"/>.
</para>

<para>
Whereas <function>pgstattuple</function> always performs a
full-table scan and returns an exact count of live and dead tuples
(and their sizes) and free space, <function>pgstattuple_approx</function>
tries to avoid the full-table scan and returns exact dead tuple
statistics along with an approximation of the number and
size of live tuples and free space.
Alors que <function>pgstattuple</function> effectue toujours un
parcours séquentiel complet de la table et renvoi un décompte
exact des lignes vivantes et supprimées (et de leur taille) ainsi
que de l'espace libre, <function>pgstattuple_approx</function> essai
d'éviter un parcours séquentiel complet et retourne un décompte
exact des lignes supprimées avec une approximation du nombre de
lignes et de la taille des lignes vivantes et de l'espace libre.
</para>

<para>
It does this by skipping pages that have only visible tuples
according to the visibility map (if a page has the corresponding VM
bit set, then it is assumed to contain no dead tuples). For such
pages, it derives the free space value from the free space map, and
assumes that the rest of the space on the page is taken up by live
tuples.
Il réalise ceci en sautant les pages qui n'ont que des lignes
visibles selon la carte de visibilité (si une page a son bit
positionné dans la carte de visibilité elle est considérée
comme ne possédant pas de lignes supprimées). Pour ces pages il
déduit l'espace libre correspondant à partir de la carte des
espaces libres, et suppose que le reste de la page est occupé
par des lignes vivantes.
</para>

<para>
For pages that cannot be skipped, it scans each tuple, recording its
presence and size in the appropriate counters, and adding up the
free space on the page. At the end, it estimates the total number of
live tuples based on the number of pages and tuples scanned (in the
same way that VACUUM estimates pg_class.reltuples).
Pour les pages qui ne sont pas sautées, il balaie chaque ligne,
en enregistrant son existence et sa taille dans les compteurs
correspondants, et ajoute l'espace libre de la page. À la fin,
il estime le nombre de lignes vivantes en se basant sur le nombre
de pages et de lignes visitées (de la même manière que VACUUM
estime pg_class.reltuples).
</para>

<table id="pgstatapprox-columns">
<title><function>pgstattuple_approx</function> Output Columns</title>
<title><function>pgstattuple_approx</function> Colonnes en sortie</title>
<tgroup cols="3">
<thead>
<row>
<entry>Column</entry>
<entry>Colonne</entry>
<entry>Type</entry>
<entry>Description</entry>
</row>
Expand All @@ -437,63 +441,63 @@ approx_free_percent | 2.09
<row>
<entry><structfield>table_len</structfield></entry>
<entry><type>bigint</type></entry>
<entry>Physical relation length in bytes (exact)</entry>
<entry>Longueur physique de la relation en octets (exact)</entry>
</row>
<row>
<entry><structfield>scanned_percent</structfield></entry>
<entry><type>float8</type></entry>
<entry>Percentage of table scanned</entry>
<entry>Pourcentage de la table visité</entry>
</row>
<row>
<entry><structfield>approx_tuple_count</structfield></entry>
<entry><type>bigint</type></entry>
<entry>Number of live tuples (estimated)</entry>
<entry>Nombre de lignes vivantes (estimé)</entry>
</row>
<row>
<entry><structfield>approx_tuple_len</structfield></entry>
<entry><type>bigint</type></entry>
<entry>Total length of live tuples in bytes (estimated)</entry>
<entry>Longueur totale des lignes vivantes en octets (estimé)</entry>
</row>
<row>
<entry><structfield>approx_tuple_percent</structfield></entry>
<entry><type>float8</type></entry>
<entry>Percentage of live tuples</entry>
<entry>Pourcentage des lignes vivantes</entry>
</row>
<row>
<entry><structfield>dead_tuple_count</structfield></entry>
<entry><type>bigint</type></entry>
<entry>Number of dead tuples (exact)</entry>
<entry>Nombre de lignes mortes (exact)</entry>
</row>
<row>
<entry><structfield>dead_tuple_len</structfield></entry>
<entry><type>bigint</type></entry>
<entry>Total length of dead tuples in bytes (exact)</entry>
<entry>Longueur totale des lignes mortes en octets (exact)</entry>
</row>
<row>
<entry><structfield>dead_tuple_percent</structfield></entry>
<entry><type>float8</type></entry>
<entry>Percentage of dead tuples</entry>
<entry>Pourcentage des lignes mortes</entry>
</row>
<row>
<entry><structfield>approx_free_space</structfield></entry>
<entry><type>bigint</type></entry>
<entry>Total free space in bytes (estimated)</entry>
<entry>Espace libre total en octets (estimé)</entry>
</row>
<row>
<entry><structfield>approx_free_percent</structfield></entry>
<entry><type>float8</type></entry>
<entry>Percentage of free space</entry>
<entry>Pourcentage de l'espace libre</entry>
</row>

</tbody>
</tgroup>
</table>

<para>
In the above output, the free space figures may not match the
<function>pgstattuple</function> output exactly, because the free
space map gives us an exact figure, but is not guaranteed to be
accurate to the byte.
Dans la sortie ci-dessus, l'espace libre indiqué
peut ne pas correspondre exactement à la sortie de
<function>pgstattuple</function> car la carte des espaces libres
donne un chiffre exact mais pas à l'octet près.
</para>

</listitem>
Expand Down

0 comments on commit fb0ed70

Please sign in to comment.