Traduction v12 de spgist.xml

postgresql/spgist.xml

@@ -74,7 +74,7 @@
       <entry>Nom</entry>
       <entry>Type de données indexé</entry>
       <entry>Opérateurs indexables</entry>
-      <entry>Ordering Operators</entry>
+      <entry>Opérateurs d'ordre</entry>
      </row>
     </thead>
     <tbody>
@@ -216,10 +216,11 @@
   </para>
 
  <para>
-  The <literal>quad_point_ops</literal>, <literal>kd_point_ops</literal> and
-  <literal>poly_ops</literal> operator classes support the <literal>&lt;-&gt;</literal>
-  ordering operator, which enables the k-nearest neighbor (<literal>k-NN</literal>)
-  search over indexed point or polygon datasets.
+  Les classes d'opérateur <literal>quad_point_ops</literal>,
+  <literal>kd_point_ops</literal> et <literal>poly_ops</literal> supportent
+  l'ordre d'opérateur <literal>&lt;-&gt;</literal>, qui active la recherche de
+  type voisin-le-plus-proche (<literal>k-NN</literal>) sur des ensembles de
+  données composés de point ou polygon.
  </para>
 
  </sect1>
@@ -672,10 +673,10 @@ CREATE FUNCTION ma_suite_de_n&oelig;uds(internal, internal) RETURNS void ...
 typedef struct spgInnerConsistentIn
 {
     ScanKey     scankeys;       /* tableau d'opérateurs et de valeurs de comparaison */
-    ScanKey     orderbys;       /* array of ordering operators and comparison
-                                 * values */
-    int         nkeys;          /* length of scankeys array */
-    int         norderbys;      /* length of orderbys array */
+    ScanKey     orderbys;       /* tableau d'opérateurs de tri et comparaison */
+                                 * de valeur */
+    int         nkeys;          /* taille du tableau scankeys */
+    int         norderbys;      /* taille du tableau orderbys */
 
     Datum       reconstructedValue;     /* valeur reconstruite au niveau parent */
     MemoryContext traversalMemoryContext;   /* placer les nouvelles valeurs ici */
@@ -689,7 +690,7 @@ typedef struct spgInnerConsistentIn
     int         nNodes;         /* nombre de n&oelig;uds dans la ligne intermédiaire */
     Datum      *nodeLabels;     /* labels du n&oelig;ud (NULL si pas de labels) */
     void      **traversalValues;        /* valeurs traverses spécifiques de la classe d'opérateur */
-    double    **distances;              /* associated distances */
+    double    **distances;              /* distances associées */
 } spgInnerConsistentIn;
 
 typedef struct spgInnerConsistentOut
@@ -710,8 +711,8 @@ typedef struct spgInnerConsistentOut
       de chaque entrée de tableau, qui fournissent respectivement l'opérateur indexé et la valeur de comparaison.
       En particulier, il n'est pas nécessaire de vérifier si <structfield>sk_flags</structfield> est NULL
       car le moteur de SP-GiST aura complété cette valeur.
-      The array <structfield>orderbys</structfield>, of length <structfield>norderbys</structfield>,
-      describes ordering operators (if any) in the same manner.
+      Le t ableau <structfield>orderbys</structfield>, de longueur <structfield>norderbys</structfield>,
+      décrit les opérateurs de tri (s'il y en a) de la même manière.
       <structfield>reconstructedValue</structfield> est la valeur reconstruite pour la ligne parent.
       La valeur est <literal>(Datum) 0</literal> au niveau le plus haut ou si la fonction
       <function>inner_consistent</function> ne fournit pas de valeur pour le
@@ -750,10 +751,10 @@ typedef struct spgInnerConsistentOut
       <structname>spgConfigOut</structname>.<structfield>leafType</structfield>
       reconstruites pour chaque n&oelig;ud enfant à visiter. Sinon, laisser
       <structfield>reconstructedValues</structfield> à la valeur NULL.
-      If ordered search is performed, set <structfield>distances</structfield>
-      to an array of distance values according to <structfield>orderbys</structfield>
-      array (nodes with lowest distances will be processed first).  Leave it
-      NULL otherwise.
+      Si une recherche triée est exécutée, initialise <structfield>distances</structfield>
+      à un tableau de valeurs de distance suivant le tableau <structfield>orderbys</structfield>
+      (les nœuds avec les plus petites distances seront traitées en premier).
+      Laisse NULL sinon.
       S'il est souhaitable de passer les informations supplémentaires hors
       bande (<quote>valeurs traverses</quote>) pour diminuer les niveaux de
       l'arbre de recherche, initialiser
@@ -795,10 +796,10 @@ CREATE FUNCTION ma_fonction_leaf_consistent(internal, internal) RETURNS bool ...
 typedef struct spgLeafConsistentIn
 {
     ScanKey     scankeys;       /* tableau d'opérateurs et de valeurs de comparaison */
-    ScanKey     orderbys;       /* array of ordering operators and comparison
-                                 * values */
-    int         nkeys;          /* length of scankeys array */
-    int         norderbys;      /* length of orderbys array */
+    ScanKey     orderbys;       /* tableau d'opérateurs de tri et comapraison */
+                                 * de valeurs */
+    int         nkeys;          /* taille du tableau scankeys */
+    int         norderbys;      /* taille du tableau orderbys */
 
     Datum       reconstructedValue;     /* valeur reconstruite au parent */
     void       *traversalValue; /* valeur traverse spécifique à la classe d'opérateur */
@@ -812,9 +813,9 @@ typedef struct spgLeafConsistentOut
 {
     Datum       leafValue;      /* données originales reconstruites, le cas échéant */
     bool        recheck;        /* définir à true si l'opérateur doit être revérifié */
-    Datum       leafValue;        /* reconstructed original data, if any */
-    bool        recheck;          /* set true if operator must be rechecked */
-    bool        recheckDistances; /* set true if distances must be rechecked */
+    Datum       leafValue;        /* valeur d'origine reconstruite, le cas échéant */
+    bool        recheck;          /* positionné à true si l'opérateur doit être revérifié */
+    bool        recheckDistances; /* positionné à true si les distances doivent être revérifiées */
     double     *distances;        /* associated distances */
 } spgLeafConsistentOut;
       </programlisting>
@@ -829,8 +830,8 @@ typedef struct spgLeafConsistentOut
       En particulier, il n'est pas nécessaire de vérifier <structfield>sk_flags</structfield> pour
       savoir que la valeur de comparaison est NULL car le code du c&oelig;ur de SP-GiST filtre
       ces conditions.
-      The array <structfield>orderbys</structfield>, of length <structfield>norderbys</structfield>,
-      describes the ordering operators in the same manner.
+      Le tableau <structfield>orderbys</structfield>, de taille <structfield>norderbys</structfield>,
+      décrit les opérateurs de tri de la même manière.
       <structfield>reconstructedValue</structfield> est la valeur reconstruite pour la ligne parent&nbsp;;
       Il s'agit de <literal>(Datum) 0</literal> au niveau racine ou si la fonction
       <function>inner_consistent</function> ne fournit pas de valeur au niveau parent.
@@ -859,12 +860,13 @@ typedef struct spgLeafConsistentOut
       <structfield>recheck</structfield> peut être défini à <literal>true</literal> si la correspondance
       est incertaine et ainsi l'opérateur doit être réappliqué à la pile de ligne courante
       pour vérifier la correspondance.
-      If ordered search is performed, set <structfield>distances</structfield>
-      to an array of distance values according to <structfield>orderbys</structfield>
-      array.  Leave it NULL otherwise.  If at least one of returned distances
-      is not exact, set <structfield>recheckDistances</structfield> to true.
-      In this case, the executor will calculate the exact distances after
-      fetching the tuple from the heap, and will reorder the tuples if needed.
+      Si une recherche triée est effectuée, positionne <structfield>distances</structfield>
+      à un tableau de distance uivant le tableau <structfield>orderbys</structfield>
+      Laisse NULL sinon. Si au moins une des distances retournées n'est pas
+      exacte, positionne <structfield>recheckDistances</structfield> à true.
+      Dans ce cas, l'exécuteur recalcuelra la distance exacte après avoir
+      récupéré toutes les lignes de la table, et réordonnera les lignes si
+      besoin.
      </para>
     </listitem>
    </varlistentry>