Changeset 1122
- Timestamp:
- 08/21/08 18:58:41 (3 months ago)
- Files:
-
- traduc/trunk/slony/slonik_ref.xml (modified) (18 diffs)
Legend:
- Unmodified
- Added
- Removed
- Modified
- Copied
- Moved
traduc/trunk/slony/slonik_ref.xml
r1118 r1122 1097 1097 1098 1098 <para> Sur les noeus abonnés, ces modifications sont 1099 réalisée sur la table losqu'elle est vode, et perturbe1099 réalisées sur la table losqu'elle est vode, et perturbe 1100 1100 pas particuliÚrement l'abonnement au cours du verrouillage 1101 1101 sur le noeud abonné.</para> … … 1167 1167 </varlistentry> 1168 1168 <varlistentry><term><literal> COMMENT = 'chaîne' </literal></term> 1169 <listitem><para> Un text descriptif peut être ajoutéepour l'ensemble de réplication.</para>1170 <para> Si aucun ecommentaire n'est fourni, la valeur par défaut est <command>A replication set so boring no one thought to give it a name</command> (NdT : <quote>Un ensemble de réplication tellement1169 <listitem><para> Un texte descriptif peut être ajouté pour l'ensemble de réplication.</para> 1170 <para> Si aucun commentaire n'est fourni, la valeur par défaut est <command>A replication set so boring no one thought to give it a name</command> (NdT : <quote>Un ensemble de réplication tellement 1171 1171 ennuyeux qui personne n'a pensé à lui donner un nom</quote>) 1172 1172 </para> … … 1339 1339 <refnamediv><refname>SET ADD TABLE</refname> 1340 1340 1341 <refpurpose> A dd a table to a&slony1;1342 replication set</refpurpose></refnamediv>1341 <refpurpose> Ajoute une table dans un ensemble de réplication &slony1; 1342 </refpurpose></refnamediv> 1343 1343 1344 1344 <refsynopsisdiv> … … 1350 1350 <title>Description</title> 1351 1351 1352 <para> A dd an existing usep table to a replication set. The set1353 cannot currently be subscribed by any other node - that1354 functionality is supported by the <xref linkend="stmtmergeset"/>1355 command.1352 <para> Ajoute une table existante dans un ensemble de réplication. L'ensemble ne doit 1353 pas être répliqué sur un autre noeud, cette fonctionnalité est assurée par la commande 1354 Add an existing usep table to a replication set. The set 1355 <xref linkend="stmtmergeset"/>. 1356 1356 1357 1357 <variablelist> 1358 1358 <varlistentry><term><literal> SET ID = ival </literal></term> 1359 <listitem><para> I D of the set to which the table is to be added. </para></listitem>1359 <listitem><para> Identifiant de l'ensemble dans lequel la table doit être ajoutée. </para></listitem> 1360 1360 </varlistentry> 1361 1361 <varlistentry><term><literal> ORIGIN = ival </literal></term> 1362 <listitem><para> Origin node for the set. A future version of<application>slonik</application>1363 might figure out this information by itself.</para></listitem>1362 <listitem><para> Noeuf origine de l'ensemble. Les prochaines version de <application>slonik</application> 1363 devraient pouvoir deviner cette information.</para></listitem> 1364 1364 </varlistentry> 1365 1365 <varlistentry><term><literal> ID = ival </literal></term> 1366 1366 1367 <listitem><para> Unique ID of the table. These ID's are not 1368 only used to uniquely identify the individual table within the 1369 replication system. The numeric value of this ID also 1370 determines the order in which the tables are locked in a <xref 1371 linkend="stmtlockset"/> command for example. So 1372 these numbers should represent any applicable table hierarchy 1373 to make sure the <application>slonik</application> command 1374 scripts do not deadlock at any critical 1375 moment.</para> 1376 1377 <para> This ID must be unique across all sets; you cannot 1378 have two tables in the same cluster with the same 1379 ID. </para></listitem> 1367 <listitem><para> Identifiant unique de la table. Ces identifiants ne sont 1368 pas seulement utilisé pour désigner une table dans l'ensemble de réplication. 1369 Cette valeur numérique détermine également l'ordre de verrouillage des tables, 1370 notamment lors de la commande <xref linkend="stmtlockset"/>. 1371 Cet identifiant doit donc suivre une certaine hiérachie afin que les scripts 1372 <application>slonik</application> ne provoque de situation d'inter-blocage ("deadlocks"). 1373 </para> 1374 1375 <para> Cet identifiant doit être unique pour tous les ensembles de réplication; 1376 vous ne devez pas avoir deux tables du même cluster avec le même identifiant. 1377 </para></listitem> 1380 1378 </varlistentry> 1381 1379 <varlistentry><term><literal> FULLY QUALIFIED NAME = 'string' </literal></term> 1382 <listitem><para> The full table name as described in1380 <listitem><para> Le nom complet de la table tel que décrit dans 1383 1381 <xref linkend="stmttableaddkey"/>.</para></listitem> 1384 1382 </varlistentry> 1385 1383 <varlistentry><term><literal> KEY = { 'string' | SERIAL } 1386 1384 </literal></term> <listitem><para> 1387 <emphasis>(Optional)</emphasis> The index name that covers the 1388 unique and not null set of columns to be used as the row identifier 1389 for replication purposes. Or the keyword SERIAL to use the 1390 special column added with a previous <xref 1391 linkend="stmttableaddkey"/> command. Default 1392 is to use the table's primary key. The index name is <emphasis> 1393 not </emphasis> fully qualified; you must omit the 1394 namespace.</para></listitem> 1385 <emphasis>(Facultatif)</emphasis> Le nom de l'index relatif à la colonne unique et 1386 non-nulle qui est utilisée comme identifiant de ligne lors de la réplication. 1387 Si le mot-clef SERIAL est utilisé, cela indique qu'il faut utiliser la colonne 1388 spéciale ajoutée avec la commande <xref linkend="stmttableaddkey"/> command. 1389 Par défaut, on utilise la clef primaire de la table. Le nom de l'index n'est 1390 <emphasis>pas</emphasis> un nom complet; vous devez omettre l'espace de nom.</para></listitem> 1395 1391 1396 1392 </varlistentry> 1397 1393 <varlistentry><term><literal> COMMENT = 'string' </literal></term> 1398 <listitem><para> A descriptive text added to the table entry. </para></listitem>1394 <listitem><para> Un texte décrivant la table. </para></listitem> 1399 1395 </varlistentry> 1400 1396 </variablelist> 1401 1397 </para> 1402 <para> This uses&funsetaddtable;. </para>1398 <para> Cette commande utilise &funsetaddtable;. </para> 1403 1399 </refsect1> 1404 1400 <refsect1><title>Exemple</title> … … 1409 1405 ID = 20, 1410 1406 FULLY QUALIFIED NAME = 'public.tracker_ticket', 1411 COMMENT = ' Support ticket'1407 COMMENT = 'Ticket de Support' 1412 1408 ); 1413 1409 </programlisting> 1414 1410 </refsect1> 1415 <refsect1> <title> Error Messages </title> 1416 1417 <para> Here are some of the error messages you may encounter if 1418 adding tables incorrectly: </para> 1411 <refsect1> <title> Messages d'erreur </title> 1412 1413 <para> Voici quelque messages d'erreurs que vous rencontrerez en cas d'utilisation incorrecte : </para> 1419 1414 1420 1415 <variablelist> 1421 <varlistentry><term><literal>Slony-I: setAddTable_int: table public.my_table PK column id nullable </literal></term> 1422 1423 <listitem><para> Primary keys (or candidates thereof) are 1424 required to have all column defined as <command>NOT 1425 NULL</command>. If you have a PK candidate that has columns 1426 that are not thus restricted, &slony1; will reject the table 1427 with this message. </para> </listitem> </varlistentry> 1416 <varlistentry><term><literal>Slony-I: setAddTable_int: table public.ma_table PK column id nullable </literal></term> 1417 1418 <listitem><para> Les clefs primaires (ou les clefs candidates) doivent être composées 1419 de colonnes <command>NOT NULL</command>. Si vous avez une clef primaire candidate dont une 1420 colonne n'est pas déclarée ainsi, alors &slony1; rejetera la table et produira ce message. </para> 1421 </listitem> </varlistentry> 1428 1422 1429 1423 <varlistentry><term><literal>Slony-I: setAddTable_int: table id 14 has already been assigned! </literal></term> 1430 1424 1431 <listitem><para> The table id, stored in1432 <envar>sl_table.tab_id</envar>, is required to be unique1433 across all tables/nodes/sets. Apparently you have tried to 1434 reused a table ID.</para> </listitem> </varlistentry>1435 1436 <varlistentry><term><literal> Slony-I: setAddTable_int(): table public.m y_table has no index mt_idx_14</literal></term>1437 1438 <listitem><para> This will normally occur with candidate1439 primary keys; apparently the index specified is not available 1440 on this node.</para> </listitem> </varlistentry>1441 1442 <varlistentry><term><literal>Slony-I: setAddTable_int(): table public.m y_table not found </literal></term>1443 1444 <listitem><para> Worse than an index missing, the whole table1445 is missing. Apparently whatever process you were using to get 1446 the schema into place everywhere didn't work properly. </para>1425 <listitem><para> L'identifiant de la table, stocké dans 1426 <envar>sl_table.tab_id</envar>, doit être unique pour tous les noeuds/tables/ensembles. 1427 Ce message indique que vous avez tenté de déclarer un identifiant qui est déjà utilisé. 1428 </para> </listitem> </varlistentry> 1429 1430 <varlistentry><term><literal> Slony-I: setAddTable_int(): table public.ma_table has no index mt_idx_14</literal></term> 1431 1432 <listitem><para> Ceci se produit en général avec les clefs primaires candidates; 1433 Le message indique que l'index spécifié n'est pas disponible sur ce noeud. 1434 </para> </listitem> </varlistentry> 1435 1436 <varlistentry><term><literal>Slony-I: setAddTable_int(): table public.ma_table not found </literal></term> 1437 1438 <listitem><para> Pire que l'absence d'un index, c'est la table qui est manquante. 1439 Le message indique que le processus que vous avez utilisé pour mettre en place le schéma n'a pas 1440 fonctionné correctement. </para> 1447 1441 </listitem> </varlistentry> 1448 1442 1449 <varlistentry><term><literal> Slony-I: setAddTable_int(): public.my_view is not a regular table </literal></term> 1450 1451 <listitem><para> You can only replicate (at least, using 1452 <command>SET ADD TABLE</command>) objects that are ordinary 1453 tables. That doesn't include views or indexes. (Indexes can 1454 come along for the ride, but you don't ask to replicate an 1455 index...) </para> </listitem> </varlistentry> 1443 <varlistentry><term><literal> Slony-I: setAddTable_int(): public.ma_vue is not a regular table </literal></term> 1444 1445 <listitem><para> Vous ne pouvez répliquer que des tables (en tout cas avec 1446 <command>SET ADD TABLE</command>). Cela n'inclut pas les vues et les indexes. 1447 ( Les index sont répliqués de facto, mais on peut pas demander explicitement la réplication d'un index ) 1448 </para> </listitem> </varlistentry> 1456 1449 1457 1450 <varlistentry><term><literal> Slony-I: setAddTable_int(): set 4 not found </literal></term> 1458 1451 1459 <listitem><para> You need to define a replication set before1460 assigning tables to it.</para> </listitem> </varlistentry>1452 <listitem><para> Vous devez définit l'ensemble de réplication avant de lui assigner des tables. 1453 </para> </listitem> </varlistentry> 1461 1454 1462 1455 <varlistentry><term><literal> Slony-I: setAddTable(): set 4 has remote origin </literal></term> 1463 1456 1464 <listitem><para> This will occur if set 4 is configured with, 1465 as origin, node 1, and then you submit a <command>SET ADD 1466 TABLE</command> request involving that set to some other node 1467 than node 1. This would be expected to occur if there was 1468 some confusion in the <command>admin conninfo</command> 1469 configuration in the slonik script preamble...</para> 1457 <listitem><para> Ceci se produit lorsque l'ensemble de réplication #4 est configuré 1458 sur une origine, le noeud 1, et que vous lancez une commande <command>SET ADD 1459 TABLE</command> qui spécifie un autre noeud que le noeud 1. Ceci se produit généralement 1460 lorsque la configuration <command>admin conninfo</command> est confuse à l'intérieur du 1461 préambule du script slonik...</para> 1470 1462 </listitem> 1471 1463 </varlistentry> … … 1473 1465 <varlistentry><term><literal>Slony-I: cannot add table to currently subscribed set 1 </literal></term> 1474 1466 1475 <listitem><para> &slony1; does not support adding tables to 1476 sets that are already participating in subscriptions. 1477 Probably you need to define a new set to associate additional 1478 tables to. </para> </listitem> </varlistentry> 1467 <listitem><para> &slony1; ne peut pas ajouter des tables dans un ensemble qui est 1468 en cours de réplication. Pour contourner ce problÚme, vous devez définir un nouvel ensemble 1469 qui contiendra les nouvelles tables.</para> </listitem> </varlistentry> 1479 1470 1480 1471 </variablelist> … … 1483 1474 <refsect1> <title> Utilisation de verrous </title> 1484 1475 1485 <para> On the origin node, this operation requires a brief 1486 exclusive lock on the table in order to alter it to add the 1487 replication trigger. On subscriber nodes, corresponding locking 1488 takes place at the time of the <command>SUBSCRIBE_SET</command> 1489 event. </para> 1476 <para> Sur le noeud orgine, cette opération demande un verrou exclusif trÚs bref sur la table 1477 afin de lui ajouter les triggers de réplication. Sur les noeuds abonnés, les verrous 1478 correspondant sont réalisés au moment de l'événement <command>SUBSCRIBE_SET</command>. </para> 1490 1479 </refsect1> 1491 1480 <refsect1> <title> Note de version </title> … … 1501 1490 <refnamediv><refname>SET ADD SEQUENCE</refname> 1502 1491 1503 <refpurpose> Add a sequence to a 1504 &slony1; replication set 1492 <refpurpose> Ajoute une séquence dans un ensemble de réplication 1505 1493 </refpurpose></refnamediv> 1506 1494 … … 1514 1502 1515 1503 <para> 1516 Add an existing user sequence to a replication set. The set 1517 cannot currently be subscribed by any other node - that 1518 functionality is supported by the <xref linkend="stmtmergeset"/> 1519 command. 1504 Ajoute une séquence existante dans un ensemble de réplication. L'ensemble ne 1505 doit pas être répliqué sur un autre noeud. Cette fonctionnalité est supportée 1506 par la commande <xref linkend="stmtmergeset"/>. 1520 1507 1521 1508 <variablelist> 1522 1509 <varlistentry><term><literal> SET ID = ival </literal></term> 1523 <listitem><para> I D of the set to which the sequence is to be added.1510 <listitem><para> Identifiant de l'ensemble dans lequel on ajoute la séquence. 1524 1511 </para></listitem> 1525 1512 </varlistentry> 1526 1513 <varlistentry><term><literal> ORIGIN = ival </literal></term> 1527 <listitem><para> Origin node for the set. A future version of<application>slonik</application>1528 might figure out this information by itself.</para></listitem>1514 <listitem><para> Noeud d'origine de l'ensemble. Les prochaines version de <application>slonik</application> 1515 devraient pouvoir deviner cette information.</para></listitem> 1529 1516 </varlistentry> 1530 1517 <varlistentry><term><literal> ID = ival </literal></term> 1531 1518 1532 <listitem><para> Unique ID of the sequence. <note><para> Note 1533 that this ID needs to be unique <emphasis>across 1534 sequences</emphasis> throughout the cluster; the numbering of 1535 tables is separate, so you might have a table with ID 20 and a 1536 sequence with ID 20, and they would be recognized as 1537 separate.</para> </note></para></listitem> 1519 <listitem><para> Identifiant Unique de la séquence. <note><para> Notons 1520 que cet identifiant doit être unique parmi <emphasis>toutes les séquences</emphasis> 1521 du cluster; la numérotation des tables est indépendante, donc il est possible 1522 de donner l'identifiant 20 à une table et à une séquence, sans que cela ne crée de confusion. 1523 </para> </note></para></listitem> 1538 1524 1539 1525 </varlistentry> 1540 1526 <varlistentry><term><literal> FULLY QUALIFIED NAME = 'string' </literal></term> 1541 <listitem><para> The full sequence name as described in1527 <listitem><para> Le nom complet de la séquence telle que décrit dans 1542 1528 <xref linkend="stmttableaddkey"/>.</para></listitem> 1543 1529 </varlistentry> 1544 1530 <varlistentry><term><literal> COMMENT = 'string' </literal></term> 1545 <listitem><para> A descriptive text added to the sequence entry. </para></listitem>1531 <listitem><para> Un texte décrivant la séquence. </para></listitem> 1546 1532 </varlistentry> 1547 1533 </variablelist> 1548 1534 </para> 1549 <para> This uses&funsetaddsequence;. </para>1535 <para> Cette commande utilise la fonction &funsetaddsequence;. </para> 1550 1536 </refsect1> 1551 1537 <refsect1><title>Exemple</title> … … 1556 1542 ID = 20, 1557 1543 FULLY QUALIFIED NAME = 'public.tracker_ticket_id_seq', 1558 COMMENT = 'S upport ticket ID sequence'1544 COMMENT = 'Séquence d'identifiants des tickets de support' 1559 1545 ); 1560 1546 </programlisting> … … 1576 1562 <refnamediv><refname>SET DROP TABLE</refname> 1577 1563 1578 <refpurpose> Remove a table from a 1579 &slony1; replication set 1564 <refpurpose> Supprime une table d'un ensemble de réplication &slony1; 1580 1565 </refpurpose></refnamediv> 1581 1566 … … 1589 1574 1590 1575 <para> 1591 Drop a table from a replication set.1592 </para> 1593 <para> 1594 Note that this action will <emphasis>not</emphasis> drop a1595 candidate primary key created using<xref1576 Supprime une table d'un ensemble de réplication. 1577 </para> 1578 <para> 1579 Notez que cette action ne supprimera <emphasis>pas</emphasis> une clef primaire 1580 candidate créée avec la commande <xref 1596 1581 linkend="stmttableaddkey"/>. 1597 1582 1598 1583 <variablelist> 1599 1584 <varlistentry><term><literal> ORIGIN = ival </literal></term> 1600 <listitem><para> Origin node for the set. A future version of<application>slonik</application>1601 might figure out this information by itself.</para></listitem>1585 <listitem><para> Noeud d'origine de l'ensemble de réplication.Les prochaines versions de <application>slonik</application> 1586 devraient pouvoir deviner cette information. </para></listitem> 1602 1587 </varlistentry> 1603 1588 <varlistentry><term><literal> ID = ival </literal></term> 1604 1589 1605 <listitem><para> Unique ID of thetable.</para></listitem></varlistentry>1590 <listitem><para> Identifiant unique de la table.</para></listitem></varlistentry> 1606 1591 </variablelist> 1607 1592 </para> 1608 <para> This uses&funsetdroptable;. </para>1593 <para> Cette commande utilise la fonction &funsetdroptable;. </para> 1609 1594 </refsect1> 1610 1595 <refsect1><title>Exemple</title> … … 1618 1603 <refsect1> <title> Utilisation de verrous </title> 1619 1604 1620 <para> This operation must acquire an exclusive lock on the table1621 being dropped from replication in order to alter it to drop the1622 replication trigger. On subscriber nodes, this also involves1623 adding back any rules/triggers that have been hidden.</para>1605 <para> Cette opération pose un verrou exclusif sur la table qui est supprimée afin 1606 de retirer les triggers de réplication. Sur les noeuds abonnées, cela implique également 1607 le rétablissement des rÚgles et des triggers qui ont été désactivés. 1608 </para> 1624 1609 </refsect1> 1625 1610 <refsect1> <title> Note de version </title> … … 1635 1620 <refnamediv><refname>SET DROP SEQUENCE</refname> 1636 1621 1637 <refpurpose> Remove a sequence from a 1638 &slony1; replication set 1622 <refpurpose> Supprime une séquence d'un ensemble de réplication &slony1; 1639 1623 </refpurpose></refnamediv> 1640 1624 … … 1648 1632 1649 1633 <para> 1650 Drops an existing user sequence from a replication set.1634 Supprime une séquence existante dans un ensemble de réplication. 1651 1635 <variablelist> 1652 1636 <varlistentry><term><literal> ORIGIN = ival </literal></term> 1653 <listitem><para> Origin node for the set. A future version of<application>slonik</application>1654 might figure out this information by itself.</para></listitem>1637 <listitem><para> Noeud d'origine de l'ensemble. Les prochaines versions de <application>slonik</application> 1638 devraient pouvoir deviner cette information.</para></listitem> 1655 1639 </varlistentry> 1656 1640 <varlistentry><term><literal> ID = ival </literal></term> 1657 1641 1658 <listitem><para> Unique ID of the sequence.</para></listitem>1642 <listitem><para> Identifiant unique de la séquence.</para></listitem> 1659 1643 1660 1644 </varlistentry> 1661 1645 </variablelist> 1662 1646 </para> 1663 <para> This uses&funsetdropsequence;. </para>1647 <para> Cette commande utilise la fonction &funsetdropsequence;. </para> 1664 1648 </refsect1> 1665 1649 <refsect1><title>Exemple</title> … … 1687 1671 <refnamediv><refname>SET MOVE TABLE</refname> 1688 1672 1689 <refpurpose> Move a table from one 1690 &slony1; replication set to another 1673 <refpurpose> Déplace une table d'un ensemble de réplication vers un autre. 1691 1674 </refpurpose></refnamediv> 1692 1675 … … 1700 1683 1701 1684 <para> 1702 Change the set a table belongs to. The current set and the new1703 set must origin on the same node and subscribed by the same1704 nodes. <caution><para> Due to the way subscribing to new sets1705 works make absolutely sure that the subscription of all nodes to1706 the sets is completely processed before moving tables. Moving a1707 table too early to a new set causes the subscriber to try and add1708 the table already during the subscription process, which fails1709 with a duplicate key error and breaks1710 replication.</para></caution>1685 Change l'ensemble de réplication dans lequel se trouve la table. L'ensemble courant et le 1686 nouveau doivent avoir le même noeud origine et les même noeuds abonnés. 1687 1688 <caution><para> La méthode d'abonnement d'un nouvel ensemble de réplication 1689 permet de garantir que l'abonnement est complÚtement effectué sur tous les noeuds 1690 avant que le tables soient déplacées. Déplacer une table trop tÃŽt vers un nouvel ensemble, 1691 implique que le noeud abonné va essayer d'ajouter la table pendant le processus d'abonnement 1692 de l'ensemble de réplication, ce qui échoue suite à une erreur de clef dupliquée et provoque 1693 l'arrêt de la réplication.</para></caution> 1711 1694 1712 1695 <variablelist> 1713 1696 <varlistentry><term><literal> ORIGIN = ival </literal></term> 1714 <listitem><para> Current origin of the set. A future version of<application>slonik</application>1715 might figure out this information by itself.</para></listitem>1697 <listitem><para> Origine actuelle de l'ensemble. Les prochaines versions de <application>slonik</application> 1698 devraient pouvoir deviner cette information.</para></listitem> 1716 1699 </varlistentry> 1717 1700 <varlistentry><term><literal> ID = ival </literal></term> 1718 1701 1719 <listitem><para> Unique ID of thetable.</para></listitem></varlistentry>1702 <listitem><para> Identifiant unique de la table.</para></listitem></varlistentry> 1720 1703 <varlistentry><term><literal> NEW SET = ival </literal></term> 1721 1704 1722 <listitem><para> Unique ID of the set to which the table should be added.</para></listitem></varlistentry>1705 <listitem><para> Identifiant unique de l'ensemble dans lequel il faut ajouter la table.</para></listitem></varlistentry> 1723 1706 </variablelist> 1724 1707 </para> 1725 <para> This uses&funsetmovetable;. </para>1708 <para> Cette commande utilise la fonction &funsetmovetable;. </para> 1726 1709 </refsect1> 1727 1710 <refsect1><title>Exemple</title> … … 1751 1734 <refnamediv><refname>SET MOVE SEQUENCE</refname> 1752 1735 1753 <refpurpose> Move a sequence from one 1754 &slony1; replication set to another 1736 <refpurpose> Déplace une séquence d'un ensemble de réplication &slony1; vers un autre. 1755 1737 </refpurpose></refnamediv> 1756 1738

