traduction de pgvisibility.xml

gleu · Jun 17, 2016 · 08d9d8a · 08d9d8a
1 parent 997853e
commit 08d9d8a
Showing 1 changed file with 56 additions and 40 deletions.
diff --git a/postgresql/pgvisibility.xml b/postgresql/pgvisibility.xml
@@ -9,99 +9,115 @@
  </indexterm>
 
  <para>
-  The <filename>pg_visibility</filename> module provides a means for examining the
-  visibility map (VM) and page-level visibility information.
+  Le module <filename>pg_visibility</filename> fourni la possibilité
+  d'examiner la visibility map (VM) et les informations de visibilité
+  au niveau page.
  </para>
 
  <para>
-  These routines return information about three different bits.  The
-  all-visible bit in the visibility map indicates that every tuple on
-  a given page of a relation is visible to every current transaction.  The
-  all-frozen bit in the visibility map indicates that every tuple on the
-  page is frozen; that is, no future vacuum will need to modify the page
-  until such time as a tuple is inserted, updated, deleted, or locked on
-  that page.  The page-level <literal>PD_ALL_VISIBLE</literal> bit has the
-  same meaning as the all-visible bit in the visibility map, but is stored
-  within the data page itself rather than a separate data structure.  These
-  will normally agree, but the page-level bit can sometimes be set while the
-  visibility map bit is clear after a crash recovery; or they can disagree
-  because of a change which occurs after <literal>pg_visibility</literal> examines
-  the visibility map and before it examines the data page.
+  Cette routine renvoie les informations sur trois octets différents.
+  L'octet totalement visible (all-visible) de la visbility map indique
+  que chaque ligne d'une page donnée d'une relation est visible pour
+  toute transaction courante.
+  L'octet totalement figé (all-frozen) de la visibility map indique
+  que chaque ligne de la page est figée; c'est à dire qu'aucun vacuum
+  n'aura besoin de modifier la page tant qu'une ligne n'est pas insérée,
+  mise à jour, supprimée ou verrouillée dans cette page.
+  L'octet de niveau de page <literal>PD_ALL_VISIBLE</literal> a la même
+  signification que l'octet totalement visible de la visibility map, mais
+  il est stocké au sein de la page plutôt que dans une structure de donnée
+  séparée. Ces deux octets seront normalement identiques, mais l'octet de
+  niveau de page peut parfois rester défini pendant que la visibility map
+  est purgée lors de la récupération suite à un crash ; ou ils peuvent
+  être différents suite à un changement survenant après que
+  <literal>pg_visibility</literal> ait examiné la visibility map et avant
+  qu'il ait examiné la page de donnée.
  </para>
 
  <para>
-  Functions which display information about <literal>PG_ALL_VISIBLE</literal>
-  are much more costly than those which only consult the visibility map,
-  because they must read the relation's data blocks rather than only the
-  (much smaller) visibility map.
+  Les fonctions qui affichent les informations concernant
+  <literal>PG_ALL_VISIBLE</literal> sont plus beaucoup plus coûteuses que
+  celles qui consultent uniquement la visibility map, en effet, elles
+  doivent lire les blocs de données des relations plutôt que de ne
+  s'intéresser qu'a la visibility map (qui est bien plus petite)
  </para>
 
  <sect2>
-  <title>Functions</title>
+  <title>Fonctions</title>
 
   <variablelist>
    <varlistentry>
-    <term><function>pg_visibility_map(regclass, blkno bigint, all_visible OUT boolean, all_frozen OUT boolean) returns record</function></term>
+    <term><function>pg_visibility_map(regclass, blkno bigint, all_visible
+    OUT boolean, all_frozen OUT boolean) renvoie un enregistrement
+    </function></term>
     <listitem>
      <para>
-      Returns the all-visible and all-frozen bits in the visibility map for
-      the given block of the given relation.
+      Renvoie tout les octets complétement visibles et complétement figés
+      de la visibility map pour un bloc donné pour une relation donnée.
      </para>
     </listitem>
    </varlistentry>
 
    <varlistentry>
-    <term><function>pg_visibility(regclass, blkno bigint, all_visible OUT boolean, all_frozen OUT boolean, pd_all_visible OUT boolean) returns record</function></term>
+    <term><function>pg_visibility(regclass, blkno bigint, all_visible OUT
+    boolean, all_frozen OUT boolean, pd_all_visible OUT boolean) renvoie
+    un enregistrement</function></term>
     <listitem>
      <para>
-      Returns the all-visible and all-frozen bits in the visibility map for
-      the given block of the given relation, plus the
-      <literal>PD_ALL_VISIBILE</literal> bit for that block.
+      Renvoie tout les octets complétement visibles et complétement figés
+      de la visibility map pour un bloc donné pour une relation donnée
+      ainsi que l'octet <literal>PD_ALL_VISIBLE</literal> pour le bloc.
      </para>
     </listitem>
    </varlistentry>
 
    <varlistentry>
-    <term><function>pg_visibility_map(regclass, blkno OUT bigint, all_visible OUT boolean, all_frozen OUT boolean) returns record</function></term>
+    <term><function>pg_visibility_map(regclass, blkno OUT bigint,
+    all_visible OUT boolean, all_frozen OUT boolean) renvoie
+    un enregistrement</function></term>
     <listitem>
      <para>
-      Returns the all-visible and all-frozen bits in the visibility map for
-      each block the given relation.
+      Renvoie tout les octets complétement visibles et complétement figés
+      de la visibility map pour un bloc donné pour une relation donnée.
      </para>
     </listitem>
    </varlistentry>
 
    <varlistentry>
-    <term><function>pg_visibility(regclass, blkno OUT bigint, all_visible OUT boolean, all_frozen OUT boolean, pd_all_visible OUT boolean) returns record</function></term>
+    <term><function>pg_visibility(regclass, blkno OUT bigint, all_visible
+    OUT boolean, all_frozen OUT boolean, pd_all_visible OUT boolean) renvoie
+    un enregistrement</function></term>
 
     <listitem>
      <para>
-      Returns the all-visible and all-frozen bits in the visibility map for
-      each block the given relation, plus the <literal>PD_ALL_VISIBLE</literal>
-      bit for each block.
+      Renvoie tout les octets complétement visibles et complétement figés
+      de la visibility map pour un bloc donné pour une relation donnée
+      ainsi que l'octet <literal>PD_ALL_VISIBLE</literal> pour le bloc.
      </para>
     </listitem>
    </varlistentry>
 
    <varlistentry>
-    <term><function>pg_visibility_map_summary(regclass, all_visible OUT bigint, all_frozen OUT bigint) returns record</function></term>
+    <term><function>pg_visibility_map_summary(regclass, all_visible OUT
+    bigint, all_frozen OUT bigint) renvoie
+    un enregistrement</function></term>
 
     <listitem>
      <para>
-      Returns the number of all-visible pages and the number of all-frozen
-      pages in the relation according to the visibility map.
-     </para>
+      Renvoie le nombre de pages complétement visible ainsi que le nombre
+      de pages complétement figées de la relation, en concordance avec la
+      visibility map.
     </listitem>
    </varlistentry>
   </variablelist>
 
   <para>
-   By default, these functions are not publicly executable.
+	Par défaut, ces fonctions ne sont pas exécutables par public.
   </para>
  </sect2>
 
  <sect2>
-  <title>Author</title>
+  <title>Auteur</title>
 
   <para>
    Robert Haas <email>rhaas@postgresql.org</email>