Skip to content

Commit f936617

Browse files
gleugleu
committed
Relecture, étape 2.
1 parent ffac01f commit f936617

11 files changed

+1593
-913
lines changed

‎slony/concepts.xml

+130-87
Original file line numberDiff line numberDiff line change
@@ -6,153 +6,196 @@
66

77
<sect1 id="concepts">
88
<title>Les concepts</title>
9-
109
<indexterm><primary>concepts et terminologie</primary></indexterm>
1110

12-
<para>Afin de mettre en place une réplication &slony1;, il est nécessaire de comprendre les
13-
principales abstractions utilisées : </para>
11+
<para>
12+
Afin de mettre en place une réplication &slony1;, il est nécessaire de
13+
comprendre la terminologie utilisée&nbsp;:
14+
</para>
1415

1516
<itemizedlist>
16-
<listitem><para>Cluster,</para></listitem>
17-
<listitem><para>Noeud ("node"),</para></listitem>
18-
<listitem><para>Ensemble de réplication ("replication set"),</para></listitem>
19-
<listitem><para>Origine ("Origin"), Fournisseurs ("Providers") et Abonnés ("Subscribers"),</para></listitem>
20-
<listitem><para>Les démons slon,</para></listitem>
21-
<listitem><para>La commande slonik</para></listitem>
17+
<listitem><para>Cluster&nbsp;;</para></listitem>
18+
<listitem><para>Noeud («&nbsp;node&nbsp;»)&nbsp;;</para></listitem>
19+
<listitem><para>Ensemble de réplication («&nbsp;replication
20+
set&nbsp;»)&nbsp;;</para></listitem>
21+
<listitem><para>Origine («&nbsp;Origin&nbsp;»), Fournisseurs
22+
(«&nbsp;Providers&nbsp;») et Abonnés
23+
(«&nbsp;Subscribers&nbsp;»)&nbsp;;</para></listitem>
24+
<listitem><para>Les démons slon&nbsp;;</para></listitem>
25+
<listitem><para>La commande slonik.</para></listitem>
2226
</itemizedlist>
2327

24-
<para> Il est également nécessaire de connaître quelques mots de russe :</para>
28+
<para>
29+
Il est également nécessaire de connaître quelques mots de russe&nbsp;:
30+
</para>
31+
2532
<itemizedlist>
26-
<listitem><para>slon signifie <quote>éléphant</quote> en russe,</para></listitem>
27-
<listitem><para>slony est le pluriel de slon, et désigne ainsi un groupe d'éléphants</para></listitem>
28-
<listitem><para>slonik désigne un <quote>petit éléphant</quote></para></listitem>
33+
<listitem><para>slon signifie <quote>éléphant</quote> en russe&nbsp;;</para></listitem>
34+
<listitem><para>slony est le pluriel de slon, et désigne ainsi un groupe
35+
d'éléphants&nbsp;;</para></listitem>
36+
<listitem><para>slonik désigne un <quote>petit éléphant</quote>.</para></listitem>
2937
</itemizedlist>
3038

31-
<para> L'utilisation de ces termes dans &slony1; est un <quote>coup de chapeau</quote>
32-
à Vadim Mikheev, qui est l'auteur du prototype <application>rserv</application>
33-
qui inspira une partie des algorithmes utilisé dans &slony1;.</para>
39+
<para>
40+
L'utilisation de ces termes dans &slony1; est un <quote>coup de chapeau</quote>
41+
à Vadim Mikheev qui est l'auteur du prototype <application>rserv</application>
42+
qui inspira une partie des algorithmes utilisé dans &slony1;.
43+
</para>
3444

3545
<sect2>
3646
<title>Cluster</title>
37-
<indexterm>
38-
<primary>cluster</primary>
39-
</indexterm>
47+
<indexterm><primary>cluster</primary></indexterm>
48+
49+
<para>
50+
Selon &slony1;, un <quote>cluster</quote> est ensemble nommé d'instances de
51+
bases de données &postgres;. Une réplication a lieu entre ces bases.
52+
</para>
4053

41-
<para>Selon &slony1;, un <quote>cluster</quote> est ensemble nommé d'instances de bases
42-
de données &postgres;; Une réplication a lieu entre ces bases.</para>
54+
<para>
55+
Le nom du cluster est spécifié dans chaque script Slonik via la directive&nbsp;:
56+
</para>
4357

44-
<para>Le nom du cluster est spécifié dans chaque script Slonik via la directive :</para>
4558
<programlisting>
4659
cluster name = 'quelque_chose';
4760
</programlisting>
4861

49-
<para>Si le nom du cluster est <envar>plop</envar>, alors &slony1;
50-
créera, dans chaque instance du cluster, le schéma <envar>_plop</envar>.</para>
62+
<para>
63+
Si le nom du cluster est <envar>plop</envar>, alors &slony1; crée, dans
64+
chaque instance du cluster, le schéma <envar>_plop</envar>.
65+
</para>
66+
5167
</sect2>
68+
5269
<sect2><title>Noeud</title>
53-
<indexterm>
54-
<primary>noeud</primary>
55-
</indexterm>
70+
<indexterm><primary>n&oelig;ud</primary></indexterm>
71+
72+
<para>
73+
Un n&oelig;ud &slony1; est une base &postgres; nommée qui participe à la
74+
réplication.
75+
</para>
5676

57-
<para>Un noeud &slony1; est un base &postgres; nommée qui participe à la réplication.</para>
77+
<para>
78+
Le nom du n&oelig;ud est défini au début de chaque script Slonik, avec la
79+
directive&nbsp;:
80+
</para>
5881

59-
<para>Le nom du noeud est défini au début de chaque script Slonik, avec la directive :</para>
6082
<programlisting>
61-
NODE 1 ADMIN CONNINFO = 'dbname=testdb host=server1 user=slony';
83+
NODE 1 ADMIN CONNINFO = 'dbname=testdb host=server1 user=slony';
6284
</programlisting>
6385

64-
<para>La ligne <xref linkend="admconninfo"/> précise les informations
65-
de connexion qui seront utilisées par la fonction libpq
66-
<function>PQconnectdb()</function>.</para>
86+
<para>
87+
La ligne <xref linkend="admconninfo"/> précise les informations de connexion
88+
qui seront utilisées par la fonction libpq <function>PQconnectdb()</function>.
89+
</para>
90+
91+
<para>
92+
Ainsi un cluster &slony1; se compose&nbsp;:
93+
</para>
6794

68-
<para>Ainsi un cluster &slony1; se compose :</para>
6995
<itemizedlist>
70-
<listitem><para> d'un nom de cluster</para></listitem>
71-
<listitem><para> d'un ensemble de noeuds &slony1;, qui disposent chacun d'un schéma
72-
portant le nom du cluster</para></listitem>
96+
<listitem><para>d'un nom de cluster&nbsp;;</para></listitem>
97+
<listitem><para> d'un ensemble de n&oelig;uds &slony1;, qui disposent chacun
98+
d'un schéma portant le nom du cluster.</para></listitem>
7399
</itemizedlist>
100+
74101
</sect2>
102+
75103
<sect2><title>Ensemble de réplication</title>
76-
<indexterm>
77-
<primary>Ensemble de réplication</primary>
78-
</indexterm>
104+
<indexterm><primary>Ensemble de réplication</primary></indexterm>
105+
106+
<para>
107+
Un ensemble de réplication est défini comme un ensemble de tables et de
108+
séquences qui doivent être répliquées entre plusieurs n&oelig;uds dans un
109+
cluster &slony1;.
110+
</para>
79111

80-
<para>Un ensemble de réplication est défini comme un ensemble de tables et de séquences qui
81-
doivent être répliquées entre plusieurs noeuds dans un cluster &slony1;.</para>
112+
<para>
113+
Vous pouvez avoir plusieurs sets, et le <quote>flux</quote> de réplication
114+
n'est pas nécessairement identique pour tous les ensembles.
115+
</para>
82116

83-
<para>Vous pouvez avoir plusieurs sets, et le <quote>flux</quote> de réplication
84-
n'est pas nécessaire identique pour tous les ensembles.</para>
85117
</sect2>
86118

87-
<sect2><title> Origine, Fournisseurs et Abonnés</title>
88-
<indexterm>
89-
<primary>Noeud d'origine</primary>
90-
</indexterm>
91-
<indexterm>
92-
<primary>Noeud fournisseur</primary>
93-
</indexterm>
94-
95-
<para>Chaque ensemble de réplication a un noeud d'origine, qui est le <emphasis>seul</emphasis> endroit
96-
où les applications sont autorisées à modifier les données répliquées. On peut aussi
97-
rencontrer le terme <quote>noeud maître</quote>; Il s'agit de noeud principal qui
119+
<sect2><title>Origine, Fournisseurs et Abonnés</title>
120+
<indexterm><primary>N&oelig;ud d'origine</primary></indexterm>
121+
<indexterm><primary>N&oelig;ud fournisseur</primary></indexterm>
122+
123+
<para>
124+
Chaque ensemble de réplication a un n&oelig;ud d'origine, qui est le
125+
<emphasis>seul</emphasis> endroit où les applications sont autorisées à
126+
modifier les données répliquées. On peut aussi rencontrer le terme
127+
<quote>n&oelig;ud maître</quote>. Il s'agit du n&oelig;ud principal qui
98128
fournit les données.
99129
</para>
100130

101-
<indexterm>
102-
<primary>Noeud Abonné</primary>
103-
</indexterm>
131+
<indexterm><primary>N&oelig;ud Abonné</primary></indexterm>
132+
133+
<para>
134+
Les autres n&oelig;uds du cluster s'abonnent à l'ensemble de réplication, ce
135+
qui indique qu'ils veulent recevoir les données.
136+
</para>
104137

105-
<para>Les autres noeuds du cluster s'abonne à l'ensemble de réplication,
106-
ce qui indique qu'ils veulent recevoir les données.
138+
<para>
139+
Le n&oelig;ud d'origine ne sera jamais considéré comme un
140+
<quote>abonné</quote> (on ignore ici le cas ou le cluster est restructuré
141+
et où l'origine est explicitement déplacée sur un autre n&oelig;ud).
142+
Mais &slony1; supporte la notion d'abonnements en cascade, c'est-à-dire
143+
qu'un n&oelig;ud qui est abonné à un ensemble de réplication, peut également
144+
se comporter comme un <quote>fournisseur</quote> du même ensemble de
145+
réplication pour d'autres n&oelig;uds du cluster.
107146
</para>
108147

109-
<para>Le noeud d'origine ne sera jamais considéré comme un
110-
<quote>abonné</quote> (On ignore ici le cas ou le cluster est restructuré
111-
et où l'origine est explicitement déplacée sur un autre noeud).
112-
Mais &slony1; supporte la notion d'abonnements en cascade, c'est à dire
113-
qu'un noeud qui est abonné à un ensemble de réplication, peut également se
114-
comporter comme un <quote>fournisseur</quote> du même ensemble de réplication
115-
pour d'autres noeuds du cluster.</para>
116148
</sect2>
117149

118150
<sect2><title>Le démon slon</title>
119-
120151
<indexterm><primary>démon slon</primary></indexterm>
121152

122-
<para>Pour chaque noeud du cluster, il y a un processus <xref
123-
linkend="slon"/> qui gère l'activité de réplication pour le noeud.
153+
<para>
154+
Pour chaque n&oelig;ud du cluster, il y a un processus <xref
155+
linkend="slon"/> qui gère l'activité de réplication pour le n&oelig;ud.
124156
</para>
125157

126-
<para> <xref linkend="slon"/> est un programme implémenté en C qui traite les
127-
évènements de réplication. Il y a deux principales sortes d'événements :
158+
<para>
159+
<xref linkend="slon"/> est un programme implémenté en C qui traite les
160+
évènements de réplication. Il y a deux principaux types d'événements&nbsp;:
128161
</para>
129162

130163
<itemizedlist>
131164

132-
<listitem><para>Les évènements de configuration</para>
165+
<listitem>
166+
<para>Les évènements de configuration</para>
133167

134-
<para> Ils se produisent en général lorsqu'un script <xref linkend="slonik"/> est exécuté,
135-
et qu'il modifie la configuration du cluster. </para>
136-
</listitem>
168+
<para>
169+
Ils se produisent en général lorsqu'un script <xref linkend="slonik"/>
170+
est exécuté et qu'il modifie la configuration du cluster.
171+
</para>
172+
</listitem>
137173

138-
<listitem><para> Les événements <command>SYNC</command></para>
174+
<listitem>
175+
<para>Les événements <command>SYNC</command></para>
176+
177+
<para>
178+
Les mises à jour des tables répliquées sont regroupées dans des
179+
événements <command>SYNC</command>&nbsp;; ces groupes de transactions
180+
sont appliquées ensemble sur les n&oelig;uds abonnés.
181+
</para>
182+
</listitem>
139183

140-
<para> Les mises à jour des tables répliquées sont regroupées dans des événements <command>SYNC</command>s;
141-
Ces groupes de transactions sont appliquées ensemble sur les noeuds abonnés.
142-
</para>
143-
</listitem>
144184
</itemizedlist>
185+
145186
</sect2>
146187

147188
<sect2><title>La commande slonik</title>
148-
149189
<indexterm><primary>La commande slonik</primary></indexterm>
150190

151-
<para> La commande <xref linkend="slonik"/> traite des scripts
152-
écrits dans un <quote>langage spécial</quote> qui est utilisé pour
153-
soumettre des événements de configuration du cluster &slony1; cluster.
154-
Cela comprend des actions telles que l'ajout et la suppression de noeuds,
155-
la modifications des voies de communications, l'ajout ou la suppression d'abonnements.
191+
<para>
192+
La commande <xref linkend="slonik"/> traite des scripts écrits dans un
193+
<quote>langage spécial</quote> qui est utilisé pour soumettre des événements
194+
de configuration du cluster &slony1;. Cela comprend des actions telles que
195+
l'ajout et la suppression de n&oelig;uds, la modification des voies de
196+
communications, l'ajout ou la suppression d'abonnements.
156197
</para>
198+
157199
</sect2>
200+
158201
</sect1>

0 commit comments

Comments
 (0)