Traduction v11 de fdwhandler.xml

postgresql/fdwhandler.xml

@@ -248,10 +248,11 @@ GetForeignUpperPaths(PlannerInfo *root,
      <literal>output_rel</literal> est la relation supérieure devant recevoir
      les chemins représentation le traitement de cette étape, et
      <literal>input_rel</literal> est la relation représentant la source de
-     cette étape. The <literal>extra</literal> parameter provides additional details,
-     currently, it is set only for <literal>UPPERREL_PARTIAL_GROUP_AGG</literal>
-     or <literal>UPPERREL_GROUP_AGG</literal>, in which case it points to a
-     <literal>GroupPathExtraData</literal> structure.
+     cette étape. Le paramètre <literal>extra</literal> des détails
+     supplémentaires, pour le moment, il est uniquement positionné pour
+     <literal>UPPERREL_PARTIAL_GROUP_AGG</literal> ou
+     <literal>UPPERREL_GROUP_AGG</literal>, auquel cas il pointe vers une
+     structure <literal>GroupPathExtraData</literal>.
      (Notez que les chemins <structname>ForeignPath</structname>
      ajoutés à <literal>output_rel</literal> n'auront typiquement pas de
      dépendances directes avec les chemins de <literal>input_rel</literal> car
@@ -492,7 +493,7 @@ AddForeignUpdateTargets (Query *parsetree,
    </para>
 
    <para>
-    Si le pointeur <function>AddForeignUpdateTargets</function> est initialisée
+    Si le pointeur <function>AddForeignUpdateTargets</function> est initialisé
     à <literal>NULL</literal>, aucune expression cible supplémentaire ne sera
     ajoutée.
     (Ceci rend impossible l'implémentation des opérations
@@ -538,7 +539,7 @@ PlanForeignModify (PlannerInfo *root,
    </para>
 
    <para>
-    Si le pointeur <function>PlanForeignModify</function> est initialisée à
+    Si le pointeur <function>PlanForeignModify</function> est initialisé à
     <literal>NULL</literal>, aucune action supplémentaire n'est réalisée au
     moment de la planification, et la liste <literal>fdw_private</literal>
     renvoyée par <function>BeginForeignModify</function> vaudra NIL.
@@ -691,7 +692,7 @@ ExecForeignUpdate (EState *estate,
    </para>
 
    <para>
-    Si le pointeur <function>ExecForeignUpdate</function> est initialisée à
+    Si le pointeur <function>ExecForeignUpdate</function> est initialisé à
     <literal>NULL</literal>, les tentatives de mise à jour de la table
     distante échoueront avec un message d'erreur.
    </para>
@@ -763,11 +764,13 @@ EndForeignModify (EState *estate,
     </para>
 
     <para>
-     Tuples inserted into a partitioned table by <command>INSERT</command> or
-     <command>COPY FROM</command> are routed to partitions.  If an FDW
-     supports routable foreign-table partitions, it should also provide the
-     following callback functions.  These functions are also called when
-     <command>COPY FROM</command> is executed on a foreign table.
+     Les lignes insérées dans une table partitionnée à l'aide d'
+     <command>INSERT</command> ou <command>COPY FROM</command> sont redirigées
+     vers les partitions.  Si un FDW supporte la redirection des des lines pour
+     les partitions déclarées comme table distantes, il devrait également
+     fournir les fonctions de callback suivantes.  Ces fonctions sont également
+     appelées quand <command>COPY FROM</command> est exécuté sur une table
+     distante.
     </para>
 
     <para>
@@ -777,38 +780,42 @@ BeginForeignInsert(ModifyTableState *mtstate,
                    ResultRelInfo *rinfo);
 </programlisting>
 
-     Begin executing an insert operation on a foreign table.  This routine is
-     called right before the first tuple is inserted into the foreign table
-     in both cases when it is the partition chosen for tuple routing and the
-     target specified in a <command>COPY FROM</command> command.  It should
-     perform any initialization needed prior to the actual insertion.
-     Subsequently, <function>ExecForeignInsert</function> will be called for
-     each tuple to be inserted into the foreign table.
+     Débute l'exécution d'une opération d'insertion sur une table distante.
+     Cette routine est appelée juste avant que la première ligne soit insérée
+     dans la table distante quand il s'agit de la partition choisie par la
+     redirection de ligne ou quand il s'agit de la la cible spécifiée dans
+     une commande <command>COPY FROM</command>.  Elle devrait effectuer toute
+     initialisation nécessaire avant l'insertion elle-même.  Ensuite,
+     <function>ExecForeignInsert</function> sera appelée pour chaque ligne
+     devant être insérée dans la table distante.
     </para>
 
     <para>
-     <literal>mtstate</literal> is the overall state of the
-     <structname>ModifyTable</structname> plan node being executed; global data about
-     the plan and execution state is available via this structure.
-     <literal>rinfo</literal> is the <structname>ResultRelInfo</structname> struct describing
-     the target foreign table.  (The <structfield>ri_FdwState</structfield> field of
-     <structname>ResultRelInfo</structname> is available for the FDW to store any
-     private state it needs for this operation.)
+     <literal>mtstate</literal> est l'état général du n&oelig;ud de plan
+     <structname>ModifyTable</structname> en cours d'exécution; les données
+     globales sur le plan et l'état d'exécution sont disponible via cette
+     structure.
+     <literal>rinfo</literal> est la structure
+     <structname>ResultRelInfo</structname> décrivant la table distante cible.
+     (Le champ <structfield>ri_FdwState</structfield> de
+     <structname>ResultRelInfo</structname> est disponible pour que le FDW)
+     enregistre tout état privé dont il aurait besoin pour réaliser cette
+     opération.)
     </para>
 
     <para>
-     When this is called by a <command>COPY FROM</command> command, the
-     plan-related global data in <literal>mtstate</literal> is not provided
-     and the <literal>planSlot</literal> parameter of
-     <function>ExecForeignInsert</function> subsequently called for each
-     inserted tuple is <literal>NULL</literal>, whether the foreign table is
-     the partition chosen for tuple routing or the target specified in the
-     command.
+     Quand elle est appelée par une commande <command>COPY FROM</command>, les
+     données globales liées au plan contenue dans <literal>mtstate</literal>
+     ne sont pas fournies et le paramètre <literal>planSlot</literal> de
+     <function>ExecForeignInsert</function> appelée par la suite pour chaque
+     ligne insérée vaut <literal>NULL</literal>, que la table distante soit la
+     partition choisie par la redirection de ligne ou que cela soit la cible
+     spécifiée dans la commande.
     </para>
 
     <para>
-     If the <function>BeginForeignInsert</function> pointer is set to
-     <literal>NULL</literal>, no action is taken for the initialization.
+     Si le pointeur <function>BeginForeignInsert</function> est initialisé à
+     <literal>NULL</literal>, aucune action n'est faite pour l'initialisation.
     </para>
 
     <para>
@@ -818,14 +825,16 @@ EndForeignInsert(EState *estate,
                  ResultRelInfo *rinfo);
 </programlisting>
 
-     End the insert operation and release resources.  It is normally not important
-     to release palloc'd memory, but for example open files and connections
-     to remote servers should be cleaned up.
+     Termine l'opération d'insertion et libère les ressources.  Il n'est
+     habituellement pas nécessaire de libérer la mémoire allouée via palloc.
+     Par contre, les fichiers ouverts et les connexions aux serveurs distants
+     doivent être libétés par exemple.
     </para>
 
     <para>
-     If the <function>EndForeignInsert</function> pointer is set to
-     <literal>NULL</literal>, no action is taken for the termination.
+     Si le pointeur <function>EndForeignInsert</function> est initialisé à
+     <literal>NULL</literal>, aucune action n'est faite pour la fin de
+     l'opération d'insertion.
    </para>
 
    <para>
@@ -1512,14 +1521,16 @@ List *
 ReparameterizeForeignPathByChild(PlannerInfo *root, List *fdw_private,
                                  RelOptInfo *child_rel);
 </programlisting>
-    This function is called while converting a path parameterized by the
-    top-most parent of the given child relation <literal>child_rel</literal> to be
-    parameterized by the child relation. The function is used to reparameterize
-    any paths or translate any expression nodes saved in the given
-    <literal>fdw_private</literal> member of a <structname>ForeignPath</structname>. The
-    callback may use <literal>reparameterize_path_by_child</literal>,
-    <literal>adjust_appendrel_attrs</literal> or
-    <literal>adjust_appendrel_attrs_multilevel</literal> as required.
+    Cette fonction est appelée lors de la conversion d'un chemin paramétré par
+    le plus haut parent de la relation enfant <literal>child_rel</literal>
+    spécifiée devant être paramétrée avec la relation enfant.  Cette fonction
+    est utilisée pour reparamétrer n'importe quel chemin ou traduire n'importe
+    quel n&oelig;ud d'expression enregistré dans le membre
+    <literal>fdw_private</literal> du <structname>ForeignPath</structname>
+    spécifié.  Le callback peut utiliser
+    <literal>reparameterize_path_by_child</literal>,
+    <literal>adjust_appendrel_attrs</literal> ou
+    <literal>adjust_appendrel_attrs_multilevel</literal> selon son besoin.
     </para>
    </sect2>