[Trad] [svn:pgfr] r1129 - traduc/trunk/slony
admin at listes.postgresql.fr
admin at listes.postgresql.fr
Ven 5 Sep 21:59:08 CEST 2008
Author: daamien
Date: 2008-09-05 21:59:08 +0200 (Fri, 05 Sep 2008)
New Revision: 1129
Modified:
traduc/trunk/slony/slonik_ref.xml
Log:
Slony : slonik_ref ( ?\195?\160 relire )
Modified: traduc/trunk/slony/slonik_ref.xml
===================================================================
--- traduc/trunk/slony/slonik_ref.xml 2008-09-05 11:37:44 UTC (rev 1128)
+++ traduc/trunk/slony/slonik_ref.xml 2008-09-05 19:59:08 UTC (rev 1129)
@@ -1685,9 +1685,9 @@
Change l'ensemble de réplication dans lequel se trouve la table. L'ensemble courant et le
nouveau doivent avoir le même noeud origine et les même noeuds abonnés.
- <caution><para> La méthode d'abonnement d'un nouvel ensemble de réplication
- permet de garantir que l'abonnement est complètement effectué sur tous les noeuds
- avant que le tables soient déplacées. Déplacer une table trop tôt vers un nouvel ensemble,
+ <caution><para> La méthode d'abonnement d'un nouvel ensemble de réplication est
+ particulière, vous devez vous assurer l'abonnement est complètement effectué sur tous les noeuds
+ avant de déplacer les tables. Déplacer une table trop tôt vers un nouvel ensemble,
implique que le noeud abonné va essayer d'ajouter la table pendant le processus d'abonnement
de l'ensemble de réplication, ce qui échoue suite à une erreur de clef dupliquée et provoque
l'arrêt de la réplication.</para></caution>
@@ -1745,35 +1745,37 @@
<title>Description</title>
<para>
- Change the set a sequence belongs to. The current set and the new
- set must originate on the same node and subscribed by the same
- nodes.
-
- <caution><para> Due to the way subscribing to new sets works make
- absolutely sure that the subscription of all nodes to the sets
- is completely processed before moving sequences. Moving a sequence too
- early to a new set causes the subscriber to try and add the sequence
- already during the subscription process, which fails with a duplicate
- key error and breaks replication.</para></caution>
+ Change l'ensemble de réplication dans lequel se trouve la séquence.
+ L'ensemble courant et le nouveau doivent avoir le même noeud d'origine
+ et les mêmes noeuds abonnés.
+
+ <caution><para> La méthode d'abonnement à un nouvel ensemble est particulière,
+ vous devez vous assurer que l'abonnement est complètement effectué
+ avant de déplacer les séquences. Déplacer un séquence top tôt peut impliquer
+ une tentative d'ajout de la séquence pendant le processus d'abonnement,
+ ce qui échouera en emettant une erreur à cause d'une clef dupliquée et
+ provoquera l'arrêt de la réplication.</para></caution>
<variablelist>
<varlistentry><term><literal> ORIGIN = ival </literal></term>
- <listitem><para> Origin node for the set. A future version of <application>slonik</application>
- might figure out this information by itself.</para></listitem>
+ <listitem><para> Noeud d'origine de l'ensemble de réplication. Les
+ futures versions de <application>slonik</application>
+ deviner toutes seules cette information.</para></listitem>
</varlistentry>
<varlistentry><term><literal> ID = ival </literal></term>
- <listitem><para> Unique ID of the sequence.</para></listitem>
+ <listitem><para> Identifiant unique de la séquence.</para></listitem>
</varlistentry>
<varlistentry><term><literal> NEW SET = ival </literal></term>
- <listitem><para> Unique ID of the set to which the sequence should be moved.</para></listitem>
+ <listitem><para> Identifiant unique de l'ensemble de réplication dans lequel
+ la séquence doit être déplacée.</para></listitem>
</varlistentry>
</variablelist>
</para>
- <para> This uses &funsetmovesequence;. </para>
+ <para> Cette commande utilise &funsetmovesequence;. </para>
</refsect1>
<refsect1><title>Exemple</title>
<programlisting>
@@ -1801,8 +1803,8 @@
<refnamediv><refname>STORE TRIGGER</refname>
- <refpurpose> Indicate that a trigger should not be disabled by
- &slony1; on a subscriber node
+ <refpurpose> Indique qu'un trigger ne doit pas être désactivé par &slony1;
+sur un noeud abonné. should not be disabled by
</refpurpose></refnamediv>
<refsynopsisdiv>
@@ -1813,45 +1815,45 @@
<refsect1>
<title>Description</title>
- <para> By default, all user defined triggers and constraints are
- disabled on all subscriber nodes while a table is replicated. This
- command can be used to explicitly exclude a trigger from being
- disabled.
-
+ <para> Par défaut, tout les triggers définis par l'utilisateur sont
+désactivés sur tout les noeuds abonnés lorsque la table est répliquée.
+Cette commande peut être utilisée pour empêcher explicititement la désactivation
+d'un trigger.
<variablelist>
<varlistentry><term><literal> TABLE ID = ival </literal></term>
- <listitem><para> The unique, numeric ID number of the table the trigger is defined for.</para></listitem>
+ <listitem><para> L'indentifiant numérique et unique de la table concernée par le trigger.</para></listitem>
</varlistentry>
<varlistentry><term><literal> TRIGGER NAME = 'string' </literal></term>
- <listitem><para> The name of the trigger as it appears in the
- <envar>pg_trigger</envar> system catalog.</para></listitem>
+ <listitem><para> Le nom du trigger tel qu'on le trouve dans le catalogue système
+ <envar>pg_trigger</envar>.</para></listitem>
</varlistentry>
<varlistentry><term><literal> EVENT NODE = ival </literal></term>
- <listitem><para> (Optional) The ID of the node used to create
- the configuration event that tells all existing nodes about the
- special trigger. Default value is 1.</para></listitem>
+ <listitem><para> (Optionel) L'identifiant du noeud utilisé pour
+créer l'événement de configuration qui annonce aux noeuds existants la
+présence d'un trigger spécial. Par défaut, cette valeur est 1.
+ </para></listitem>
</varlistentry>
</variablelist>
</para>
- <note><para> A nifty trick is that you can run <command>STORE
- TRIGGER</command> <emphasis>before the trigger is
- installed;</emphasis> that will not cause any errors. You could
- thus add &slony1;'s handling of the trigger
- <emphasis>before</emphasis> it is installed. That allows you to
- be certain that it becomes active on all nodes immediately upon
- its installation via <xref linkend="stmtddlscript"/>; there is no
- risk of events getting through in between the <command>EXECUTE
- SCRIPT</command> and <command>STORE TRIGGER</command>
- events. </para>
+ <note><para> Une astuce consiste à lancer <command>STORE
+ TRIGGER</command> <emphasis>avant que le trigger soit installé
+ ;</emphasis> ce qui ne provoquera pas d'errreurs. Vous pouvez
+ ainsi définir la gestion d'un trigger par &slony1; r
+ <emphasis>avant</emphasis> qu'il soit installé. Vous êtes alors
+ certain que le trigger est actif sur tous les noeuds immédiatement
+après son installation via <xref linkend="stmtddlscript"/>; il n'y a
+aucun risque de voir un événement passer entre les événements
+ <command>EXECUTE
+ SCRIPT</command> et <command>STORE TRIGGER</command>. </para>
</note>
- <para> This uses &funstoretrigger;. </para>
+ <para> Cette commande utilise &funstoretrigger;. </para>
</refsect1>
- <refsect1><title>Exemple</title>
+ <refsect1><title>Exemple :</title>
<programlisting>
STORE TRIGGER (
TABLE ID = 2,
@@ -1861,16 +1863,17 @@
</refsect1>
<refsect1> <title> Utilisation de verrous </title>
- <para> This operation will need to acquire an exclusive lock on
- the specified table on each node to which it applies in order to
- alter table schemas to add back the trigger, but only breifly. </para>
+ <para> Cette opération pose brièvement un verrou exclusif sur la table spécifiée
+sur chaque noeud auquel elle s'applique, afin de modifier le schéma de la table
+et y ajouter de nouveau le trigger.
+ </para>
</refsect1>
<refsect1> <title> Note de version </title>
<para> Cette commande fut introduite dans &slony1; 1.0 </para>
- <para> In &slony1; version 2.0, this command is removed as
- obsolete because triggers are no longer <quote>messed around
- with</quote> in the system catalogue. </para>
+ <para> Avec &slony1; version 2.0, cette commande est supprimée car
+obsolète, puisque les triggers ne sont plus <quote>trafiqués</quote>
+dans le catalogue système. </para>
</refsect1>
</refentry>
@@ -1881,8 +1884,8 @@
<refnamediv><refname>DROP TRIGGER</refname>
- <refpurpose> Return a trigger to default behavior, where it will
- not fire on subscriber nodes </refpurpose></refnamediv>
+ <refpurpose> Cette commande redonde à un trigger son comportement par défaut :
+c'est à dire qu'il ne se déclenche pas sur les noeuds abonnés. </refpurpose></refnamediv>
<refsynopsisdiv>
<cmdsynopsis>
@@ -1892,30 +1895,33 @@
<refsect1>
<title>Description</title>
- <para> Remove the special handling for the specified trigger.
+ <para> Supprime la gestion particulière du trigger spécifié.
<variablelist>
<varlistentry><term><literal> TABLE ID = ival </literal></term>
- <listitem><para> The unique, numeric ID number of the table the
- trigger is defined for.</para></listitem>
+ <listitem><para> L'identifiant numérique et unique de la table pour laquelle le
+trigger est défini.</para></listitem>
</varlistentry>
<varlistentry><term><literal> TRIGGER NAME = 'string' </literal></term>
-
- <listitem><para> The name of the trigger as it appears in the
- <envar>pg_trigger</envar> system catalog.</para></listitem>
+ <listitem><para> Le nom du trigger tel qu'on le trouve dans le catalogue système
+ <envar>pg_trigger</envar>.</para></listitem>
+
</varlistentry>
<varlistentry><term><literal> EVENT NODE = ival </literal></term>
-
- <listitem><para> (Optional) The ID of the node used to create
- the configuration event that tells all existing nodes about the
- special trigger. Default value is 1.</para></listitem>
-
+
+ <listitem><para> (Optionel) L'identifiant du noeud utilisé pour
+créer l'événement de configuration qui annonce aux noeuds existants la
+présence d'un trigger spécial. Par défaut, cette valeur est 1.
+ </para></listitem>
+
</varlistentry>
+
+ </varlistentry>
</variablelist>
</para>
- <para> This uses &fundroptrigger;. </para>
+ <para> Cette commande utilise &fundroptrigger;. </para>
</refsect1>
<refsect1><title>Exemple</title>
<programlisting>
@@ -1927,17 +1933,17 @@
</refsect1>
<refsect1> <title> Utilisation de verrous </title>
- <para> This operation will need to acquire an exclusive lock on
- the specified table on each node to which it applies in order to
- alter table schemas to remove the trigger. </para>
+ <para> Cette opération pose brièvement un verrou exclusif sur la table spécifiée
+sur chaque noeud auquel elle s'applique, afin de modifier le schéma de la table
+et y ajouter de nouveau le trigger.
+ </para>
</refsect1>
<refsect1> <title> Note de version </title>
<para> Cette commande fut introduite dans &slony1; 1.0 </para>
- <para> In &slony1; version 2.0, this command is removed as
- obsolete because triggers are no longer <quote>messed around
- with</quote> in the system catalogue. </para>
-
+ <para> Avec &slony1; version 2.0, cette commande est supprimée car
+obsolète, puisque les triggers ne sont plus <quote>trafiqués</quote>
+dans le catalogue système. </para>
</refsect1>
</refentry>
@@ -1947,7 +1953,7 @@
<refnamediv><refname>SUBSCRIBE SET</refname>
- <refpurpose> Start replication of &slony1; set </refpurpose></refnamediv>
+ <refpurpose> Lance la réplication d'un ensemble donné </refpurpose></refnamediv>
<refsynopsisdiv>
<cmdsynopsis>
@@ -1957,118 +1963,117 @@
<refsect1>
<title>Description</title>
- <para> This performs one of two actions: </para>
+ <para> Cette commande réalise une des deux opérations suivantes : </para>
<itemizedlist>
- <listitem><para> Initiates replication for a replication set </para>
- <para> Causes a node (subscriber) to start replicating a set of
- tables either from the origin or from another provider node, which
- must itself already be be an active, forwarding subscriber.</para>
+ <listitem><para> Initie la réplication pour un ensemble de réplication </para>
+ <para> Ceci déclenche la réplication sur un noeud (abonné) soit à partir
+de l'origine soit à partir du fournisseur, qui doit être lui même un noeud
+abonné actif et transmetteur ("forwarding subscriber").</para>
- <para> The application tables contained in the set must already
- exist and should ideally be empty. The current version of
- &slony1; will <emphasis>not</emphasis>
- attempt to copy the schema of the set. The replication daemon will
- start copying the current content of the set from the given
- provider and then try to catch up with any update activity that
- happened during that copy process. After successful subscription,
- the tables are guarded on the subscriber, using triggers, against
- accidental updates by the application.
+ <para> Les tables de l'application contenues dans l'ensemble de réplication
+doivent déjà exister et idéalement elles sont vides. La version courante de
+&slony1; ne tente <emphasis>pas</emphasis> de copier le schéma de l'ensemble
+de réplication. Le démon de réplication démarre et commence à copier le contenu
+de l'ensemble de réplication à partir du fournisseur spécifi, puis essaie
+de rattraper son retard en rejouant les mises à jour qui se sont produites
+lors du processus de copie. Un fois que l'abonnement a réussi, les tables
+sont protégées avec des triggers contre les mises à jour en provenance de
+l'application.
</para>
- <para> If the tables on the subscriber are
- <emphasis>not</emphasis> empty, then the <command>COPY
- SET</command> event (which is part of the subscription process)
- may wind up doing more work than should be strictly
- necessary:</para>
+ <para> Si les tables sur l'abonné ne sont
+ <emphasis>pas</emphasis> vides, alors l'événement <command>COPY
+ SET</command> ( qui fait partie du processus d'abonnement)
+ devra effectuer quelques taches supplémentaires :</para>
<itemizedlist>
- <listitem><para> It attempts to <command>TRUNCATE</command> the
- table, which will be efficient. </para> </listitem>
+ <listitem><para> Il tente d'effectuer un <command>TRUNCATE</command>
+ sur la table, ce qui devrait être efficace. </para> </listitem>
- <listitem><para> If that fails (a foreign key relationship might
- prevent TRUNCATE from working), it uses
- <command>DELETE</command> to delete all <quote>old</quote>
- entries in the table</para></listitem>
+ <listitem><para> Si cela ne fonctionne pas ( une relation sur une
+clef étrangère empêche peut-être le fonctionnement de TRUNCATE), il
+utilise la commande <command>DELETE</command> pour effacer toutes les
+<quote>anciennes</quote>
+entrées de la tables</para></listitem>
- <listitem><para> Those old entries clutter up the table until it
- is next <command>VACUUM</command>ed <emphasis>after</emphasis>
- the subscription process is complete</para></listitem>
+ <listitem><para> Ces anciennes données encombrent encore l'espace
+disque jusqu'à ce qu'un <command>VACUUM</command> soit effectué <emphasis>après</emphasis>
+la fin du processus d'abonnement.</para></listitem>
- <listitem><para> The indices for the table will contain entries
- for the old, deleted entries, which will slow the process of
- inserting new entries into the index.</para></listitem>
+ <listitem><para> Les index de la tables contiendront de références
+aux anciennes données, ce qui ralentira l'insertion de nouvelles données
+dans les index.</para></listitem>
</itemizedlist>
- <warning><para> This operation can take a (potentially distinctly)
- non-zero period of time. If you have a great deal of data in a
- particular set of tables, it may take hours or even (if <quote>a
- great deal</quote> indicates <quote>tens or hundreds gigabytes of
- data</quote>) possibly multiple days for this event to
- complete.</para>
+ <warning><para> Le temps d'execution de cette opération n'est pas
+négligeable. Si vous avez un grand volume de données dans un ensemble
+particulier de tables, cela peut prendre plusieurs heures, voire plusieurs
+jours pour que l'opération aboutisse ( ici <quote>"un grand volume</quote>
+signifie <quote>des dizaines ou des centaines de gigabytes de
+</quote>).</para>
- <para> The <command>SUBSCRIBE SET</command> request will,
- nonetheless, return fairly much immediately, even though the
- work, being handled by the <command>COPY SET</command> event, is
- still in progress. If you need to set up subscriptions for a set
- of cascading nodes, you will need to wait for each subscriber to
- complete subscribing before submitting requests for subscriptions
- that use that node as a provider. If you don't, it won't be a
- big deal: <command>slonik</command> will check the node, discover
- that it is not yet an active provider for the set, and report
- back:</para>
+ <para> Cependant, la requête <command>SUBSCRIBE SET</command> se terminera
+presque immédiatement, même si les travaux, gérés par l'événement
+<command>COPY SET</command>, sont encore en cours. Si vous devez configurer
+les abonnements sur des noeuds en cascade, vous devez attendre que chaque
+abonné ait terminé son abonnement avant de soumettre des requête d'abonnement
+qui utilise ce noeud comme fournisseur. Si vous ne le faites pas, ce n'est pas
+très grave : <command>slonik</command> va vérifier le noeud, découvrir qu'il
+n'est pas encore un fournisseur actif et reporter l'erreur suivante :
+</para>
<programlisting>
Slony-I: provider 2 is not an active forwarding node for replication set 1
</programlisting>
- <para> In effect, such subscription requests will be ignored
- until the provider is ready.</para>
+ <para> En pratique, de telles requêtes d'abonnement seront ignorées
+jusqu'à ce que le fournisseur soit prêt.</para>
</warning>
</listitem>
- <listitem><para> Revising subscription information for already-subscribed nodes. </para>
+ <listitem><para> Modifier les informations d'abonnement pour les
+noeuds qui sont déjà abonnés. </para>
- <para> If you need to revise subscription information for a
- node, you <emphasis>also</emphasis> submit the new information
- using this command, and the new configuration will be propagated
- throughout the replication network. The normal reason to revise
- this information is that you want a node to subscribe to a
- <emphasis> different </emphasis> provider node, or for a node to
- become a <quote>forwarding</quote> subscriber so it may later
- become the provider for a later subscriber.</para>
+ <para> Si vous devez modifier les informations d'abonnement pour un
+noeud donné, vous devez <emphasis>également</emphasis> soumettre les
+nouvelles informations avec cette commande, et la nouvelle configuration sera
+propagée à travers le réseau de réplication. En général, on modifier
+les informations d'abonnement lorsque l'on veut abonner un noeud à un fournisseur
+ <emphasis> différent </emphasis> ou transformer un noeud en <quote>transmetteur</quote>
+afin qu'il puisse à son tour devenir le fournisseur d'un autre abonné.
+</para>
</listitem>
</itemizedlist>
<variablelist>
<varlistentry><term><literal> ID = ival </literal></term>
- <listitem><para> ID of the set to subscribe</para></listitem>
+ <listitem><para> Identifiant de l'ensemble auquel on s'abonne</para></listitem>
</varlistentry>
<varlistentry><term><literal> PROVIDER = ival </literal></term>
- <listitem><para> Identifiant du noeud of the data provider from which this
- node draws data.</para></listitem>
+ <listitem><para> Identifiant du noeud fournisseur qui transmet les données
+à ce noeud.</para></listitem>
</varlistentry>
<varlistentry><term><literal> RECEIVER = ival </literal></term>
- <listitem><para> Identifiant du noeud of the new subscriber</para></listitem>
+ <listitem><para> Identifiant du nouveau noeud abonné</para></listitem>
</varlistentry>
<varlistentry><term><literal> FORWARD = boolean </literal></term>
- <listitem><para> Flag whether or not the new subscriber should
- store the log information during replication to make it
- possible candidate for the provider role for future
- nodes.</para></listitem>
+ <listitem><para> Indique si le nouvel abonné doit stocker les logs
+pendant la réplication afin de pouvoir devenir fournisseur pour de futurs
+noeuds.</para></listitem>
</varlistentry>
</variablelist>
- <para> This uses &funsubscribeset;. </para>
+ <para> Cette commande utilise &funsubscribeset;. </para>
</refsect1>
<refsect1><title>Exemple</title>
<programlisting>
@@ -2081,95 +2086,91 @@
</programlisting>
</refsect1>
- <refsect1> <title> Forwarding Behaviour </title>
+ <refsect1> <title> Transmission </title>
- <para> The <command>FORWARD=boolean</command> flag indicates
- whether the subscriber will store log information in tables
- &sllog1; and &sllog2;. Several implications fall from
- this...</para>
+ <para> Le paramètre <command>FORWARD=boolean</command> indique si le
+l'abonné doit conserver les informations dans les tables
+ &sllog1; and &sllog2;. Ceci implique plusieurs choses...</para>
- <para> By storing the data in these tables on the subscriber,
- there is some additional processing burden. If you are certain
- that you would never want to <xref linkend="stmtmoveset"/> or <xref
- linkend="stmtfailover"/> to a particular subscriber, it is worth
- considering turning off forwarding on that node. </para>
+ <para>Stocker les données dans ces tables sur l'abonné représente
+une charge supplémentaire. Si vous êtes certain(e) que vous n'effectuerez
+jamais les opérations <xref linkend="stmtmoveset"/> ou <xref
+linkend="stmtfailover"/> sur un abonné particulier, il vaut mieux
+désactiver la transmission sur ce noeud. </para>
- <para> There is, however, a case where having forwarding turned
- off opens up a perhaps-unexpected failure condition; a rule of
- thumb should be that <emphasis>all nodes that connect directly to
- the origin</emphasis> should have forwarding turned on. Supposing
- one such <quote>direct subscriber</quote> has forwarding turned
- off, it is possible for that node to be forcibly lost in a case of
- failover. The problem comes if that node gets ahead of other
- nodes.</para>
+ <para> Ceci étant, dans certains cas le fait de désactiver cette option
+peut poser des problèmes losque l'on se trouve dans une situation inattendue.
+De manière empirique, on considère qu'il préférable que <emphasis>tout
+noeud connecté directement à l'origine</emphasis> soit
+un <quote>noeud transmetteur </quote>. Il est possible que ce noeud
+soit perdu lors d'une bascule d'urgence. Le problème survient lorsque
+ce noeud est en avance sur les autres noeuds.</para>
- <para> Let's suppose that the origin, node 1 is at SYNC number
- 88901, a non-forwarding node, node 2 has processed up to SYNC
- 88897, and other forwarding nodes, 3, 4, and 5, have only
- processed data up to SYNC 88895. At that moment, the disk system
- on the origin node catches fire. Node 2 has the
- <emphasis>data</emphasis> up to SYNC 88897, but there is no
- remaining node that contains, in &sllog1; or &sllog2;, the data
- for SYNCs 88896 and 88897, so there is no way to bring nodes 3-5
- up to that point.</para>
+ <para> Supposons que l'origine, le noeud 1, est au numéro de SYNC
+88901, un noeud non-transmetteur, le noeud 2 en est arrivé au numéro
+88897, tandis que les autres noeuds transmetteur, 3, 4, et 5, en sont
+seulement au SYNC numéro 88895. A ce moment, le disque système sur le
+noeud origine prend feu. Le noeud 2 possède les <emphasis>données</emphasis> à jour
+jusqu'à 88901, mais aucun noeud transmetteur ne dispose, dans les tables
+ &sllog1; ou &sllog2;, des données correspondant
+aux événements SYNCs numérotés 88896 et 88897. Il n'y a donc
+aucun moyen de ramener les noeuds 3-5 à ce niveau.</para>
- <para> At that point, there are only two choices: To drop node 2,
- because there is no way to continue managing it, or to drop all
- nodes <emphasis>but</emphasis> 2, because there is no way to bring
- them up to SYNC 88897.</para>
+ <para> À ce stade, vous avez deux choix : supprimer le noeud2, car il
+n'existe aucun moyen de le maintenir, ou supprimer tous les noeuds
+<emphasis>sauf</emphasis> le noeud 2, car il n'existe aucun moyen de les
+amener jusqu'à l'événement SYNC 88897.</para>
- <para> That dilemma may be avoided by making sure that all nodes
- directly subscribing to the origin have forwarding turned
- on. </para>
+ <para> Ce dilemme peut être évité en s'assurant que tous les noeuds directement
+abonnés à l'origine sont des transmetteurs. </para>
</refsect1>
- <refsect1> <title> Dangerous/Unintuitive Behaviour </title>
+ <refsect1> <title> Comportement dangereux et non-intuitif </title>
<itemizedlist>
- <listitem><para> The fact that the request returns immediately
- even though the subscription may take considerable time to
- complete may be a bit surprising. </para>
+ <listitem><para> Le fait que la requête se termine immédiatement
+même si l'abonnement prend un temps considérable est parfois surprenant.
+ </para>
- <para> Processing of the subscription involves
- <emphasis>two</emphasis> events; the
- <command>SUBSCRIBE_SET</command>, initiated from the provider
- node, and an <command>ENABLE_SUBSCRIPTION</command>, which is
- initiated on the subscriber node. This means that <xref
- linkend="stmtwaitevent"/> cannot directly wait for completion of a
- subscription. If you need to wait for completion of a
- subscription, then what you need to do instead is to submit a
- <xref linkend="stmtsync"/> request, and wait for
- <emphasis>that</emphasis> event.</para>
+ <para> Le traitement des abonnements implique
+ <emphasis>deux</emphasis> événements; l'opération
+ <command>SUBSCRIBE_SET</command>, initié sur le noeud fournisseur,
+et une opération <command>ENABLE_SUBSCRIPTION</command>, qui est
+initiée sur le noeud abonné. Cela signifie que <xref
+ linkend="stmtwaitevent"/> ne peut pas attendre la fin d'une souscription.
+Si vous souhaitez attendre la fin d'un abonnement, alors vous devez soumettre une
+requête <xref linkend="stmtsync"/> et attendre que <emphasis>cet</emphasis> événement
+s'achève.</para>
</listitem>
- <listitem><para> This command has <emphasis>two</emphasis>
- purposes; setting up subscriptions (which should be unsurprising)
- and <emphasis>revising subscriptions</emphasis>, which isn't so
- obvious to intuition. </para> </listitem>
+ <listitem><para> Cette commande a <emphasis>deux</emphasis>
+objectifs : mettre en place des abonnements ( ce qui n'est très surprenant )
+et <emphasis>modifier des abonnements</emphasis>, ce qui n'est pas forcément
+intuitif. </para> </listitem>
- <listitem><para> New subscriptions are set up by using
- <command>DELETE</command> or <command>TRUNCATE</command> to
- empty the table on a subscriber. If you created a new node by
- copying data from an existing node, it might <quote>seem
- intuitive</quote> that that data should be kept; that is not the
- case - the former contents are discarded and the node is
- populated <emphasis>from scratch</emphasis>.</para> </listitem>
+ <listitem><para> Les nouveaux abonnements sont définis en utilisant
+<command>DELETE</command> ou <command>TRUNCATE</command> pour vider
+les tables sur l'abonné. Si vous avez créé un nouveau noeud en
+recopiant les données à partir d'un noeud existant, il peut <quote>paraitre
+évident</quote> que ces données seront conservées. Ce n'est pas le cas,
+l'ancien contenu est détruit et le noeud est re-peupler <emphasis>à partir
+de zéro</emphasis>.</para> </listitem>
</itemizedlist>
</refsect1>
<refsect1> <title> Utilisation de verrous </title>
- <para> This operation does <emphasis>not</emphasis> require
- acquiring any locks on the provider node.</para>
+ <para> Cette opération ne nécessite <emphasis>pas</emphasis> de verrous
+sur le noeud fournisseur.</para>
- <para> On the subscriber node, it will have the effect of locking
- every table in the replication set. In version 1.2, exclusive
- locks are acquired at the beginning of the process; in earlier
- versions, locks were acquired implicitly as activity mandated it,
- which left some risk of deadlock if other applications could
- access the subscriber database at this time.
+ <para> Sur le noeud abonné, l'opération placera un verrou
+sur toutes les table de l'ensemble de réplication. Dans la version
+1.2, les verrous exclusifs sont placés au début du processus; dans les
+versions antérieurs, les verrous sont placés implicitement uniquement lorsque
+qu'une activité le demande, ce qui laisse une possibilité d'inter-blocage
+("deadlock") si d'autres applications peuvent accéder à la base à ce moment là.
</para>
</refsect1>
<refsect1> <title> Note de version </title>
@@ -2184,7 +2185,7 @@
<refnamediv><refname>UNSUBSCRIBE SET</refname>
- <refpurpose> End replication of &slony1; set </refpurpose></refnamediv>
+ <refpurpose> Arrête la réplication d'un ensemble de réplication &slony1; </refpurpose></refnamediv>
<refsynopsisdiv>
<cmdsynopsis>
@@ -2194,25 +2195,24 @@
<refsect1>
<title>Description</title>
- <para> Stops the subscriber from replicating the set. The tables
- are opened up for full access by the client application on the
- former subscriber. The tables are not truncated or otherwise
- modified. All original triggers, rules and constraints are
- restored.
+ <para> Cette commande interrompt la réplication d'un ensemble sur un abonné.
+Les tables sont alors ouvertes en accès total aux applications clientes sur l'ancien
+abonné. Les tables ne sont pas détruites, ni modifiées. Tous les triggers originaux, les règles
+et les contraintes sont restaurées.
<variablelist>
<varlistentry><term><literal> ID = ival </literal></term>
- <listitem><para> ID of the set to unsubscribe</para></listitem>
+ <listitem><para> Identifiant de l'ensemble à désabonner</para></listitem>
</varlistentry>
<varlistentry><term><literal> RECEIVER = ival </literal></term>
- <listitem><para> Identifiant du noeud of the (former) subscriber</para></listitem>
+ <listitem><para> Identifiant de noeud de l' (ancien) abonné</para></listitem>
</varlistentry>
</variablelist>
</para>
- <para> This uses &fununsubscribeset;. </para>
+ <para> Cette commande utilise &fununsubscribeset;. </para>
</refsect1>
<refsect1><title>Exemple</title>
<programlisting>
@@ -2224,17 +2224,17 @@
</refsect1>
<refsect1> <title> Utilisation de verrous </title>
- <para> Exclusive locks on each replicated table will be taken out
- on the subscriber in order to drop replication triggers from the
- tables and restore other triggers/rules. </para>
+ <para> Des verrous exclusifs sont posés sur chaque table répliquées
+de l'abonné afin de supprimer les triggers de réplication et de restaurer
+les anciens triggers/règles. </para>
</refsect1>
- <refsect1><title> Dangerous/Unintuitive Behaviour </title>
+ <refsect1><title> Comportement dangereux et non-intuitif </title>
- <para> Resubscribing an unsubscribed set requires a
- <emphasis>complete fresh copy</emphasis> of data from the
- provider to be transferred since the tables have been subject to
- possible independent modifications. </para>
+ <para> Ré-abonner un ensemble désabonné nécessite une
+ <emphasis>copie fraîche et complète</emphasis> des données obtenue à partir
+du noeud fournisseur, car les tables ont pu être soumises à des modifications
+indépendantes. </para>
</refsect1>
<refsect1> <title> Note de version </title>
@@ -2250,8 +2250,8 @@
<refnamediv><refname>LOCK SET</refname>
- <refpurpose> Guard &slony1; replication
- set to prepare for <command>MOVE SET</command>
+ <refpurpose> Protège un ensemble de réplication &slony1; pour le
+préparer à un <command>MOVE SET</command>
</refpurpose></refnamediv>
<refsynopsisdiv>
<cmdsynopsis>
@@ -2261,33 +2261,34 @@
<refsect1>
<title>Description</title>
- <para> Guards a replication set against client application updates
- in preparation for a <xref linkend="stmtmoveset"/> command.
+ <para> Cette commande protège un ensemble de réplication des mises à
+jour en provenance des applications clientes, en préparation d'une
+commande <xref linkend="stmtmoveset"/>.
</para>
- <para> This command must be the first in a possible statement
- group (<command>try</command>). The reason for this is that it
- needs to commit the changes made to the tables (adding a special
- trigger function) before it can wait for every concurrent
- transaction to finish. At the same time it cannot hold an open
- transaction to the same database itself since this would result in
- blocking itself forever.</para>
+ <para> Cette commande doit être la première dans un groupe de commande <command>try</command>.
+En effet, il faut <quote>committer</quote> les changements faits sur les tables
+ (ajout d'une fonction trigger speciale) avant d'attendre que toutes les
+transactions concurrentes se termine. En même temps, il ne faut pas
+non plus garder une transaction ouverte sur la base elle-même car cela
+cela signifierait qu'elle se bloque elle-même.
+ </para>
- <para> Note that this is a &rlocking; operation, which means that
- it can get stuck behind other database activity.</para>
+ <para> Notons qu'il s'agit d'un opération &rlocking;, ce qui signifie qu'elle peut être
+bloquer derrière d'autres activités de la base.</para>
- <para> The operation waits for transaction IDs to advance in order
- that data is not missed on the new origin. Thus, if you have
- long-running transactions running on the source node, this
- operation will wait for those transactions to complete.
- Unfortunately, if you have another database on the same postmaster
- as the origin node, long running transactions on that database
- will also be considered even though they are essentially
- independent.
+ <para> L'opération attend que les identifiants de transaction avancent
+afin qu'aucune donnée ne soient oubliées sur la nouvelle origine. Ainsi
+si vous avez des transactions très longues en cours sur le noeud source,
+cette opération attendra que ces transactions aboutissent.
+Malheureusement , si vous avez une autre base de données sur le même
+ postmaster du noeud origine, les transactions longues en cours
+sur cette base seront aussi prises en compte même si elles sont par définition
+indépendantes.
<variablelist>
<varlistentry><term><literal> ID = ival </literal></term>
- <listitem><para> ID of the set to lock</para></listitem>
+ <listitem><para> Identifiant de l'ensemble à bloquer</para></listitem>
</varlistentry>
<varlistentry><term><literal> ORIGIN = ival </literal></term>
@@ -2432,7 +2433,7 @@
</varlistentry>
</variablelist>
</para>
- <para> This uses &funmoveset;. </para>
+ <para> Cette commande utilise &funmoveset;. </para>
</refsect1>
<refsect1><title>Exemple</title>
<programlisting>
@@ -2449,13 +2450,13 @@
</refsect1>
<refsect1> <title> Utilisation de verrous </title>
- <para> Exclusive locks on each replicated table will be taken out
- on both the old origin node and the new origin node, as
- replication triggers are changed on both nodes: on the former
- origin, each table has two triggers (logtrigger and lockset)
- dropped and a denyaccess trigger added; on the new origin, the
- denyaccess trigger is dropped and a logtrigger trigger
- added. </para>
+ <para> Des verrous exclusifs sont posés sur chaque table répliquée
+à la fois sur l'ancien noeud origine et le nouveau noeud origine, car
+les triggers de réplication sont changés sur les deux noeuds :
+sur l'ancienne origine, chaque table supprime deux triggers
+(logtrigger et lockset) et ajoute un trigger denyaccess;
+sur la nouvelle origine, le trigger denyaccess est supprimé et
+le trigger logtrigger est ajouté. </para>
</refsect1>
<refsect1> <title> Note de version </title>
<para> Cette commande fut introduite dans &slony1; 1.0 </para>
@@ -2469,7 +2470,8 @@
<refnamediv><refname>FAILOVER</refname>
- <refpurpose> Fail a broken replication set over to a backup node
+ <refpurpose> Cette commande bascule un ensemble de réplication
+en échec vers un noeud de secours.
</refpurpose></refnamediv>
<refsynopsisdiv>
<cmdsynopsis>
@@ -2480,38 +2482,37 @@
<title>Description</title>
<para>
- The <command>FAILOVER</command> command causes the backup node to take over all sets
- that currently originate on the failed
- node. <application>slonik</application> will contact all other
- direct subscribers of the failed node to determine which node has
- the highest sync status for each set. If another node has a
- higher sync status than the backup node, the replication will
- first be redirected so that the backup node replicates against
- that other node, before assuming the origin role and allowing
- update activity.
+ La commande <command>FAILOVER</command> transfert tous les ensembles dont
+l'origine est en panne vers le noeud de secours.
+ <application>slonik</application> va contacter tous les autres noeuds directement
+abonnés au noeud en panne pour déterminer quel noeud à le meilleur niveau de synchronisation
+pour chacun des ensembles de réplication. Si un autre noeud a un niveau de synchronisation
+plus élévé que le noeud de secours, la réplication sera d'abord redirigée pour que le noeud
+de secours rattrape son retard sur l'autre noeud, puis qu'il assume le role d'origine
+et reçoive les mises à jour.
</para>
<para>
- After successful failover, all former direct subscribers of the
- failed node become direct subscribers of the backup node. The
- failed node is abandoned, and can and should be removed from the
- configuration with <xref linkend="stmtdropnode"/>.
+ Après une bascule d'urgence réussie, tous les anciens noeuds abonnés directement
+au noeud en panne deviennent des abonnés direct du noeud de secours.
+Le noeud en panne est abandonné, et doit être retiré de la configuration avec
+<xref linkend="stmtdropnode"/>.
</para>
<variablelist>
<varlistentry><term><literal> ID = ival </literal></term>
- <listitem><para> ID of the failed node</para></listitem>
+ <listitem><para> Identifiant du noeud en panne</para></listitem>
</varlistentry>
<varlistentry><term><literal> BACKUP NODE = ival </literal></term>
- <listitem><para> Identifiant du noeud of the node that will take over all
- sets originating on the failed node</para></listitem>
+ <listitem><para> Identifiant du noeud de secours qui va prendre en charge
+les ensembles de réplication dont l'origine est le noeud en panne</para></listitem>
</varlistentry>
</variablelist>
- <para> This uses &funfailednode;. </para>
+ <para> Cette commande utilise &funfailednode;. </para>
</refsect1>
<refsect1><title>Exemple</title>
<programlisting>
@@ -2523,20 +2524,21 @@
</refsect1>
<refsect1> <title> Utilisation de verrous </title>
- <para> Exclusive locks on each replicated table will be taken out
- on both the new origin node as replication triggers are changed.
- If the new origin was not completely up to date, and replication
- data must be drawn from some other node that is more up to date,
- the new origin will not become usable until those updates are
- complete. </para>
+ <para> Des verrous exclusifs sont posés sur chaque table répliquée sur
+le nouveau noeud origine, car les triggers de réplication sont changés.
+Si la nouvelle origine n'est pas tout à fait à jour, et que des données
+doivent être rapatriées depuis à partir d'un autre noeud qui est mieux synchronisé,
+alors la nouvelle origine ne sera pas utilisable avant que ces mises à jour
+soient terminées.
+ </para>
</refsect1>
- <refsect1><title> Dangerous/Unintuitive Behaviour </title>
- <para> This command will abandon the status of the failed
- node. There is no possibility to let the failed node join the
- cluster again without rebuilding it from scratch as a slave. If
- at all possible, you would likely prefer to use <xref
- linkend="stmtmoveset"/> instead, as that does
- <emphasis>not</emphasis> abandon the failed node.
+ <refsect1><title> Comportement dangerous et non-intuitif </title>
+ <para> Cette commande va abandonner le noeud en panne.
+Il n'y a pas de possibilité de réintégrer le noeud en panne,
+sans le reconstruire à partir de zéro en tant qu'esclave.
+Si c'est possible, il est préférable d'utiliser la commande
+ <xref linkend="stmtmoveset"/> , car elle n'abandonne
+ <emphasis>pas</emphasis> le noeud en panne.
</para>
</refsect1>
<refsect1> <title> Note de version </title>
@@ -2551,7 +2553,7 @@
<refnamediv><refname>EXECUTE SCRIPT</refname>
- <refpurpose> Execute SQL/DDL script </refpurpose></refnamediv>
+ <refpurpose> Éxecute un script SQL/DDL </refpurpose></refnamediv>
<refsynopsisdiv>
<cmdsynopsis>
<command>EXECUTE SCRIPT (options);</command>
@@ -2560,79 +2562,79 @@
<refsect1>
<title>Description</title>
- <para> Executes a script containing arbitrary SQL statements on
- all nodes that are subscribed to a set at a common controlled
- point within the replication transaction stream.</para>
-
- <para> The specified event origin must be the origin of the set.
- The script file must not contain any <command>START</command> or
- <command>COMMIT TRANSACTION</command> calls. (This changes
- somewhat in &postgres; 8.0 once nested transactions, aka
- savepoints, are supported) In addition, non-deterministic DML
- statements (like updating a field with
- <function>CURRENT_TIMESTAMP</function>) must be avoided, since the
- data changes done by the script are explicitly not
- replicated. </para>
+ <para> Cette commande éxecutes un script contenant de ordres SQL sur
+tous les noeufs qui sont abonnés à un ensemble de réplication à un
+point précis dans le flux des transactions.</para>
+ OA
+ <para> L'origine de l'événement doit être l'origine de l'ensemble
+de réplication. Le fichier de script ne doit pas contenir d'ordres
+<command>START</command> ou <command>COMMIT TRANSACTION</command>.
+ (Ceci change un peu avec &postgres; 8.0 puisque les transactions imbriquées,
+appelée également <quote>points de sauvegarde</quote> (<quote>
+ savepoints</quote>, sont supportés.
+De plus les ordres DML non déterministes (par exemple mettre a jour un
+champs avec la valeur <function>CURRENT_TIMESTAMP</function>) doivent
+être évitées, car les changements effectués par ce script ne sont pas
+explicitement répliqués. </para>
<variablelist>
<varlistentry><term><literal> SET ID = ival </literal></term>
- <listitem><para> The unique numeric ID number of the set
- affected by the script</para></listitem>
+ <listitem><para> Le numéro unique de l'ensemble affecté par le script</para></listitem>
</varlistentry>
- <varlistentry><term><literal> FILENAME = '/path/to/file' </literal></term>
+ <varlistentry><term><literal> FILENAME = '/chemin/vers/le/fichier' </literal></term>
- <listitem><para> The name of the file containing the SQL script to
- execute. This might be a relative path, relative to the location of
- the <application>slonik</application> instance you are running, or, preferably,
- an absolute path on the system where <application>slonik</application> is to run.</para>
+ <listitem><para> Le nom du fichier contenant le script SQL à exécuter.
+Il peut s'agir d'un chemin relatif à l'emplacement de l'instance <application>slonik</application>
+que vous avez lancé, ou de préférance, un chemin absolu sur le système où
+ <application>slonik</application> est lancé.</para>
- <para> The <emphasis>contents</emphasis> of the file are propagated as part of
- the event, so the file does not need to be accessible on any of the
- nodes.</para></listitem>
+ <para> Le <emphasis>contenu</emphasis> de ce fichier est propagé dans un
+événement, donc il n'est pas nécessaire que le fichier soit accessible depuis
+les autres noeuds.
+ </para></listitem>
</varlistentry>
<varlistentry><term><literal> EVENT NODE = ival </literal></term>
- <listitem><para> (Optional) The ID of the current origin of the set. Default value is 1.</para></listitem>
+ <listitem><para> (Optionel) L'identifiant de l'origine courante du set. La valeur par défaut est 1.</para></listitem>
</varlistentry>
<varlistentry><term><literal> EXECUTE ONLY ON = ival
- </literal></term><listitem><para> (Optional) The ID of the only
- node to actually execute the script. This option causes the
- script to be propagated by all nodes but executed only by one.
- The default is to execute the script on all nodes that are
- subscribed to the set.</para></listitem>
+ </literal></term><listitem><para> (Optionel) L'identifiant du seul noeud qui
+doit exécuter le script. Cette option implique que le script sera propagé
+sur tous les noeufs mais exécuté sur un seul.
+Par défaut on exécute le script sur tous les noeuds abonnés à l'ensemble de réplication.
+ </para></listitem>
</varlistentry>
</variablelist>
- <para> See also the warnings in &rddlchanges;.</para>
+ <para> Voir également les avertissements dans la section &rddlchanges;.</para>
- <para> Note that this is a &rlocking; operation, which means that
- it can get stuck behind other database activity.</para>
+ <para> Notons qu'il s'agit d'une opération &rlocking;, ce qui signifie qu'elle peut être
+bloquée par l'activité d'une autre base.</para>
- <para> At the start of this event, all replicated tables are
- unlocked via the function
- <function>alterTableRestore(tab_id)</function>. After the SQL
- script has run, they are returned to <quote>replicating
- state</quote> using
- <function>alterTableForReplication(tab_id)</function>. This means
- that all of these tables are locked by this &slon; process for the
- duration of the SQL script execution.</para>
+ <para> Au démarrage de cet événement, toutes les tables répliquées sont
+déverrouillées par la fonction <function>alterTableRestore(tab_id)</function>.
+Une fois le script SQL exécuté, elles sont remises en <quote>mode réplication
+</quote> avec <function>alterTableForReplication(tab_id)</function>.
+Cela implique que toutes les tables sont verrouillées par ce processus
+&slon; pendant la durée du script SQL.</para>
- <para> If a table's columns are modified, it is very important
- that the triggers be regenerated, otherwise they may be
- inappropriate for the new form of the table schema.</para>
+ <para> Si les colonnes d'une table sont modifiées, il est très
+important que les triggers soient regénérés, sinon ils peuvent
+être inadaptés à la nouvelle forme du schéma.
+ </para>
- <para> Note that if you need to make reference to the cluster
- name, you can use the token <command>@CLUSTERNAME@</command>; if
- you need to make reference to the &slony1; namespace, you can use
- the token <command>@NAMESPACE@</command>; both will be expanded
- into the appropriate replacement tokens. </para>
+ <para> Notez que si vous devez faire référence au nom du cluster,
+vous pouvez utiliser l'alias <command>@CLUSTERNAME@</command>;
+si vous devez faire référence à l'espace de nom &slony1;,
+vous pouvez utiliser l'alias <command>@NAMESPACE@</command>;
+les deux seront remplacés par la valeur appropriée. </para>
- <para> This uses &funddlscript;. </para>
+ <para> Cette commande utilise &funddlscript;. </para>
</refsect1>
<refsect1><title>Exemple</title>
<programlisting>
@@ -2645,52 +2647,53 @@
</refsect1>
<refsect1> <title> Utilisation de verrous </title>
- <para> Up until the 2.0 branch, each replicated table received an
- exclusive lock, on the origin node, in order to remove the
- replication triggers; after the DDL script completes, those locks
- will be cleared. </para>
+ <para> Sur les versions antérieures à la branche 2.0, un verrou exclusif est posé
+sur chaque table répliquée sur le noeud origine, afin de retirer les triggers
+de réplication; Une fois le script DDL achevé, ces verrous sont enlevés.
+ </para>
- <para> After the DDL script has run on the origin node, it will
- then run on subscriber nodes, where replicated tables will be
- similarly altered to remove replication triggers, therefore
- requiring that exclusive locks be taken out on each node, in
- turn. </para>
+ <para> Une fois le script DDL exécuté sur le noeud origine, il est lancé sur les noeuds
+abonnés, des verrous similaires sont posés sur tous les noeuds pour altérer
+les triggers des tables répliquées.
+ </para>
- <para> As of the 2.0 branch, &slony1; uses a GUC that controls
- trigger behaviour, which allows deactivating the &slony1;-created
- triggers during this operation <emphasis>without</emphasis> the
- need to take out exclusive locks on all tables. Now, the only
- tables requiring exclusive locks are those tables that are
- actually altered as a part of the DDL script. </para>
+ <para> À partir de la branche 2.0, &slony1; utilise un GUC qui controlle
+le comportement des triggers, ce qui permet de désactiver les triggers créer par
+&slony1; pendant l'opération <emphasis>sans</emphasis> poser de verrous exclusifs sur
+toutes les tables. Désormais, les seules tables qui sont verrouillées sont les tables
+qui sont effectivement modifiée par le script DDL.
+ </para>
</refsect1>
<refsect1> <title> Note de version </title>
<para> Cette commande fut introduite dans &slony1; 1.0. </para>
- <para> Before &slony1; version 1.2, the entire DDL script was
- submitted as one <function>PQexec()</function> request, with the
- implication that the <emphasis>entire</emphasis> script was parsed
- based on the state of the database before invokation of the
- script. This means statements later in the script cannot depend
- on DDL changes made by earlier statements in the same script.
- Thus, you cannot add a column to a table and add constraints to
- that column later in the same request. </para>
+ <para> Avant la version 1.2, l'ensemble du script DDL était soumis
+dans une requête <function>PQexec()</function>, ce qui impliquait que
+le script <emphasis>tout entier</emphasis> était traité en se basant sur
+l'état de la base avant l'invocation du script. Cela signifie que
+des ordres placés à la fin d'un script ne pouvait pas dépendre d'un ordre
+situé au début de ce même script. Ainsi, il n'était pas possible
+d'ajouter un colonne dans une table, puis une contrainte sur cette
+colonne au sein du même script.
+ </para>
- <para> In &slony1; version 1.2, the DDL script is split into
- statements, and each statement is submitted separately. As a
- result, it is fine for later statements to refer to objects or
- attributes created or modified in earlier statements.
- Furthermore, in version 1.2, the <command>slonik</command> output
- includes a listing of each statement as it is processed, on the
- set origin node. Similarly, the statements processed are listed
- in slon logs on the other nodes.</para>
+ <para> Dans &slony1; version 1.2, le script DDL est découpé par ordre par ordre,
+et chaque ordre est soumis séparément. Cela implique, que les ordres de la fin
+du script peuvent se référer aux objets ou aux attributs créer et modifié au début
+du script.
+De plus, dans la version 1.2, le résultat de sortie de<command>slonik</command>
+contient la liste de ordre au fur et à mesure de leur traitement sur le noeud
+d'origine de l'ensemble de réplication. De même, les ordres traités sont listés
+dans les logs de slon sur les autres noeuds.
+ </para>
- <para> In &slony1; version 1.0, this would only lock the tables in
- the specified replication set. As of 1.1, <emphasis>all
- replicated tables</emphasis> are locked (<emphasis>e.g.</emphasis>
- - triggers are removed at the start, and restored at the end).
- This deals with the risk that one might request DDL changes on
- tables in multiple replication sets.</para>
+ <para> Dans &slony1; version 1.0, cette commande verrouille uniquement les tables
+de l'ensemble spécifié. À partir de la version 1.1, <emphasis>toutes
+les tables répliquées</emphasis> sont verrouillées (<emphasis>c'est à dire</emphasis>
+que les triggers sont retirés au départ, et restaurés à la fin).
+Ceci couvre les risques lorsqu'on lance une requête de changements DDL
+sur des tables appartenant de plusieurs ensemble de réplication.</para>
</refsect1>
</refentry>
@@ -2701,7 +2704,7 @@
<refnamediv><refname>UPDATE FUNCTIONS</refname>
- <refpurpose> Reload stored functions </refpurpose></refnamediv>
+ <refpurpose> Recharge les fonctions stockées </refpurpose></refnamediv>
<refsynopsisdiv>
<cmdsynopsis>
<command>UPDATE FUNCTIONS (options);</command>
@@ -2710,17 +2713,17 @@
<refsect1>
<title>Description</title>
- <para> Reloads stored functions for a node.</para>
+ <para> Cette commande recharge les fonctions stockées pour un noeud.</para>
- <para>Reloads all stored procedure and function definitions in the
- &slony1; schema for the specified node. This command is usually
- part of the &slony1; software upgrade procedure.
+ <para>Elle restaure toutes les procédures stockées et les définitions de fonctions dans
+le schéma &slony1; pour un noeud donné. Cette commande fait habituellement partie des
+procédure de mise à jour logicielles.
</para>
<variablelist>
<varlistentry><term><literal> ID = ival </literal></term>
- <listitem><para> The node to refresh.</para></listitem>
+ <listitem><para> Le noeud à rafraîchir.</para></listitem>
</varlistentry>
</variablelist>
@@ -2740,26 +2743,27 @@
<refsect1> <title> Note de version </title>
<para> Cette commande fut introduite dans &slony1; 1.0 </para>
</refsect1>
- <refsect1> <title> Oddities </title>
+ <refsect1> <title> Bizarreries </title>
- <para> Any mismatch between <xref linkend="slonik"/> and the C
- libraries <quote>living</quote> in the &postgres; installation
- will result in this failing to do what is expected, and, more than
- likely, failing to run at all. You may <emphasis>think</emphasis>
- you are upgrading to version 1.1.5, but if you are running <xref
- linkend="slonik"/> from version 1.1.2, or if you didn't restart the
- database with a version that has 1.1.5 libraries, and instead are
- referencing C stored functions from version 1.1.1, the attempt to
- upgrade will fail, because the sets of C functions have regularly
- changed between major versions.</para>
+ <para> Toute incohérence entre <xref linkend="slonik"/> et la librairie C
+ <quote>résidant</quote> dans l'installation de &postgres; empêchera le
+bon fonctionnement de l'ensemble et provoquera probablement une panne.
+Vous pouvez <emphasis>penser</emphasis> que vous mettez à jour à la version
+1.1.5, mais si vous êtes en train d'utiliser la version 1.1.2, ou si vous
+n'avez pas redémarrer la base avec une version qui a les librairies 1.1.5,
+et que vous référencer des fonctions stockées en C de la version 1.1.1,
+la tentative de mise à jour va échouer, car les ensembles de fonctions C
+sont régulièrement modifié entre les versions majeures.
+ </para>
- <para> Before &slony1; 1.2, the error messages that would result
- would be not terribly informative; what you'd find, in &postgres;
- logs, is some error message about being unable to load some stored
- function that happens to be implemented in C. As of 1.2, one of
- the first things done is to load a stored function to verify
- version numbers; it complains in a much more direct fashion if you
- have some versioning mismatch. </para>
+ <para> Avant &slony1; 1.2, le message d'erreur affiché n'était pas
+très informatif. ce qu'on trouvait dans les logs de &postgres; était une
+erreur signalant l'impossibilité de charger des functions stockées implémentées
+en C. À partir de la version 1.2, une des premières actions effectuées est
+le chargement d'un fonction stocker pour vérifier les numéros de versions;
+Un message bien plus clair est affiché si vous utiliser des versions non
+cohérentes.
+ </para>
</refsect1>
</refentry>
@@ -2770,8 +2774,7 @@
<refnamediv><refname>WAIT FOR EVENT</refname>
- <refpurpose> Have Slonik script wait for previous event to
- complete </refpurpose></refnamediv>
+ <refpurpose> Demander à un script Slonik d'attendre que l'événement précédent s'achève</refpurpose></refnamediv>
<refsynopsisdiv>
<cmdsynopsis>
<command>WAIT FOR EVENT (options);</command>
@@ -2780,43 +2783,46 @@
<refsect1>
<title>Description</title>
- <para> Waits for event Confirmation.</para>
+ <para> Cette commande attend une confirmation d'événement.</para>
- <para> <application>Slonik</application> remembers the last event
- generated on every node during script execution (events generated
- by earlier calls are currently not checked). In certain situations
- it is necessary that events generated on one node (such as
- <command>CREATE SET</command>) are processed on another node
- before issuing more commands (for instance, <xref
- linkend="stmtsubscribeset"/>). <command>WAIT FOR EVENT</command> may be
- used to cause the <application>slonik</application> script to wait
- until the subscriber node is ready for the next action.
+ <para> <application>Slonik</application> se souvient du dernier événement
+généré sur chaque noeuf pendant l'éxécution d'un script ( les événements produits
+lors des appels précédents ne sont pas vérifiés). Dans certaines situations
+il est nécessaire que des événements générés sur un noeud (tel que
+ <command>CREATE SET</command>) soient traités sur un autre noeud avant de
+lancer d'autres commandes (par exemple, <xref
+ linkend="stmtsubscribeset"/>).
+<command>WAIT FOR EVENT</command> peut être utilisé pour demander à un
+script <application>slonik</application> d'attendre jusqu'à ce que le noeud abonné
+soit prêt pour l'action suivante.
</para>
- <para> <command>WAIT FOR EVENT</command> must be called outside of
- any <command>try</command> block in order to work, since new
- confirm messages don't become visible within a transaction.
+ <para> <command>WAIT FOR EVENT</command> doit être appelée en dehors d'un
+bloc <command>try</command>, car les nouvaux messages de confirmation ne sont
+pas visibles à l'intérieur d'une transaction.
<variablelist>
<varlistentry><term><literal> ORIGIN = ival | ALL </literal></term>
- <listitem><para> The origin of the event(s) to wait for.</para></listitem>
+ <listitem><para> L'origine de l'événement qu'il faut attendre.</para></listitem>
</varlistentry>
<varlistentry><term><literal> CONFIRMED = ival | ALL </literal></term>
- <listitem><para> The node ID of the receiver that must confirm the event(s).</para></listitem>
+ <listitem><para> L'identifiant du noeud recepteur qui doit confirmer le(s)
+événement(s).
+</para></listitem>
</varlistentry>
<varlistentry><term><literal> WAIT ON = ival </literal></term>
- <listitem><para> The ID of the node where the &slconfirm; table
- is to be checked. The default value is 1.</para></listitem>
+ <listitem><para> L'identifiant du noeud ou la table &slconfirm; est vérifiée.
+La valeur par défaut est 1.</para></listitem>
</varlistentry>
<varlistentry><term><literal> TIMEOUT = ival </literal></term>
- <listitem><para> The number of seconds to wait. Default is 600
- (10 minutes). <command>TIMEOUT = 0</command> causes the script
- to wait indefinitely.</para></listitem>
+ <listitem><para> Le nombre de secondes d'attente. La valeur par défaut est 600
+ (10 minutes). <command>TIMEOUT = 0</command> implique que le script attend
+indéfiniment.</para></listitem>
</varlistentry>
</variablelist></para>
@@ -2839,25 +2845,25 @@
<para> Cette commande fut introduite dans &slony1; 1.0 </para>
</refsect1>
- <refsect1> <title> Oddities </title> <para> Not all events return
- interesting results. For instance, many people have run afoul of
- problems with <xref linkend="stmtsubscribeset"/>, when subscribing a
- new set. Be aware (and beware!) that a <xref
- linkend="stmtsubscribeset"/> request will return the event
- confirmation almost immediately, even though there might be several
- hours of work to do before the subscription is ready. The trouble
- with <xref linkend="stmtsubscribeset"/> is that it is processed as
- <emphasis>two</emphasis> events, one on the origin node, with a
- second event, to enable the subscription, on the subscriber.
+ <refsect1> <title> Bizarreries </title>
+<para> Tous les événements ne retournent pas forcément des résultats intéressants.
+Par exemple, beaucoup de gens ont rencontré énormément de problèmes avec
+<xref linkend="stmtsubscribeset"/>, lorsqu'il abonnait un nouvel ensemble.
+Soyez conscient que la requête <xref linkend="stmtsubscribeset"/> va retourner
+la confirmation d'événement presque immédiatement, même si il reste plusieurs heures
+de travail avant que l'abonnement soit achevé. Le problème avec
+ avec <xref linkend="stmtsubscribeset"/> est qui est traité par
+<emphasis>deux</emphasis> événements, un sur le noeud origine, et un second événement
+ qui met en place l'abonnement sur l'abonné.
</para>
- <para> In order to more reliably monitor from within a <xref
- linkend="slonik"/> script that <xref linkend="stmtsubscribeset"/> is
- complete, you may submit a <xref linkend="stmtsync"/> event after
- the subscription, and have the WAIT request wait on that
- <command>SYNC</command> event, as follows. </para>
+ <para> Afin surveiller plus étroitement à l'intérieur du script <xref
+ linkend="slonik"/> que l'instruction <xref linkend="stmtsubscribeset"/>
+est complète, vous pouvez soumettre un événement <xref linkend="stmtsync"/>
+après l'abonnement, et lancer une requête WAIT sur ce
+ <command>SYNC</command>, de la manière suivante : </para>
<programlisting>
- # Assuming that set 1 has direct subscribers 2 and 3
+ # Supposons que l'ensemble 1 a deux abonnés direct 2 et 3
SUBSCRIBE SET (ID = 999, PROVIDER = 1, RECEIVER = 2);
SYNC (ID=1);
WAIT FOR EVENT (ORIGIN = 1, CONFIRMED = 2, WAIT FOR=1);
@@ -2877,7 +2883,9 @@
<refnamediv><refname>REPAIR CONFIG</refname>
- <refpurpose> Resets the name-to-oid mapping of tables in a replication set, useful for restoring a node after a <application>pg_dump</application>. </refpurpose></refnamediv>
+ <refpurpose> Remet à zéro les tables de correspondance entre les noms et les OID pour un
+ensemble de réplication, utile lorsque l'on restaure un noeud après un
+<application>pg_dump</application>. </refpurpose></refnamediv>
<refsynopsisdiv>
<cmdsynopsis>
<command>REPAIR CONFIG (options);</command>
@@ -2886,23 +2894,23 @@
<refsect1>
<title>Description</title>
- <para> Resets name-to-oid mapping.</para>
+ <para> Remet à zéro la correspondance entre noms et OIDs.</para>
<variablelist>
<varlistentry><term><literal> SET ID = ival </literal></term>
- <listitem><para> Which set to clean up after.</para></listitem>
+ <listitem><para> Le numéro de l'ensemble à nettoyer.</para></listitem>
</varlistentry>
<varlistentry><term><literal> EVENT NODE = ival </literal></term>
- <listitem><para> The node ID where this should be submitted.</para></listitem>
+ <listitem><para> L'identifiant du noeud ou la commande doit être soumise.</para></listitem>
</varlistentry>
<varlistentry><term><literal> EXECUTE ONLY ON = ival </literal></term>
- <listitem><para> The ID of the only node where the mappings are
- to be updated. If not specified, the default is to execute
- this on all nodes subscribed to the set.</para></listitem>
+ <listitem><para> L'identifiant du seul noeud ou la correspondance est mise à jour
+. Si cette valeur n'est pas précisée, par défaut on exécute la commande sur tous les noeuds abonnés
+à l'ensemble.</para></listitem>
</varlistentry>
</variablelist>
@@ -2931,7 +2939,7 @@
<refnamediv><refname>SYNC</refname>
- <refpurpose> Generate an ordinary SYNC event </refpurpose></refnamediv>
+ <refpurpose> Cette commande produit un événement SYNC ordinaire </refpurpose></refnamediv>
<refsynopsisdiv>
<cmdsynopsis>
<command>SYNC (options);</command>
@@ -2940,11 +2948,11 @@
<refsect1>
<title>Description</title>
- <para> Generates a SYNC event on a specified node.</para>
+ <para> Cette commande génère un événement SYNC sur un noeud donné.</para>
<variablelist>
<varlistentry><term><literal> ID = ival </literal></term>
- <listitem><para> The node on which to generate the SYNC event.</para></listitem>
+ <listitem><para> Le noeud sur lequel on génère l'événement SYNC.</para></listitem>
</varlistentry>
</variablelist>
@@ -2974,7 +2982,7 @@
<refnamediv><refname>SLEEP</refname>
- <refpurpose> Sleep using system <function>sleep()</function> </refpurpose>
+ <refpurpose> S'endormir avec la fonction système <function>sleep()</function> </refpurpose>
</refnamediv>
<refsynopsisdiv>
<cmdsynopsis>
@@ -2985,7 +2993,7 @@
<refsect1>
<title>Description</title>
<para>
- Sleeps for the specified number of seconds.
+ Cette commande endors les opérations pendant un certain nombre de secondes.
</para>
</refsect1>
<refsect1><Title>Example</Title>
@@ -3003,7 +3011,7 @@
<refnamediv><refname>CLONE PREPARE</refname>
- <refpurpose> Prepare for cloning a node. </refpurpose>
+ <refpurpose> Prepare le clonage d'un node. </refpurpose>
</refnamediv>
<refsynopsisdiv>
<cmdsynopsis>
@@ -3016,24 +3024,24 @@
<refsect1>
<title>Description</title>
<para>
- Prepares for cloning a specified node.
+ Cette commande prépare le clonage d'un noeud donné.
</para>
<para>
- This duplicates the <quote>provider</quote> node's configuration
- under a new node ID in preparation for the node to be copied via
- standard database tools.
+ Ceci duplique la configuration d'un noeud <quote>fournisseur</quote>
+ sous un nouvel identifiant en préparation de la copie de ce noeud
+ via un outil standard.
</para>
- <para> Note that in order that we be certain that this new node be
- consistent with all nodes, it is important to issue a SYNC event
- against every node aside from the provider and wait to start
- copying the provider database at least until all those SYNC events
- have been confirmed by the provider. Otherwise, it is possible
- for the clone to miss some events. </para>
+ <para> Notez que pour être certain que ce nouveau noeud est cohérent avec
+tous les noeuds, il est important de lancer un événement SYNC sur tous les
+noeuds à l'exception du fournisseur et d'attendre que tous ces événements
+SYNC soient confirmés avant de copier la base fournisseur.
+Sinon il est possible que le clone est raté des événements.
+ </para>
</refsect1>
- <refsect1><Title>Example</Title>
+ <refsect1><Title>Exemple</Title>
<Programlisting>
clone prepare (id = 33, provider = 22, comment='Clone 33');
sync (id=11);
@@ -3051,7 +3059,7 @@
<refnamediv><refname>CLONE FINISH</refname>
- <refpurpose> Complete cloning a node. </refpurpose>
+ <refpurpose> Termine le clonage d'un noeud. </refpurpose>
</refnamediv>
<refsynopsisdiv>
<cmdsynopsis>
@@ -3063,17 +3071,17 @@
<refsect1>
<title>Description</title>
<para>
- Finishes cloning a specified node.
+ Cette commande achève le clonage sur un noeud donné.
</para>
<para>
- This completes the work done by <xref
- linkend="stmtcloneprepare"/>, establishing confirmation data for
- the new <quote>clone</quote> based on the status found for the
- <quote>provider</quote> node.
+ Ceci complète le travail effectué par <xref
+ linkend="stmtcloneprepare"/>, en établissant les données de confirmation
+pour le nouveau <quote>clone</quote> à partir du statut trouvé pour le
+noeud <quote>fournisseur</quote>.
</para>
</refsect1>
- <refsect1><Title>Example</Title>
+ <refsect1><Title>Exemple</Title>
<Programlisting>
clone finish (id = 33, provider = 22);
</Programlisting>
More information about the Trad
mailing list