[Trad] [svn:pgfr] r1087 - traduc/trunk/slony
svncommit at kryskool.org
svncommit at kryskool.org
Jeu 3 Juil 11:08:19 CEST 2008
Auteur: daamien
Date: 2008-07-03 11:08:14 +0200 (jeu, 03 jui 2008)
Nouvelle Révision: 1087
Modification:
traduc/trunk/slony/slonik_ref.xml
Log:
Slony : slonik_ref.xml : traduction en cours (1/3)
Modified: traduc/trunk/slony/slonik_ref.xml
===================================================================
--- traduc/trunk/slony/slonik_ref.xml 2008-07-03 09:04:52 UTC (rev 1086)
+++ traduc/trunk/slony/slonik_ref.xml 2008-07-03 09:08:14 UTC (rev 1087)
@@ -5,80 +5,84 @@
révision $Revision$ -->
<article id="slonikref">
-<title>Slonik Command Summary</title>
+<title>Tour d'horizon des commandes Slonik</title>
<sect1><title>Introduction</title>
<para>
- <application>Slonik</application> is a command line utility designed
- specifically to setup and modify configurations of the
- &slony1; replication system.
+ <application>Slonik</application> est un utilitaire en ligne de commande
+ conçu spécifiquement pour mettre en place et modifier la configuration
+ d'un système de réplication &slony1;.
</para>
<sect2 id="outline">
- <title>General outline</title>
+ <title>Considérations générales</title>
<para>
- The <application>slonik</application> commandline utility is
- supposed to be used embedded into shell scripts and reads
- commands from files or stdin (via here documents for
- example). Nearly all of the <emphasis>real</emphasis>
- configuration work is done by calling stored procedures after
- loading the &slony1; support base into
- a database. You may find documentation for those procedures in
- the <ulink url="schemadoc">&slony1;
- Schema Documentation</ulink>, as well as in comments associated
- with them in the database.
+ L'utilitaire en ligne de commande <application>slonik</application>
+ est suppposé être intégré dans des scripts shell et lit
+ les commandes à partir d'un fichier ou de stdin ( voir plus
+ bas pour des exemples ). Presque tout le travail de configuration
+ <emphasis>réel</emphasis> est effectué en appelant des procédures
+ stockées après avoir chargé la base de support &slony1; dans
+ la base de données. Vous pouvez trouver de la documentation sur
+ ces procédures dans le chapitre <ulink url="schemadoc">&slony1;
+ Documentation du Schéma</ulink>, ainsi que dans les commentaires
+ qui sont associé aux procédures dans la base de données.
</para>
<para>
- <application>Slonik</application> was created because:
+ <application>Slonik</application> a été créé car:
<itemizedlist>
- <listitem><para>The stored procedures have special requirements
- as to on which particular node in the replication system they
- are called,</para></listitem>
+ <listitem><para>Les procédures stockées ont des besoin d'informations
+ spécifiques telles que l'identifiant du noeud de réplication
+ sur lequel elles sont appelées;</para></listitem>
- <listitem><para>The lack of named parameters for stored
- procedures makes it rather difficult to do this from the
- <application>psql</application> prompt, and</para></listitem>
+ <listitem><para>L'absence de paramètres nommés dans les
+ procédures stocées rend difficile de faire cela depuis
+ l'invite de commande <application>psql</application>;
+ </para></listitem>
- <listitem><para><application>psql</application>lacks the ability
- to maintain multiple connections with open
- transactions.</para></listitem>
+ <listitem><para><application>psql</application>n'a pas la possibilité
+ de maintenir plusieurs connexions avec des transactions ouvertes.
+ </para></listitem>
</itemizedlist>
</para>
<para>
</para>
- <sect3><title>Commands</title>
+ <sect3><title>Commandes</title>
<para>
- The slonik command language is format free. Commands begin with
- keywords and are terminated with a semicolon. Most commands have
- a list of parameters, some of which have default values and are
- therefore optional. The parameters of commands are enclosed in
- parentheses. Each option consists of one or more keywords,
- followed by an equal sign, followed by a value. Multiple options
- inside the parentheses are separated by commas. All keywords are
- case insensitive. The language should remind the reader of SQL.
+ Le format du langage de commande slonik est libre.
+ Les commandes commence par des mots-clefs et sont terminées
+ par un point-virgule. La pluspart des commande ont une liste de
+ paramètres, certains ont une valeur par défaut et sont donc
+ facultatifs. Les paramètres de commandes sont entourés par des
+ parenthèses. Chaque option est constituée d'un ou plusieurs
+ mots-clefs, suivis d'un symbole égal, suivi d'une valeur. Les
+ optons multiples à l'intérieur de parenthèses sont séparées par
+ des virgules. Tous les mot-clefs sont sensibles à la casse. Le
+ langage devrait rappeler le SQL.
</para>
<para>
- Option values may be:
+ Les valeurs d'option peuvent être :
<itemizedlist>
- <listitem><para>integer values</para></listitem>
- <listitem><para>string literals enclosed in single quotes</para></listitem>
- <listitem><para>boolean values {TRUE|ON|YES} or {FALSE|OFF|NO}</para></listitem>
- <listitem><para>keywords for special cases</para></listitem>
+ <listitem><para>des entiers;</para></listitem>
+ <listitem><para>des chaines caractères entourés de quotes;</para></listitem>
+ <listitem><para>des valeurs booléennes {TRUE|ON|YES} ou {FALSE|OFF|NO};</para></listitem>
+ <listitem><para>des mots-clefs dans des cas spécifiques</para></listitem>
</itemizedlist>
</para></sect3>
- <sect3><title>Comments</title>
+ <sect3><title>Commentaires</title>
<para>
- Comments begin at a hash sign (#) and extend to the end of the line.
+ Les commentaires commencent par un dièse (#) et vont jusqu'à la fin de la ligne.
</para></sect3>
- <sect3><title>Command groups</title>
+ <sect3><title>Groupes de commandes</title>
<para>
- Commands can be combined into groups of commands with optional
- <command>on error</command> and <command>on success</command> conditionals.
- The syntax for this is:
+ Les commandes peuvent être combinées par groupes de commandres avec une
+ éventuellement une condition <command>on error</command> et
+ <command>on success</command>.
+ La syntaxe est la suivante :
<programlisting>
try {
commands;
@@ -87,19 +91,20 @@
[on success { commands; }
</programlisting></para>
- <para> Those commands are grouped together into one transaction
- per participating node. </para>
+ <para> Ces commandes sont regroupées ensemble au sein d'une transaction
+ pour chaque noeud participant.</para>
<!-- ************************************************************ --></sect3></sect2></sect1></article>
<reference id="metacmds">
- <title>Slonik Meta Commands</title>
+ <title>Meta-commandes Slonik</title>
<partintro>
<para>
- The following commands may be used to somewhat abstract the
- definitions of components of Slonik scripts; <xref
- linkend="stmtinclude"/> grouping configuration into central files
- that may be reused, and <xref linkend="stmtdefine"/> allowing
- mnemonic identifiers to replace cryptic numeric object IDs.
+ Les commandes suivantes sont utilisées pour séparer
+ les définitions des composants des scripts Slonik;
+ <xref linkend="stmtinclude"/> regroupe la configuration
+ dans des fichiers centraux qui peuvent être réutilisés, et
+ <xref linkend="stmtdefine"/> permet de remplacer les identifiants
+ numérique et esotérique des objets par des identifiants mnémotechniques.
</para>
</partintro>
<!-- **************************************** -->
@@ -108,35 +113,35 @@
<refnamediv><refname>INCLUDE</refname>
- <refpurpose> pulling in slonik code from another file </refpurpose>
+ <refpurpose> insérer du code slonik à partir d'un autre fichier </refpurpose>
</refnamediv>
<refsynopsisdiv>
<cmdsynopsis>
<command>include </command>
- <arg><replaceable class="parameter"> <pathname></replaceable></arg>
+ <arg><replaceable class="parameter"> <chemin></replaceable></arg>
</cmdsynopsis>
</refsynopsisdiv>
<refsect1>
<title>Description</title>
<para>
- This draws the specified slonik script inline into the present
- script. If the <option>pathname</option> specifies a relative
- path, <xref linkend="slonik"/> will search relative to the
- current working directory.
+ Ceci injecte le script slonik spécifié à l'intérieur du script actuel.
+ Si le <option>chemin</option> est relatif, <xref linkend="slonik"/>
+ cherchera à partir du répertoire de travail.
</para>
<para>
- Nested include files are supported. The scanner and parser
- report the proper file names and line numbers when they run into
- an error. </para>
+ Les inclusions imbriquées sont supportées. Le scanner et l'analyser
+ retourne le bon nom de fichier et le numéro ligne correcten cas
+ d'erreur.
+ </para>
</refsect1>
- <refsect1><title>Example</title>
+ <refsect1><title>Exemple</title>
<programlisting>
include </tmp/preamble.slonik>;
</programlisting>
</refsect1>
- <refsect1> <title> Version Information </title>
- <para> This command was introduced in &slony1; 1.1 </para>
+ <refsect1> <title> Note de version </title>
+ <para> Cette commande fut introduite dans &slony1; 1.1 </para>
</refsect1>
</refentry>
<!-- **************************************** -->
@@ -145,37 +150,37 @@
<refnamediv><refname>DEFINE</refname>
- <refpurpose> Defining a named symbol </refpurpose>
+ <refpurpose> Définir un nom symbolique </refpurpose>
</refnamediv>
<refsynopsisdiv>
<cmdsynopsis>
<command>define </command>
- <arg><replaceable class="parameter"> name </replaceable></arg>
- <arg><replaceable class="parameter"> value </replaceable></arg>
+ <arg><replaceable class="parameter"> nom </replaceable></arg>
+ <arg><replaceable class="parameter"> valeur </replaceable></arg>
</cmdsynopsis>
</refsynopsisdiv>
<refsect1>
<title>Description</title>
<para>
- This defines a named symbol. Symbol names must follow the
- slonik rules for constructing identifiers, by starting with a
- letter, followed by letters, numbers, and underscores.
+ Ceci définit un nom symbolique. Les noms symboliques doivent
+ respecter les règles de slonik en matière de construction d'identifiant,
+ en commençant par une lettre, suivie de lettres, de nombres et de soulignés ("_").
</para>
<para>
- Symbol values may contain spaces and may recursively contain
- symbol references.
+ Les valeurs des noms symboliques peuvent contenir des espaces et peuvent contenir
+ des références à des noms symboliques, de manière récursive.
</para>
<para>
- Symbols are referenced by using a <quote>@</quote> followed by
- the symbol name. Note that symbol referencing is suppressed
- inside string literals.
+ Les symboles sont réferencés en utilisant une arobase <quote>@</quote> suivi
+ du nom symbolique. Notons que le référencement d'un symbole est annulé
+ à l'intérieur des chaines de caractères.
</para>
</refsect1>
- <refsect1><title>Example</title>
+ <refsect1><title>Exemple</title>
<programlisting>
-define cluster movies;
+define cluster films;
define sakai 1;
define chen 2;
define fqn fully qualified name;
@@ -183,21 +188,21 @@
cluster name = @cluster;
node @sakai admin conninfo = 'service=sakai-replication';
node @chen admin conninfo = 'service=chen-replication';
-define setMovies id = 1;
-define sakaiMovies @setMovies, origin = @sakai;
+define setFilms id = 1;
+define sakaiFilms @setFilms, origin = @sakai;
-create set ( @sakaiMovies, comment = 'movies' );
+create set ( @sakaiFilms, comment = 'films' );
-set add table( set @sakaiMovies, id = 1, @fqn = 'public.customers',
+set add table( set @sakaiFilms, id = 1, @fqn = 'public.clients',
comment = 'sakai customers' );
-set add table( set @sakaiMovies, id = 2, @fqn = 'public.tapes',
- comment = 'sakai tapes' );
-echo 'But @sakaiMovies will display as a string, and is not expanded';
+set add table( set @sakaiFilms, id = 2, @fqn = 'public.cassettes',
+ comment = 'sakai cassettes' );
+echo '@sakaiFilms sera affiché comme une chaine, et ne sera pas interprété';
</programlisting>
</refsect1>
- <refsect1> <title> Version Information </title>
- <para> This command was introduced in &slony1; 1.1 </para>
+ <refsect1> <title> Note de version </title>
+ <para> Cette commande fut introduite dans &slony1; 1.1 </para>
</refsect1>
</refentry>
@@ -206,14 +211,13 @@
<!-- **************************************** -->
<reference id="hdrcmds">
- <title>Slonik Preamble Commands</title>
+ <title>Commandes slonik préliminaires</title>
<partintro>
<para>
- The following commands must appear as a <quote>preamble</quote> at
- the beginning of each <application>slonik</application> command
- script. They do not cause any direct action on any of the nodes in
- the replication system, but affect the execution of the entire
- script.
+ Les commandes suivantes doivent apparaître en <quote>préambule</quote> au
+ de chaque script de commande <application>slonik</application>.
+ Ils ne provoque aucune action directement sur les noeuds du
+ système de réplication, mais affecte l'exécution du script tout entier.
</para>
</partintro>
<!-- **************************************** -->
@@ -223,44 +227,43 @@
<refnamediv><refname>CLUSTER NAME</refname>
- <refpurpose> preamble - identifying &slony1; cluster </refpurpose>
+ <refpurpose> préambule - identifier le cluster &slony1; </refpurpose>
</refnamediv>
<refsynopsisdiv>
<cmdsynopsis>
<command>CLUSTER NAME = </command>
- <arg><replaceable class="parameter"> clustername;</replaceable></arg>
+ <arg><replaceable class="parameter"> nom;</replaceable></arg>
</cmdsynopsis>
</refsynopsisdiv>
<refsect1>
<title>Description</title>
<para>
- Must be the very first statement in every
- <application>slonik</application> script. It defines the
- namespace in which all &slony1;
- specific functions, procedures, tables and sequences are
- defined. The namespace name is built by prefixing the given
- string literal with an underscore. This namespace will be
- identical in all databases that participate in the same
- replication group.
+ Ceci doit être la toute première ligne de chaque script
+ <application>slonik</application>. Elle définit l'espace
+ de nom dans lequel toutes les fonctions spécifiques, les procédures,
+ les tables et les séquences de &slony1; sont déclarées.
+ Le nom de l'espace de nom est construit en préfixant le chaine
+ de caractère fournie par un souligné. Ce nom d'espace sera
+ identique sur toutes les bases de données qui participent
+ aux même groupe de réplication.
</para>
<para>
- No user objects are supposed to live in this namespace, and the
- namespace is not allowed to exist prior to adding a database to
- the replication system. Thus, if you add a new node using
- <command> pg_dump -s </command> on a database that is already in
- the cluster of replicated databases, you will need to drop the
- namespace via the SQL command <command> DROP SCHEMA _testcluster
- CASCADE; </command>.
+ Aucun objet utilisateur n'est supposé être placé dans cet espace de nom,
+ et l'espace de nom ne doit exister avant l'ajout de la base de données
+ dans le système de réplication. Ainsi, si vous ajouter un nouveau noeud
+ en utilisant <command> pg_dump -s </command> sur une base qui est déjà
+ dans le cluster de réplication, vous devrez supprimer l'espace de nom
+ avec la commande SQL<command> DROP SCHEMA _testcluster CASCADE; </command>.
</para>
</refsect1>
- <refsect1><title>Example</title>
+ <refsect1><title>Exemple</title>
<programlisting>
CLUSTER NAME = testcluster;
</programlisting>
</refsect1>
- <refsect1> <title> Version Information </title>
- <para> This command was introduced in &slony1; 1.0 </para>
+ <refsect1> <title> Note de version </title>
+ <para> Cette commande fut introduite dans &slony1; 1.0 </para>
</refsect1>
</refentry>
@@ -271,7 +274,7 @@
<manvolnum>7</manvolnum></refmeta>
<refnamediv><refname>ADMIN CONNINFO</refname>
- <refpurpose> preamble - identifying &postgres; database </refpurpose>
+ <refpurpose> preambule - identifier la base &postgres;</refpurpose>
</refnamediv>
<refsynopsisdiv>
<cmdsynopsis>
@@ -283,56 +286,53 @@
<refsect1>
<title>Description</title>
<para>
- Describes how the <application>slonik</application> utility can
- reach a nodes database in the cluster from where it is run
- (likely the DBA's workstation). The conninfo string is the string
- agrument given to the <function>PQconnectdb()</function> libpq
- function. The user used to connect must be the special
- replication superuser, as some of the actions performed later may
- include operations that are strictly reserved for database
- superusers by &postgres;.
+ Décrit comment l'utilitaire <application>slonik</application> peut
+ atteindre les bases des noeuds du cluster à partir du l'endroit
+ où il se trouve (en général le poste de travail de l'administrateur)
+ La chaine connifo est l'argument passé à la fonction
+ libpq <function>PQconnectdb()</function>. L'utlisateur qui se connecter
+ doit être un super-utilisateur spécifique à la réplication, car certaines
+ actions réalisées par la suite comprennent des opérations strictement réservées
+ aux super-utilisateurs du serveur &postgres;.
</para>
<para>
- The <application>slonik</application> utility will not try to
- connect to a given database unless some subsequent command
- requires the connection.
+ L'utilitaire <application>slonik</application> n'essaie pas de se connecter
+ à une base de donnnée que si un commande nécessite une connexion.
</para>
<note> <para>
- As mentioned in the original documents,
- &slony1; is designed as an enterprise
- replication system for data centers. It has been assumed
- throughout the entire development that the database servers and
- administrative workstations involved in replication and/or setup
- and configuration activities can use simple authentication
- schemes like <quote>trust</quote>. Alternatively, libpq can read
- passwords from <filename> .pgpass </filename>.
+ Comme indique dans les document originaux, &slony1; est conçu comme
+ une système de réplication d'entreprises pour datacenters. Lors du développement
+ du logiciel, on présuppose que les serveurs de bases de données et les postes
+ de travail impliqués dans la réplication et/ou dans les activités de mise en place et
+ de configuration peuvent utiliser des méthodes simples d'authentification telle que
+ <quote>trust</quote>. Cependant, libpq peut lire les mots de passe dans le fichier
+ <filename> .pgpass </filename>.
</para>
</note>
<note>
<para>
- If you need to change the DSN information for a node, as would
- happen if the IP address for a host were to change, you must
- submit the new information using the <xref
- linkend="stmtstorepath"/> command, and that configuration will be
- propagated. Existing <application> slon </application> processes
- may need to be restarted in order to become aware of the
- configuration change.
+ Si vous devez changer les informations DSN pour un noeud, par exemple si
+ l'adresse IP d'un hôte est modifiée, vous devez soumettre cette nouvelle
+ information avec la commande <xref linkend="stmtstorepath"/>,
+ et la configuration sera propagée. Certains processus
+ <application> slon </application> existant devront être relancés afin qu'il
+ soient avertis de ce changement de configuration.
</para>
</note>
- <para> For more details on the distinction between this and <xref
- linkend="stmtstorepath"/>, see &rplainpaths;.</para>
+ <para>Pour plus de détails sur la distinction entre ceci et <xref
+ linkend="stmtstorepath"/>, consultez le chapitre &rplainpaths;.</para>
</refsect1>
- <refsect1><title>Example</title>
+ <refsect1><title>Exemple</title>
<programlisting>
NODE 1 ADMIN CONNINFO = 'dbname=testdb host=server1 user=slony';
</programlisting>
</refsect1>
- <refsect1> <title> Version Information </title>
- <para> This command was introduced in &slony1; 1.0 </para>
+ <refsect1> <title> Note de version </title>
+ <para> Cette commande fut introduite dans &slony1; 1.0 </para>
</refsect1>
</refentry>
</reference>
@@ -340,7 +340,7 @@
<!-- **************************************** -->
<reference id="cmds">
- <title>Configuration and Action commmands</title>
+ <title>Commande de configuration et d'action</title>
<!-- **************************************** -->
<refentry id ="stmtecho"><refmeta><refentrytitle>ECHO</refentrytitle>
@@ -348,27 +348,27 @@
<refnamediv><refname>ECHO</refname>
- <refpurpose> Generic output tool </refpurpose>
+ <refpurpose> Outil générique de sortie </refpurpose>
</refnamediv>
<refsynopsisdiv>
<cmdsynopsis>
<command>echo </command>
- <arg><replaceable class="parameter"> 'string'</replaceable></arg>
+ <arg><replaceable class="parameter"> 'message'</replaceable></arg>
</cmdsynopsis>
</refsynopsisdiv>
<refsect1>
<title>Description</title>
<para>
- Prints the string literal on standard output.
+ Affiche un message litéral sur la sortie standard.
</para>
</refsect1>
<refsect1><Title>Example</Title>
<programlisting>
- ECHO 'Node 1 initialized successfully';
+ ECHO 'Noeud 1 initialisé correctement';
</programlisting>
</refsect1>
- <refsect1> <title> Version Information </title>
- <para> This command was introduced in &slony1; 1.0 </para>
+ <refsect1> <title> Note de version </title>
+ <para> Cette commande fut introduite dans &slony1; 1.0 </para>
</refsect1>
</refentry>
@@ -379,7 +379,7 @@
<refnamediv><refname>EXIT</refname>
- <refpurpose> Terminate Slonik script with signal </refpurpose>
+ <refpurpose> Termine un script Slonik avec un signal </refpurpose>
</refnamediv>
<refsynopsisdiv>
<cmdsynopsis>
@@ -390,10 +390,10 @@
<refsect1>
<title>Description</title>
<para>
- Terminates script execution immediately, rolling back every
- open transaction on all database connections. The
- <application>slonik</application> utility
- will return the given value as its program termination code.
+ termine immédiatement un script d'éxecution, annulant toute
+ les transaction ouverte (roll back) sur toutes les bases de données
+ connectées. L'utilitaire <application>slonik</application> retournera
+ la valeur indiquée comme code de terminaison du programme.
</para>
</refsect1>
<refsect1><Title>Example</Title>
@@ -401,8 +401,8 @@
EXIT 0;
</programlisting>
</refsect1>
- <refsect1> <title> Version Information </title>
- <para> This command was introduced in &slony1; 1.0 </para>
+ <refsect1> <title> Note de version </title>
+ <para> Cette commande fut introduite dans &slony1; 1.0 </para>
</refsect1>
</refentry>
@@ -414,77 +414,74 @@
</refmeta>
<refnamediv>
<refname>INIT CLUSTER</refname>
- <refpurpose>Initialize &slony1; cluster</refpurpose></refnamediv>
+ <refpurpose>Initialise le cluster &slony1;</refpurpose></refnamediv>
<refsynopsisdiv>
<cmdsynopsis>
<command>INIT CLUSTER</command>
- <arg>ID = <replaceable class="parameter">integer</replaceable></arg>
- <arg>COMMENT = <replaceable class="parameter">'string'</replaceable></arg>
+ <arg>ID = <replaceable class="parameter">entier</replaceable></arg>
+ <arg>COMMENT = <replaceable class="parameter">'chaine'</replaceable></arg>
</cmdsynopsis>
</refsynopsisdiv>
<refsect1>
<title>Description</title>
- <para> Initialize the first node in a new &slony1; replication
- cluster. The initialization process consists of creating the
- cluster namespace, loading all the base tables, functions,
- procedures and initializing the node, using
- &funinitializelocalnode; and &funenablenode;.
+ <para> Initialise le premier noeud d'un nouveau cluster de réplication &slony1;.
+ Le processus d'initialisation consiste à créer l'espace de nom du cluster,
+ charger toutes les tables, les functions, les procédures et initialiser le noeud
+ avec &funinitializelocalnode; and &funenablenode;.
<variablelist>
<varlistentry><term><literal>ID</literal></term>
- <listitem><para>The unique, numeric ID number of the node.</para></listitem>
+ <listitem><para>L'identifiant numérique et unique du noeud.</para></listitem>
</varlistentry>
- <varlistentry><term><literal>COMMENT = 'comment
- text'</literal></term> <listitem><para> A descriptive text added
- to the node entry in the table &slnode;.
+ <varlistentry><term><literal>COMMENT = 'commentaire'</literal></term>
+ <listitem><para> Un texte descriptif ajouté à la ligne du noeud dans
+ la table &slnode;.
</para></listitem>
</varlistentry>
</variablelist>
</para>
- <para> For this process to work, the SQL scripts of the
- &slony1; system must be installed on the
- DBA workstation (the computer currently executing the
- <application>slonik</application> utility), while on the system
- where the node database is running the shared objects of the
- &slony1; system must be installed in the
- &postgres; library directory. Also the procedural language
- PL/pgSQL is assumed to already be installed in the target
- database.</para>
+ <para> Pour que ce processus fonctionne, les scripts SQL du système
+ &slony1; doivent être installés sur le poste de travail de l'administrateur
+ (l'ordinateur utilisé pour exécuter l'utilitaire <application>slonik</application>),
+ tandis que sur le serveur qui héberge le noeud de base de donnée contenant les
+ objets partagés, &slony1; doit être installé dans le répertoire qui contient
+ les librairies de &postgres;. De plus le langage procédural
+ PL/pgSQL dit être installé au préalable sur la base de données cible.
+ </para>
</refsect1>
<refsect1>
- <title>Example</title>
+ <title>Exemple</title>
<programlisting>
INIT CLUSTER (
ID = 1,
- COMMENT = 'Node 1'
+ COMMENT = 'Noeud 1'
);
</programlisting>
- <note> <para> This command functions very similarly to <xref
- linkend="stmtstorenode"/>, the difference being that <command>INIT
- CLUSTER </command> does not need to draw configuration from other
- existing nodes.
-
+ <note> <para> Cette commande fonctionne de manière similaire à
+ <xref linkend="stmtstorenode"/>, la différence étant que <command>INIT
+ CLUSTER </command> n'a pas besoin de récupérer la configuration des autres noeuds.
</para> </note>
- <note> <para> Be aware that some objects are created that contain
- the cluster name as part of their name. (Notably, partial indexes
- on <envar>sl_log_1</envar> and <envar>sl_log_2</envar>.) As a
- result, <emphasis>really long</emphasis> cluster names are a bad
- idea, as they can make object names <quote>blow up</quote> past the
- typical maximum name length of 63 characters. </para> </note>
+ <note> <para> Soyez conscients que certains objets qui sont créés contiennet
+ le nom du cluster à l'intérieur de leur nom (Notamment, les index
+ partiels sur <envar>sl_log_1</envar> et <envar>sl_log_2</envar>).
+ Ceci implique que les noms de cluster <emphasis>très longs</emphasis>
+ sont une mauvaise idée, car ils entrainent un dépassement des noms
+ d'objets au delà de la limite de 63 caractères.
+ </para> </note>
</refsect1>
- <refsect1> <title> Locking Behaviour </title>
+ <refsect1> <title> Utilisation de verrous </title>
- <para> This command creates a new namespace and configures tables
- therein; no public objects should be locked during the duration of
- this.</para>
+ <para> Cette commande crée un nouvel espace de noms et configure les
+ tables à l'intérieur; aucun objets public ne doit être verrouiller
+ pendant l'exécution de cette commade.</para>
</refsect1>
- <refsect1> <title> Version Information </title>
- <para> This command was introduced in &slony1; 1.0 </para>
+ <refsect1> <title> Note de version </title>
+ <para> Cette commande fut introduite dans &slony1; 1.0 </para>
</refsect1>
</refentry>
@@ -494,7 +491,7 @@
<manvolnum>7</manvolnum></refmeta>
<refnamediv><refname>STORE NODE</refname>
- <refpurpose> Initialize &slony1; node </refpurpose>
+ <refpurpose> Initialis un noeud &slony1;</refpurpose>
</refnamediv>
<refsynopsisdiv>
<cmdsynopsis>
@@ -504,62 +501,62 @@
<refsect1>
<title>Description</title>
- <para> Initialize a new node and add it to the configuration of an
- existing cluster.</para>
+ <para> Initialise un nouveau noeud et l'ajoute dans la configuation du
+ cluster existant.</para>
- <para> The initialization process consists of creating the cluster
- namespace in the new node (the database itself must already
- exist), loading all the base tables, functions, procedures and
- initializing the node. The existing configuration of the rest of
- the cluster is copied from the <quote>event node</quote>.
+ <para> Le processus d'initialisation consiste à la création de l'espace
+ de noms sur le nouveau noeud ( la base elle-même doit déjà exister ),
+ charger les tables, les fonctions, les procédures et initialiser le
+ noeud. La configuration existante du reste du noeud est copiée à
+ partir d'un <quote>node d'événement</quote>.
<variablelist>
<varlistentry><term><literal>ID = ival</literal></term>
- <listitem><para> The unique, numeric ID number of the new
- node.</para></listitem>
+ <listitem><para> L'identifiant numérique et unique du nouveau noeud.</para></listitem>
</varlistentry>
<varlistentry><term><literal> COMMENT = 'description' </literal></term>
- <listitem><para> A descriptive text added to the node entry in the table &slnode;</para></listitem>
+ <listitem><para> Un texte descriptif ajouté à la ligne du noeud dans
+ la table &slnode;</para></listitem>
</varlistentry>
- <varlistentry><term><literal> SPOOLNODE = boolean </literal></term>
+ <varlistentry><term><literal> SPOOLNODE = booléen </literal></term>
- <listitem><para>Specifies that the new node is a virtual spool
- node for file archiving of replication log. If true,
- <application>slonik</application> will not attempt to
- initialize a database with the replication
- schema.</para></listitem>
+ <listitem><para>Spécifie qu'un noeud est un noeud virtuel de récupération
+ pour l'archivage de journaux de réplication. Si ce paramètre est à true
+ <application>slonik</application> n'essaiera pas d'initialiser la base de
+ donnée avec le schéma de réplication.</para></listitem>
</varlistentry>
<varlistentry><term><literal> EVENT NODE = ival </literal></term>
- <listitem><para> The ID of the node used to create the configuration
- event that tells all existing nodes about the new node. Default
- value is 1.</para></listitem>
+ <listitem><para> L'identifiant du noeud utilisé pour créer l'évenement de configuration,
+ qui prévient tous les noeuds existants de l'arrivée du nouveau noeud.
+ La valeur par défaut est 1.</para></listitem>
</varlistentry>
</variablelist>
</para>
- <para> This uses &funinitializelocalnode; and &funenablenode;. </para>
+ <para> Ceci utilise &funinitializelocalnode; et &funenablenode;. </para>
</refsect1>
<refsect1><Title>Example</Title>
<programlisting>
- STORE NODE ( ID = 2, COMMENT = 'Node 2');
+ STORE NODE ( ID = 2, COMMENT = 'Noeud 2');
</programlisting>
</refsect1>
- <refsect1> <title> Locking Behaviour </title>
+ <refsect1> <title> Utilisation de verrous </title>
- <para> This command creates a new namespace and configures tables
- therein; no public objects should be locked during the duration of
- this.</para>
+ <para> Cette commande crée un nouvel espace de nom et configure les tables
+ à l'intérieur;aucun objets public ne doit être verrouiller
+ pendant l'exécution de cette commade.</para>
</refsect1>
- <refsect1> <title> Version Information </title> <para> This command
- was introduced in &slony1; 1.0. The <envar>SPOOLNODE</envar>
- parameter was introduced in version 1.1, but was vestigal in that
- version. The described functionality for <envar>SPOOLNODE</envar>
- arrives in version 1.2. </para>
+
+ <refsect1> <title> Note de version </title>
+ <para> Cette commande fut intorduite dans &slony1; 1.0. La paramètre <envar>SPOOLNODE</envar>
+ fut intrduit dans la version 1.1, mais n'était pas implémentée dans cette version.
+ La fonctionnalité <envar>SPOOLNODE</envar> est arrivée dans la
+ version 1.2. </para>
</refsect1>
</refentry>
@@ -569,7 +566,7 @@
<refnamediv><refname>DROP NODE</refname>
- <refpurpose> Remove the node from participating in the replication </refpurpose></refnamediv>
+ <refpurpose> Supprime un noeud de la réplication </refpurpose></refnamediv>
<refsynopsisdiv>
<cmdsynopsis>
<command>DROP NODE (options);</command>
@@ -579,58 +576,58 @@
<title>Description</title>
<para>
- Drop a node. This command removes the specified node entirely
- from the replication systems configuration. If the replication
- daemon is still running on that node (and processing events), it
- will attempt to uninstall the replication system and terminate
- itself.
+ Supprime un noeud. Cette commande retire complètement le noeud spécifié
+ de la configuration du système de réplication.
+ Si le démon de réplication est toujours en fonctionnement sur ce noeud
+ (et qu'ils traitent les événements), il tentera de désinstaller le système
+ de réplication et s'arrêtera de lui-même.
<variablelist>
<varlistentry><term><literal> ID = ival </literal></term>
- <listitem><para> Node ID of the node to remove.</para></listitem>
+ <listitem><para> L'indentifiant du noeud à supprimer.</para></listitem>
</varlistentry>
<varlistentry><term><literal> EVENT NODE = ival </literal></term>
- <listitem><para> Node ID of the node to generate the event; default is 1.
+ <listitem><para> L'identifiant du noeud qui génère l'événement. La valeur par défaut est 1.
</para></listitem>
</varlistentry>
</variablelist>
</para>
- <para> This uses &fundropnode;. </para>
+ <para> Cette commande utilise &fundropnode;. </para>
- <para> When you invoke <command>DROP NODE</command>, one of the
- steps is to run <command>UNINSTALL NODE</command>.</para>
+ <para> Quand vous invoquez <command>DROP NODE</command>, une des étapes
+ consiste à lancer <command>UNINSTALL NODE</command>.</para>
</refsect1>
- <refsect1><title>Example</title>
+ <refsect1><title>Exemple</title>
<programlisting>
DROP NODE ( ID = 2 );
</programlisting>
</refsect1>
- <refsect1> <title> Locking Behaviour </title>
+ <refsect1> <title> Utilisation de verrous </title>
- <para> When dropping triggers off of application tables, this will
- require exclusive access to each replicated table on the node
- being discarded.</para>
+ <para> Lorsqu'on supprime des triggers d'une table de l'application,
+ cela nécessite un accès exclusif à chaque table répliquée sur le noeud
+ que l'on supprime.</para>
</refsect1>
- <refsect1><title>Dangerous/Unintuitive Behaviour</title>
- <para> If you are using connections that cache query plans
- (this is particularly common for Java application frameworks with
- connection pools), the connections may cache query plans that
- include the pre-<command>DROP NODE</command> state of things, and
- you will get &rmissingoids;.</para>
+ <refsect1><title>Comportement dangereux ou non-intuitif</title>
+ <para> Si vous utiliser des connexions qui cachent les plans d'éxécution
+ (ce qui est particulièrement commun pour framework applicatifs Java utilisant
+ de pools de connexion pools), les connexions peuvent cacher des plans
+ de reques qui se base sur une vision pré-<command>DROP NODE</command>,
+ ce qui implique que vous obtiendrez des &rmissingoids;.</para>
- <para>After dropping a node, you may also need to recycle
- connections in your application.</para>
+ <para>Ainsi après avoir supprimé un noeud, il est préférable de réinitialiser
+ les connexions de votre applications.</para>
- <para> You cannot submit this to an <command>EVENT
- NODE</command> that is the number of the node being dropped; the
- request must go to some node that will remain in the
- cluster. </para>
+ <para> Vous ne pouvez pas soumettre cela à un <command>EVENT
+ NODE</command> ayant le même numéro que le noeud que vous supprimez;
+ la requête doit aller vers un noeud qui restera dans le cluster.
+ </para>
</refsect1>
- <refsect1> <title> Version Information </title>
- <para> This command was introduced in &slony1; 1.0 </para>
+ <refsect1> <title> Note de version </title>
+ <para> Cette commande fut introduite dans &slony1; 1.0 </para>
</refsect1>
</refentry>
@@ -640,7 +637,7 @@
<refnamediv><refname>UNINSTALL NODE</refname>
- <refpurpose> Decommission &slony1; node </refpurpose></refnamediv>
+ <refpurpose> Désinstaller un noeud &slony1; </refpurpose></refnamediv>
<refsynopsisdiv>
<cmdsynopsis>
<command>UNINSTALL NODE (options);</command>
@@ -649,51 +646,50 @@
<refsect1>
<title>Description</title>
- <para> Restores all tables to the unlocked state, with all
- original user triggers, constraints and rules, eventually added
- &slony1; specific serial key columns
- dropped and the &slony1; schema
- dropped. The node becomes a standalone database. The data is left
- untouched.
-
+ <para> Restaure toutes les tables dans leur état non verrouiller, avec
+ les triggers d'origines, les contraintes et les règles, les éventuelles colonnes
+ spécifiques de &slony1; contenant des clefs SERIAL sont supprimées.
+ et le schéma &slony1; est effacé. Le noeud redevient une base de données
+ indépendante. Les données ne sont pas modifiées.
<variablelist>
<varlistentry><term><literal> ID = ival </literal></term>
- <listitem><para> Node ID of the node to uninstall.</para></listitem>
+ <listitem><para> Identifiant du noeud à désinstaller.</para></listitem>
</varlistentry>
</variablelist>
</para>
- <para> This uses &fununinstallnode;. </para>
+ <para> Cette commande utilise &fununinstallnode;. </para>
- <para> The difference between <command>UNINSTALL NODE</command>
- and <command>DROP NODE</command> is that all <command>UNINSTALL
- NODE</command> does is to remove the &slony1; configuration; it
- doesn't drop the node's configuration from replication.</para>
+ <para> La différence entre <command>UNINSTALL NODE</command>
+ et <command>DROP NODE</command> est que <command>UNINSTALL
+ NODE</command> se contente de supprimer la configuration &slony1;;
+ il ne retire la configuration du noeud sur l'ensemble de réplication.
+ </para>
</refsect1>
- <refsect1><title>Example</title>
+ <refsect1><title>Exemple</title>
<programlisting>
UNINSTALL NODE ( ID = 2 );
</programlisting>
</refsect1>
- <refsect1> <title> Locking Behaviour </title>
+ <refsect1> <title> Utilisation de verrous </title>
- <para> When dropping triggers off of application tables, this will
- require exclusive access to each replicated table on the node
- being discarded.</para>
+ <para> Lorsque l'on supprime les triggers off des tables de l'application,
+ cela nécessite un accès exclusif sur chaque table répliquée sur le noeud
+ que l'on désinstallé.</para>
</refsect1>
- <refsect1><title> Dangerous/Unintuitive Behaviour </title>
- <para> If you are using connections that cache query plans
- (this is particularly common for Java application frameworks with
- connection pools), the connections may cache query plans that
- include the pre-<command>UNINSTALL NODE</command> state of things,
- and you will get &rmissingoids;.</para>
+ <refsect1><title>Comportement dangereux ou non-intuitif</title>
+ <para> Si vous utiliser des connexions qui cachent les plans d'éxécution
+ (ce qui est particulièrement commun pour framework applicatifs Java utilisant
+ de pools de connexion pools), les connexions peuvent cacher des plans
+ de reques qui se base sur une vision pré-<command>UNINSTALL NODE</command>,
+ ce qui implique que vous obtiendrez des &rmissingoids;.</para>
- <para>After dropping a node, you may also need to recycle
- connections in your application.</para>
+ <para>Ainsi après avoir désinstallé un noeud, il est préférable de réinitialiser
+ les connexions de votre applications.</para>
</refsect1>
- <refsect1> <title> Version Information </title>
- <para> This command was introduced in &slony1; 1.0 </para>
+ <refsect1> <title> Note de version </title>
+ <para> Cette commande fut introduite dans &slony1; 1.0 </para>
</refsect1>
</refentry>
@@ -704,7 +700,7 @@
<refnamediv><refname>RESTART NODE</refname>
- <refpurpose> Restart &slony1; node </refpurpose></refnamediv>
+ <refpurpose> Redémarre un noeud &slony1;</refpurpose></refnamediv>
<refsynopsisdiv>
<cmdsynopsis>
@@ -714,32 +710,34 @@
<refsect1>
<title>Description</title>
- <para> Causes an eventually running replication daemon on the
- specified node to shutdown and restart itself. Theoretically,
- this command should be obsolete. In practice, TCP timeouts can
- delay critical configuration changes to actually happen in the
- case where a former forwarding node failed and needs to be
- bypassed by subscribers.
-
+ <para> Provoque l'arrêt et le redémarrage d'un démon
+ de réplication sur le noeud spécifié
+ Théoriquement, cette commande est obsolète. En pratique,
+ les timeouts TCP peuvent retarder les changements critiques
+ de configuration jusqu'à ce qu'il soit effectué alors que le
+ noeud expéditeur est en echec et doit être ignoré par les
+ noeuds abonnés.
<variablelist>
<varlistentry><term><literal> ID = ival </literal></term>
- <listitem><para> Node ID of the node to restart.</para></listitem>
+ <listitem><para> Identifiant du noeud à redémarrer.</para></listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
- <refsect1><title>Example</title>
+ <refsect1><title>Exemple</title>
<programlisting>
RESTART NODE ( ID = 2 );
</programlisting>
</refsect1>
- <refsect1> <title> Locking Behaviour </title>
+ <refsect1> <title> Utilisation de verrous </title>
- <para> No application-visible locking should take place. </para>
+
+ <para> Aucun verouillage ne devrait être visible depuis l'application. </para>
</refsect1>
- <refsect1> <title> Version Information </title>
- <para> This command was introduced in &slony1; 1.0; its use should be unnecessary as of version 1.0.5. </para>
+ <refsect1> <title> Note de version </title>
+ <para> Cette commande fut introduite dans &slony1; 1.0;
+ Elle ne devrait plus être nécessaire à partir de la version 1.0.5. </para>
</refsect1>
</refentry>
@@ -751,7 +749,7 @@
<refnamediv><refname>STORE PATH</refname>
- <refpurpose> Configure &slony1; node connection </refpurpose></refnamediv>
+ <refpurpose> Configure la connexion d'un noeud &slony1;</refpurpose></refnamediv>
<refsynopsisdiv>
<cmdsynopsis>
@@ -761,60 +759,63 @@
<refsect1>
<title>Description</title>
- <para> Configures how the replication daemon of one node connects
- to the database of another node. If the replication system is
- supposed to use a special backbone network segment, this is the
- place to user the special IP addresses or hostnames. An existing
- configuration can be overwritten.</para>
+ <para> Configure comment le démon de réplication d'un noeud se
+ connecte à la base de données d'un autre noeud. Si le système
+ de réplication est supposé utiliser un segment spécial de réseau,
+ c'est ici qu'on définit les adresses IP ou les noms d'hôtes.
+ Un configuration existante peut-être écrasée.
+ </para>
- <para> The conninfo string must contain all information to connect
- to the database as the replication superuser. The names
- <quote>server</quote> or <quote>client</quote> have nothing to do
- with the particular role of a node within the cluster
- configuration. It should be simply viewed as <quote>the
- server</quote> has the message or data that <quote>the client is
- supposed to get.</quote> For a simple 2 node setup, paths into
- both directions must be configured.
+ <para> Le paramètre conninfo doit contenir toutes les informations
+ pour se connecter à la base en tant super-utilisateur de la répliction.
+ Les termes <quote>serveur</quote> or <quote>client</quote> n'ont
+ rien à voir avec le rôle particulier d'un noeud dans la configuration
+ d'un cluster. On peut simplement voir cela comme un
+ <quote>serveur</quote> ayant un message or un donnée qu'un
+ <quote>client est supposé obtenir</quote>.
+ Pour une installation simple avec 2 noeuds, les chemins dans les deux
+ directions doivent être configurés.
</para>
- <para> It does not do any harm to configure path information from
- every node to every other node (full cross product). The
- connections are not established unless they are required to
- actually transfer events or confirmations because of
- <emphasis>listen</emphasis> entries or data because of
- <emphasis>subscriptions</emphasis>.
+ <para> Il ne pose aucun problème de configurer un chemin entre chaque
+ noeud. ( produit en croix complète ).Les connexions ne sont établit que
+ si cela est nécessaire pour transférer un événement ou une confirmation
+ à cause des entrées <emphasis>listen</emphasis> ou une donnée à cause de
+ <emphasis>souscriptions</emphasis>.
<variablelist>
<varlistentry><term><literal> SERVER = ival </literal></term>
- <listitem><para> Node ID of the database to connect to.</para></listitem>
+ <listitem><para> Identifiant du noeud de la base à laquelle on doit se connecter.</para></listitem>
</varlistentry>
<varlistentry><term><literal> CLIENT = ival </literal></term>
- <listitem><para> Node ID of the replication daemon connecting.</para></listitem>
+ <listitem><para> Identifiant du noeud du démon de réplication qui se connecte.</para></listitem>
</varlistentry>
<varlistentry><term><literal> CONNINFO = string </literal></term>
- <listitem><para> <function>PQconnectdb()</function> argument to establish the connection.</para></listitem>
+ <listitem><para> Argument <function>PQconnectdb()</function> pour établir la connexion.</para></listitem>
</varlistentry>
<varlistentry><term><literal> CONNRETRY = ival </literal></term>
- <listitem><para> Number of seconds to wait before another attempt to
- connect is made in case the server is unavailable. Default is 10.
+ <listitem><para> Nombre de secondes d'attente avant qu'un autre tentative
+ de connexion soit faite dasn le cas ou le serveur est indisponible.
+ La valeur par défaut est 10.
</para></listitem>
</varlistentry>
</variablelist>
</para>
- <para> This uses &funstorepath;. </para>
+ <para> Cette commande utilise &funstorepath;. </para>
</refsect1>
- <refsect1><title>Example</title>
+ <refsect1><title>Exemple</title>
<programlisting>
STORE PATH ( SERVER = 1, CLIENT = 2,
- CONNINFO = 'dbname=testdb host=server1 user=slony'
+ CONNINFO = 'dbname=testdb host=serveur1 user=slony'
);
</programlisting>
</refsect1>
- <refsect1> <title> Locking Behaviour </title>
+ <refsect1> <title> Utilisation de verrous </title>
- <para> No application-visible locking should take place. </para>
+
+ <para> Aucun verouillage ne devrait être visible depuis l'application. </para>
</refsect1>
- <refsect1> <title> Version Information </title>
- <para> This command was introduced in &slony1; 1.0 </para>
+ <refsect1> <title> Note de version </title>
+ <para> Cette commande fut introduite dans &slony1; 1.0 </para>
</refsect1>
</refentry>
@@ -826,7 +827,7 @@
<refnamediv><refname>DROP PATH</refname>
- <refpurpose> Delete &slony1; connection information </refpurpose></refnamediv>
+ <refpurpose> Supprime un chemin de connexion &slony1; </refpurpose></refnamediv>
<refsynopsisdiv>
<cmdsynopsis>
@@ -836,36 +837,36 @@
<refsect1>
<title>Description</title>
- <para> Remove the connection information between <quote>server</quote> and
+ <para> Supprime les informations de connexion entre un <quote>serveur</quote> et
<quote>client</quote>.</para>
<variablelist>
<varlistentry><term><literal> SERVER = ival </literal></term>
- <listitem><para> Node ID of the database to connect to.</para></listitem>
+ <listitem><para> Identifiant du noeud de la base à laquelle on doit se connecter.</para></listitem>
</varlistentry>
<varlistentry><term><literal> CLIENT = ival </literal></term>
- <listitem><para> Node ID of the replication daemon connecting.</para></listitem>
+ <listitem><para> Identifiant du noeud du démon qui se connecte.</para></listitem>
</varlistentry>
<varlistentry><term><literal> EVENT NODE = ival </literal></term>
- <listitem><para> The ID of the node used to create the configuration
- event that tells all existing nodes about dropping the path.
- Defaults to the <quote>client</quote>, if omitted.
+ <listitem><para> L'identifiant du noeud utilisé pour créer l'événement de configuration
+ qui annonce à tous les noeuds existants que le chemin a été supprimé.
+ La valeur par défaut est l'identifiant du noeud <quote>client</quote>.
</para></listitem>
</varlistentry>
</variablelist>
</refsect1>
- <refsect1><title>Example</title>
+ <refsect1><title>Exemple</title>
<programlisting>
DROP PATH ( SERVER = 1, CLIENT = 2 );
</programlisting>
</refsect1>
- <refsect1> <title> Locking Behaviour </title>
+ <refsect1> <title> Utilisation de verrous</title>
- <para> No application-visible locking should take place. </para>
+ <para> Aucun verouillage ne devrait être visible depuis l'application. </para>
</refsect1>
- <refsect1> <title> Version Information </title>
- <para> This command was introduced in &slony1; 1.0 </para>
+ <refsect1> <title> Note de version </title>
+ <para> Cette commande fut introduite dans &slony1; 1.0 </para>
</refsect1>
</refentry>
@@ -877,8 +878,8 @@
<refnamediv><refname>STORE LISTEN</refname>
- <refpurpose> Configure &slony1; node to
- indicate where to listen for events </refpurpose></refnamediv>
+ <refpurpose> Configure un noeud &slony1; en lui indiquant où il
+ doit écouter les événements </refpurpose></refnamediv>
<refsynopsisdiv>
<cmdsynopsis>
@@ -888,7 +889,9 @@
<refsect1>
<title>Description</title>
- <para> A <quote>listen</quote> entry causes a node (receiver) to query an
+ <para> Pour chaque entrée <quote>listen</quote>, le noeud (récepteur) demande
+ à un noeud fournisseur de lui envoyer les événements d'un autre noeud
+ entry causes a node (receiver) to query an
event provider for events that originate from a specific node, as
well as confirmations from every existing node. It requires a
<quote>path</quote> to exist so that the receiver (as client) can connect
@@ -925,16 +928,16 @@
<para> This uses &funstorelisten;. </para>
<para> For more details, see &rlistenpaths;.</para>
</refsect1>
- <refsect1><title>Example</title>
+ <refsect1><title>Exemple</title>
<programlisting>
STORE LISTEN ( ORIGIN = 1, RECEIVER = 2, PROVIDER = 3 );
</programlisting>
</refsect1>
- <refsect1> <title> Locking Behaviour </title>
+ <refsect1> <title> Utilisation de verrous </title>
- <para> No application-visible locking should take place. </para>
+ <para> Aucun verouillage ne devrait être visible depuis l'application. </para>
</refsect1>
- <refsect1> <title> Version Information </title> <para> This command
+ <refsect1> <title> Note de version </title> <para> This command
was introduced in &slony1; 1.0. As of version 1.1, you <emphasis>should</emphasis> no
longer need to use this command, as listen paths are generated automatically. </para>
</refsect1>
@@ -978,16 +981,16 @@
<para> This uses &fundroplisten;. </para>
</refsect1>
- <refsect1><title>Example</title>
+ <refsect1><title>Exemple</title>
<programlisting>
DROP LISTEN ( ORIGIN = 1, RECEIVER = 2, PROVIDER = 3 );
</programlisting>
</refsect1>
- <refsect1> <title> Locking Behaviour </title>
+ <refsect1> <title> Utilisation de verrous </title>
- <para> No application-visible locking should take place. </para>
+ <para> Aucun verouillage ne devrait être visible depuis l'application. </para>
</refsect1>
- <refsect1> <title> Version Information </title> <para> This command
+ <refsect1> <title> Note de version </title> <para> This command
was introduced in &slony1; 1.0. As of version 1.1, you should not
need to use it anymore. </para>
</refsect1>
@@ -1070,13 +1073,13 @@
<para> This uses &funtableaddkey;. </para>
</refsect1>
- <refsect1><title>Example</title>
+ <refsect1><title>Exemple</title>
<programlisting>
TABLE ADD KEY ( NODE ID = 1,
FULLY QUALIFIED NAME = 'public.history' );
</programlisting>
</refsect1>
- <refsect1> <title> Locking Behaviour </title>
+ <refsect1> <title> Utilisation de verrous </title>
<para> On the origin node, this will take out an exclusive lock on
the table being modified for as long as it takes to:</para>
@@ -1098,8 +1101,8 @@
command should not be used if you can possibly avoid it.</para>
</refsect1>
- <refsect1> <title> Version Information </title>
- <para> This command was introduced in &slony1; 1.0 </para>
+ <refsect1> <title> Note de version </title>
+ <para> Cette commande fut introduite dans &slony1; 1.0 </para>
<warning> <para> This command is <emphasis> no longer supported </emphasis>
as of &slony1; version 2.0. In version 2, the various
<quote>catalogue breakages</quote> done in &postgres; versions
@@ -1166,19 +1169,19 @@
<para> This uses &funstoreset; . </para>
</refsect1>
- <refsect1><title>Example</title>
+ <refsect1><title>Exemple</title>
<programlisting>
CREATE SET ( ID = 1,
ORIGIN = 1,
COMMENT = 'Tables for ticketing system' );
</programlisting>
</refsect1>
- <refsect1> <title> Locking Behaviour </title>
+ <refsect1> <title> Utilisation de verrous </title>
- <para> No application-visible locking should take place. </para>
+ <para> Aucun verouillage ne devrait être visible depuis l'application. </para>
</refsect1>
- <refsect1> <title> Version Information </title>
- <para> This command was introduced in &slony1; 1.0 </para>
+ <refsect1> <title> Note de version </title>
+ <para> Cette commande fut introduite dans &slony1; 1.0 </para>
<para> Until version 1.2, it would crash if no comment was provided. </para>
</refsect1>
</refentry>
@@ -1220,20 +1223,20 @@
<para> This uses &fundropset;. </para>
</refsect1>
- <refsect1><title>Example</title>
+ <refsect1><title>Exemple</title>
<programlisting>
DROP SET ( ID = 5,
ORIGIN = 2 );
</programlisting>
</refsect1>
- <refsect1> <title> Locking Behaviour </title>
+ <refsect1> <title> Utilisation de verrous </title>
<para> On each node, this will require taking out exclusive locks
on each replicated table in order to modify the table schema to
clean up the triggers and rules. </para>
</refsect1>
- <refsect1> <title> Version Information </title>
- <para> This command was introduced in &slony1; 1.0 </para>
+ <refsect1> <title> Note de version </title>
+ <para> Cette commande fut introduite dans &slony1; 1.0 </para>
</refsect1>
</refentry>
@@ -1283,7 +1286,7 @@
<para> This uses &funmergeset;. </para>
</refsect1>
- <refsect1><title>Example</title>
+ <refsect1><title>Exemple</title>
<programlisting>
# Assuming that set 1 has direct subscribers 2 and 3
SUBSCRIBE SET (ID = 999, PROVIDER = 1, RECEIVER = 2);
@@ -1295,9 +1298,9 @@
MERGE SET ( ID = 1, ADD ID = 999, ORIGIN = 1 );
</programlisting>
</refsect1>
- <refsect1> <title> Locking Behaviour </title>
+ <refsect1> <title> Utilisation de verrous </title>
- <para> No application-visible locking should take place. </para>
+ <para> Aucun verouillage ne devrait être visible depuis l'application. </para>
</refsect1>
<refsect1><title> Dangerous/Unintuitive Behaviour </title>
@@ -1309,7 +1312,7 @@
</para>
</refsect1>
- <refsect1> <title> Version Information </title> <para> This command
+ <refsect1> <title> Note de version </title> <para> This command
was introduced in &slony1; 1.0.5. In 1.2.1, a race condition was
rectified where the merge request would be submitted while
subscriptions were still in process on subscribers; it refuses to
@@ -1387,7 +1390,7 @@
</para>
<para> This uses &funsetaddtable;. </para>
</refsect1>
- <refsect1><title>Example</title>
+ <refsect1><title>Exemple</title>
<programlisting>
SET ADD TABLE (
SET ID = 1,
@@ -1466,7 +1469,7 @@
</variablelist>
</refsect1>
- <refsect1> <title> Locking Behaviour </title>
+ <refsect1> <title> Utilisation de verrous </title>
<para> On the origin node, this operation requires a brief
exclusive lock on the table in order to alter it to add the
@@ -1474,8 +1477,8 @@
takes place at the time of the <command>SUBSCRIBE_SET</command>
event. </para>
</refsect1>
- <refsect1> <title> Version Information </title>
- <para> This command was introduced in &slony1; 1.0 </para>
+ <refsect1> <title> Note de version </title>
+ <para> Cette commande fut introduite dans &slony1; 1.0 </para>
</refsect1>
</refentry>
@@ -1534,7 +1537,7 @@
</para>
<para> This uses &funsetaddsequence;. </para>
</refsect1>
- <refsect1><title>Example</title>
+ <refsect1><title>Exemple</title>
<programlisting>
SET ADD SEQUENCE (
SET ID = 1,
@@ -1545,12 +1548,12 @@
);
</programlisting>
</refsect1>
- <refsect1> <title> Locking Behaviour </title>
+ <refsect1> <title> Utilisation de verrous </title>
- <para> No application-visible locking should take place. </para>
+ <para> Aucun verouillage ne devrait être visible depuis l'application. </para>
</refsect1>
- <refsect1> <title> Version Information </title>
- <para> This command was introduced in &slony1; 1.0 </para>
+ <refsect1> <title> Note de version </title>
+ <para> Cette commande fut introduite dans &slony1; 1.0 </para>
</refsect1>
</refentry>
@@ -1593,7 +1596,7 @@
</para>
<para> This uses &funsetdroptable;. </para>
</refsect1>
- <refsect1><title>Example</title>
+ <refsect1><title>Exemple</title>
<programlisting>
SET DROP TABLE (
ORIGIN = 1,
@@ -1601,15 +1604,15 @@
);
</programlisting>
</refsect1>
- <refsect1> <title> Locking Behaviour </title>
+ <refsect1> <title> Utilisation de verrous </title>
<para> This operation must acquire an exclusive lock on the table
being dropped from replication in order to alter it to drop the
replication trigger. On subscriber nodes, this also involves
adding back any rules/triggers that have been hidden. </para>
</refsect1>
- <refsect1> <title> Version Information </title>
- <para> This command was introduced in &slony1; 1.0.5 </para>
+ <refsect1> <title> Note de version </title>
+ <para> Cette commande fut introduite dans &slony1; 1.0.5 </para>
</refsect1>
</refentry>
@@ -1648,7 +1651,7 @@
</para>
<para> This uses &funsetdropsequence;. </para>
</refsect1>
-<refsect1><title>Example</title>
+<refsect1><title>Exemple</title>
<programlisting>
SET DROP SEQUENCE (
ORIGIN = 1,
@@ -1656,12 +1659,12 @@
);
</programlisting>
</refsect1>
- <refsect1> <title> Locking Behaviour </title>
+ <refsect1> <title> Utilisation de verrous </title>
- <para> No application-visible locking should take place. </para>
+ <para> Aucun verouillage ne devrait être visible depuis l'application. </para>
</refsect1>
- <refsect1> <title> Version Information </title>
- <para> This command was introduced in &slony1; 1.0.5 </para>
+ <refsect1> <title> Note de version </title>
+ <para> Cette commande fut introduite dans &slony1; 1.0.5 </para>
</refsect1>
</refentry>
@@ -1710,7 +1713,7 @@
</para>
<para> This uses &funsetmovetable;. </para>
</refsect1>
- <refsect1><title>Example</title>
+ <refsect1><title>Exemple</title>
<programlisting>
SET MOVE TABLE (
ORIGIN = 1,
@@ -1719,12 +1722,12 @@
);
</programlisting>
</refsect1>
- <refsect1> <title> Locking Behaviour </title>
+ <refsect1> <title> Utilisation de verrous </title>
- <para> No application-visible locking should take place. </para>
+ <para> Aucun verouillage ne devrait être visible depuis l'application. </para>
</refsect1>
- <refsect1> <title> Version Information </title>
- <para> This command was introduced in &slony1; 1.0.5 </para>
+ <refsect1> <title> Note de version </title>
+ <para> Cette commande fut introduite dans &slony1; 1.0.5 </para>
</refsect1>
</refentry>
@@ -1779,7 +1782,7 @@
</para>
<para> This uses &funsetmovesequence;. </para>
</refsect1>
- <refsect1><title>Example</title>
+ <refsect1><title>Exemple</title>
<programlisting>
SET MOVE SEQUENCE (
ORIGIN = 1,
@@ -1788,12 +1791,12 @@
);
</programlisting>
</refsect1>
- <refsect1> <title> Locking Behaviour </title>
+ <refsect1> <title> Utilisation de verrous </title>
- <para> No application-visible locking should take place. </para>
+ <para> Aucun verouillage ne devrait être visible depuis l'application. </para>
</refsect1>
- <refsect1> <title> Version Information </title>
- <para> This command was introduced in &slony1; 1.0.5 </para>
+ <refsect1> <title> Note de version </title>
+ <para> Cette commande fut introduite dans &slony1; 1.0.5 </para>
</refsect1>
</refentry>
@@ -1855,7 +1858,7 @@
</note>
<para> This uses &funstoretrigger;. </para>
</refsect1>
- <refsect1><title>Example</title>
+ <refsect1><title>Exemple</title>
<programlisting>
STORE TRIGGER (
TABLE ID = 2,
@@ -1863,14 +1866,14 @@
);
</programlisting>
</refsect1>
- <refsect1> <title> Locking Behaviour </title>
+ <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>
</refsect1>
- <refsect1> <title> Version Information </title>
- <para> This command was introduced in &slony1; 1.0 </para>
+ <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
@@ -1921,7 +1924,7 @@
</para>
<para> This uses &fundroptrigger;. </para>
</refsect1>
- <refsect1><title>Example</title>
+ <refsect1><title>Exemple</title>
<programlisting>
DROP TRIGGER (
TABLE ID = 2,
@@ -1929,14 +1932,14 @@
);
</programlisting>
</refsect1>
- <refsect1> <title> Locking Behaviour </title>
+ <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>
</refsect1>
- <refsect1> <title> Version Information </title>
- <para> This command was introduced in &slony1; 1.0 </para>
+ <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
@@ -2074,7 +2077,7 @@
</variablelist>
<para> This uses &funsubscribeset;. </para>
</refsect1>
- <refsect1><title>Example</title>
+ <refsect1><title>Exemple</title>
<programlisting>
SUBSCRIBE SET (
ID = 1,
@@ -2163,7 +2166,7 @@
</itemizedlist>
</refsect1>
- <refsect1> <title> Locking Behaviour </title>
+ <refsect1> <title> Utilisation de verrous </title>
<para> This operation does <emphasis>not</emphasis> require
acquiring any locks on the provider node.</para>
@@ -2176,8 +2179,8 @@
access the subscriber database at this time.
</para>
</refsect1>
- <refsect1> <title> Version Information </title>
- <para> This command was introduced in &slony1; 1.0 </para>
+ <refsect1> <title> Note de version </title>
+ <para> Cette commande fut introduite dans &slony1; 1.0 </para>
</refsect1>
</refentry>
@@ -2218,7 +2221,7 @@
</para>
<para> This uses &fununsubscribeset;. </para>
</refsect1>
- <refsect1><title>Example</title>
+ <refsect1><title>Exemple</title>
<programlisting>
UNSUBSCRIBE SET (
ID = 1,
@@ -2226,7 +2229,7 @@
);
</programlisting>
</refsect1>
- <refsect1> <title> Locking Behaviour </title>
+ <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
@@ -2241,8 +2244,8 @@
possible independent modifications. </para>
</refsect1>
- <refsect1> <title> Version Information </title>
- <para> This command was introduced in &slony1; 1.0 </para>
+ <refsect1> <title> Note de version </title>
+ <para> Cette commande fut introduite dans &slony1; 1.0 </para>
</refsect1>
</refentry>
@@ -2311,14 +2314,14 @@
);
</programlisting>
</refsect1>
- <refsect1> <title> Locking Behaviour </title>
+ <refsect1> <title> Utilisation de verrous </title>
<para> Exclusive locks on each replicated table will be taken out
on the origin node, and triggers are added to each such table that
reject table updates. </para>
</refsect1>
- <refsect1> <title> Version Information </title>
- <para> This command was introduced in &slony1; 1.0 </para>
+ <refsect1> <title> Note de version </title>
+ <para> Cette commande fut introduite dans &slony1; 1.0 </para>
</refsect1>
</refentry>
@@ -2355,7 +2358,7 @@
</para>
<para> This uses &fununlockset;. </para>
</refsect1>
- <refsect1><title>Example</title>
+ <refsect1><title>Exemple</title>
<programlisting>
UNLOCK SET (
ID = 1,
@@ -2363,14 +2366,14 @@
);
</programlisting>
</refsect1>
- <refsect1> <title> Locking Behaviour </title>
+ <refsect1> <title> Utilisation de verrous </title>
<para> Exclusive locks on each replicated table will be taken out
on the origin node, as the triggers are removed from each table
that reject table updates. </para>
</refsect1>
- <refsect1> <title> Version Information </title>
- <para> This command was introduced in &slony1; 1.0 </para>
+ <refsect1> <title> Note de version </title>
+ <para> Cette commande fut introduite dans &slony1; 1.0 </para>
</refsect1>
</refentry>
@@ -2438,7 +2441,7 @@
</para>
<para> This uses &funmoveset;. </para>
</refsect1>
- <refsect1><title>Example</title>
+ <refsect1><title>Exemple</title>
<programlisting>
LOCK SET (
ID = 1,
@@ -2451,7 +2454,7 @@
);
</programlisting>
</refsect1>
- <refsect1> <title> Locking Behaviour </title>
+ <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
@@ -2461,8 +2464,8 @@
denyaccess trigger is dropped and a logtrigger trigger
added. </para>
</refsect1>
- <refsect1> <title> Version Information </title>
- <para> This command was introduced in &slony1; 1.0 </para>
+ <refsect1> <title> Note de version </title>
+ <para> Cette commande fut introduite dans &slony1; 1.0 </para>
</refsect1>
</refentry>
@@ -2517,7 +2520,7 @@
<para> This uses &funfailednode;. </para>
</refsect1>
- <refsect1><title>Example</title>
+ <refsect1><title>Exemple</title>
<programlisting>
FAILOVER (
ID = 1,
@@ -2525,7 +2528,7 @@
);
</programlisting>
</refsect1>
- <refsect1> <title> Locking Behaviour </title>
+ <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.
@@ -2543,8 +2546,8 @@
<emphasis>not</emphasis> abandon the failed node.
</para>
</refsect1>
- <refsect1> <title> Version Information </title>
- <para> This command was introduced in &slony1; 1.0 </para>
+ <refsect1> <title> Note de version </title>
+ <para> Cette commande fut introduite dans &slony1; 1.0 </para>
</refsect1>
</refentry>
@@ -2638,7 +2641,7 @@
<para> This uses &funddlscript;. </para>
</refsect1>
- <refsect1><title>Example</title>
+ <refsect1><title>Exemple</title>
<programlisting>
EXECUTE SCRIPT (
SET ID = 1,
@@ -2647,7 +2650,7 @@
);
</programlisting>
</refsect1>
- <refsect1> <title> Locking Behaviour </title>
+ <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
@@ -2668,8 +2671,8 @@
actually altered as a part of the DDL script. </para>
</refsect1>
- <refsect1> <title> Version Information </title>
- <para> This command was introduced in &slony1; 1.0. </para>
+ <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
@@ -2730,19 +2733,19 @@
</variablelist>
</refsect1>
- <refsect1><title>Example</title>
+ <refsect1><title>Exemple</title>
<programlisting>
UPDATE FUNCTIONS (
ID = 3 # Update functions on node 3
);
</programlisting>
</refsect1>
- <refsect1> <title> Locking Behaviour </title>
+ <refsect1> <title> Utilisation de verrous </title>
- <para> No application-visible locking should take place. </para>
+ <para> Aucun verouillage ne devrait être visible depuis l'application. </para>
</refsect1>
- <refsect1> <title> Version Information </title>
- <para> This command was introduced in &slony1; 1.0 </para>
+ <refsect1> <title> Note de version </title>
+ <para> Cette commande fut introduite dans &slony1; 1.0 </para>
</refsect1>
<refsect1> <title> Oddities </title>
@@ -2826,7 +2829,7 @@
</variablelist></para>
</refsect1>
- <refsect1><title>Example</title>
+ <refsect1><title>Exemple</title>
<programlisting>
WAIT FOR EVENT (
ORIGIN = ALL,
@@ -2835,12 +2838,12 @@
);
</programlisting>
</refsect1>
- <refsect1> <title> Locking Behaviour </title>
+ <refsect1> <title> Utilisation de verrous </title>
- <para> No application-visible locking should take place. </para>
+ <para> Aucun verouillage ne devrait être visible depuis l'application. </para>
</refsect1>
- <refsect1> <title> Version Information </title>
- <para> This command was introduced in &slony1; 1.0 </para>
+ <refsect1> <title> Note de version </title>
+ <para> Cette commande fut introduite dans &slony1; 1.0 </para>
</refsect1>
<refsect1> <title> Oddities </title> <para> Not all events return
@@ -2912,7 +2915,7 @@
</variablelist>
</refsect1>
- <refsect1><title>Example</title>
+ <refsect1><title>Exemple</title>
<programlisting>
REPAIR CONFIG (
SET ID = 1,
@@ -2920,12 +2923,12 @@
);
</programlisting>
</refsect1>
- <refsect1> <title> Locking Behaviour </title>
+ <refsect1> <title> Utilisation de verrous </title>
- <para> No application-visible locking should take place. </para>
+ <para> Aucun verouillage ne devrait être visible depuis l'application. </para>
</refsect1>
- <refsect1> <title> Version Information </title>
- <para> This command was introduced in &slony1; 1.1 </para>
+ <refsect1> <title> Note de version </title>
+ <para> Cette commande fut introduite dans &slony1; 1.1 </para>
</refsect1>
</refentry>
<!-- **************************************** -->
@@ -2954,7 +2957,7 @@
</variablelist>
</refsect1>
- <refsect1><title>Example</title>
+ <refsect1><title>Exemple</title>
<programlisting>
SUBSCRIBE SET (ID = 10, PROVIDER = 1, RECEIVER = 2);
WAIT FOR EVENT (ORIGIN = 2, CONFIRMED = 1);
@@ -2962,12 +2965,12 @@
WAIT FOR EVENT (ORIGIN = 1, CONFIRMED = 2);
</programlisting>
</refsect1>
- <refsect1> <title> Locking Behaviour </title>
+ <refsect1> <title> Utilisation de verrous </title>
- <para> No application-visible locking should take place. </para>
+ <para> Aucun verouillage ne devrait être visible depuis l'application. </para>
</refsect1>
- <refsect1> <title> Version Information </title>
- <para> This command was introduced in &slony1; 1.1.6 / 1.2.1 </para>
+ <refsect1> <title> Note de version </title>
+ <para> Cette commande fut introduite dans &slony1; 1.1.6 / 1.2.1 </para>
</refsect1>
</refentry>
@@ -2997,8 +3000,8 @@
sleep (seconds = 5);
</programlisting>
</refsect1>
- <refsect1> <title> Version Information </title>
- <para> This command was introduced in &slony1; 1.1.6 / 1.2.1. </para>
+ <refsect1> <title> Note de version </title>
+ <para> Cette commande fut introduite dans &slony1; 1.1.6 / 1.2.1. </para>
</refsect1>
</refentry>
@@ -3044,8 +3047,8 @@
sync (id=22);
</Programlisting>
</refsect1>
- <refsect1> <title> Version Information </title>
- <para> This command was introduced in &slony1; 1.2.0. </para>
+ <refsect1> <title> Note de version </title>
+ <para> Cette commande fut introduite dans &slony1; 1.2.0. </para>
</refsect1>
</refentry>
@@ -3082,8 +3085,8 @@
clone finish (id = 33, provider = 22);
</Programlisting>
</refsect1>
- <refsect1> <title> Version Information </title>
- <para> This command was introduced in &slony1; 1.2.0. </para>
+ <refsect1> <title> Note de version </title>
+ <para> Cette commande fut introduite dans &slony1; 1.2.0. </para>
</refsect1>
</refentry>
More information about the Trad
mailing list