Skip to content

Commit

Permalink
Traduction de ref/alter_table.xml
Browse files Browse the repository at this point in the history
  • Loading branch information
@rjuju @gleu
rjuju authored and gleu committed Sep 8, 2014
1 parent c76d473 commit 1b7c163
Showing 1 changed file with 55 additions and 47 deletions.
102 changes: 55 additions & 47 deletions postgresql/ref/alter_table.xml
View file
Original file line number Diff line number Diff line change
Expand Up @@ -46,8 +46,8 @@ ALTER TABLE [ IF EXISTS ] <replaceable class="parameter">nom</replaceable>
ALTER [ COLUMN ] <replaceable class="parameter">nom_colonne</replaceable> SET STORAGE { PLAIN | EXTERNAL | EXTENDED | MAIN }
ADD <replaceable class="PARAMETER">contrainte_table</replaceable> [ NOT VALID ]
ADD <replaceable class="PARAMETER">contrainte_table_utilisant_index</replaceable>
ALTER CONSTRAINT <replaceable class="PARAMETER">constraint_name</replaceable> [ DEFERRABLE | NOT DEFERRABLE ] [ INITIALLY DEFERRED | INITIALLY IMMEDIATE ]
VALIDATE CONSTRAINT <replaceable class="PARAMETER">constraint_name</replaceable>
ALTER CONSTRAINT <replaceable class="PARAMETER">nom_constrainte</replaceable> [ DEFERRABLE | NOT DEFERRABLE ] [ INITIALLY DEFERRED | INITIALLY IMMEDIATE ]
VALIDATE CONSTRAINT <replaceable class="PARAMETER">nom_contrainte</replaceable>
DROP CONSTRAINT [ IF EXISTS ] <replaceable class="parameter">nom_contrainte</replaceable> [ RESTRICT | CASCADE ]
DISABLE TRIGGER [ <replaceable class="parameter">nom_declencheur</replaceable> | ALL | USER ]
ENABLE TRIGGER [ <replaceable class="parameter">nom_declencheur</replaceable> | ALL | USER ]
Expand All @@ -69,12 +69,12 @@ ALTER TABLE [ IF EXISTS ] <replaceable class="parameter">nom</replaceable>
NOT OF
OWNER TO <replaceable class="parameter">nouveau_proprietaire</replaceable>
SET TABLESPACE <replaceable class="parameter">nouvel_espacelogique</replaceable>
REPLICA IDENTITY {DEFAULT | USING INDEX <replaceable class="PARAMETER">index_name</replaceable> | FULL | NOTHING}
REPLICA IDENTITY {DEFAULT | USING INDEX <replaceable class="PARAMETER">nom_index</replaceable> | FULL | NOTHING}

<phrase>et <replaceable class="PARAMETER">table_constraint_using_index</replaceable> est:</phrase>

[ CONSTRAINT <replaceable class="PARAMETER">constraint_name</replaceable> ]
{ UNIQUE | PRIMARY KEY } USING INDEX <replaceable class="PARAMETER">index_name</replaceable>
[ CONSTRAINT <replaceable class="PARAMETER">nom_contrainte</replaceable> ]
{ UNIQUE | PRIMARY KEY } USING INDEX <replaceable class="PARAMETER">nom_index</replaceable>
[ DEFERRABLE | NOT DEFERRABLE ] [ INITIALLY DEFERRED | INITIALLY IMMEDIATE ]
</synopsis>
</refsynopsisdiv>
Expand All @@ -84,10 +84,12 @@ ALTER TABLE [ IF EXISTS ] <replaceable class="parameter">nom</replaceable>

<para>
<command>ALTER TABLE</command> modifie la définition d'une table existante.
Il existe plusieurs variantes described below. Note that the lock level required
may differ for each subform. An <literal>ACCESS EXCLUSIVE</literal> lock is held
unless explicitly noted. When multiple subcommands are listed, the lock
held will be the strictest one required from any subcommand.
Il existe plusieurs variantes décrites après. Il est à noter que le niveau
de verrouillage requis peut changer pour chaque variante. Un verrou
<literal>ACCESS EXCLUSIVE</literal> est utilisé à moins que le verrou ne soit
explicitement noté. Quand de multiples sous-commandes sont listées, le
verrou utilisé sera celui le plus strict requis pour l'ensemble des
sous-commandes.

<variablelist>
<varlistentry>
Expand Down Expand Up @@ -181,7 +183,7 @@ ALTER TABLE [ IF EXISTS ] <replaceable class="parameter">nom</replaceable>
<productname>PostgreSQL</productname>, voir <xref linkend="planner-stats"/>.
</para>
<para>
SET STATISTICS acquires a <literal>SHARE UPDATE EXCLUSIVE</literal> lock.
SET STATISTICS acquiert un verrou <literal>SHARE UPDATE EXCLUSIVE</literal>.
</para>
</listitem>
</varlistentry>
Expand Down Expand Up @@ -218,8 +220,8 @@ ALTER TABLE [ IF EXISTS ] <replaceable class="parameter">nom</replaceable>
linkend="planner-stats"/>.
</para>
<para>
Changing per-attribute options acquires a
<literal>SHARE UPDATE EXCLUSIVE</literal> lock.
Changer les options d'une propriété nécessite un verrou
<literal>SHARE UPDATE EXCLUSIVE</literal>.
</para>
</listitem>
</varlistentry>
Expand All @@ -231,7 +233,7 @@ ALTER TABLE [ IF EXISTS ] <replaceable class="parameter">nom</replaceable>
<literal>SET STORAGE</literal>
<indexterm>
<primary>TOAST</primary>
<secondary>per-column storage settings</secondary>
<secondary>réglages de stockage par colonne</secondary>
</indexterm>
</term>

Expand Down Expand Up @@ -336,8 +338,9 @@ ALTER TABLE [ IF EXISTS ] <replaceable class="parameter">nom</replaceable>
<term><literal>ALTER CONSTRAINT</literal></term>
<listitem>
<para>
This form alters the attributes of a constraint that was previously
created. Currently only foreign key constraints may be altered.
Cette forme modifie les propriétés d'une contrainte précédemment créée.
Pour le moment, seules les contraintes de clés étrangères peuvent être
modifiées.
</para>
</listitem>
</varlistentry>
Expand All @@ -358,14 +361,15 @@ ALTER TABLE [ IF EXISTS ] <replaceable class="parameter">nom</replaceable>
L'intérêt de séparer la validation de la création initiale est que vous
pouvez déférer la validation à un moment plus calme, ou peut être utilisé
pour donner un temps supplémentaire pour corriger les erreurs existantes
tout en évitant de nouvelles erreurs. Note also that validation on its own
does not prevent normal write commands against the table while it runs.
tout en évitant de nouvelles erreurs. À noter également que la
validation en elle-même n'empêche pas les écritures normales sur la table
pendant qu'elle est en cours.
</para>
<para>
Validation acquires only a <literal>SHARE UPDATE EXCLUSIVE</literal> lock
on the table being altered. If the constraint is a foreign key then
a <literal>ROW SHARE</literal> lock is also required on
the table referenced by the constraint.
La validation ne nécessite qu'un verrou <literal>SHARE UPDATE EXCLUSIVE</literal>
sur la table en cours de modification. Si la contrainte est une clé
étrangère, alors un verrou <literal>ROW SHARE</literal> est également
nécessaire sur la table référencée par la contrainte.
</para>
</listitem>
</varlistentry>
Expand Down Expand Up @@ -438,7 +442,7 @@ ALTER TABLE [ IF EXISTS ] <replaceable class="parameter">nom</replaceable>
La table n'est pas réorganisée.
</para>
<para>
Changing cluster options acquires a <literal>SHARE UPDATE EXCLUSIVE</literal> lock.
Changer les options de cluster nécessite un verrou <literal>SHARE UPDATE EXCLUSIVE</literal>.
</para>
</listitem>
</varlistentry>
Expand All @@ -452,7 +456,7 @@ ALTER TABLE [ IF EXISTS ] <replaceable class="parameter">nom</replaceable>
utilisée. Cela agit sur les opérations de réorganisation suivantes qui ne spécifient pas d'index.
</para>
<para>
Changing cluster options acquires a <literal>SHARE UPDATE EXCLUSIVE</literal> lock.
Changer les options de cluster nécessite un verrou <literal>SHARE UPDATE EXCLUSIVE</literal>.
</para>
</listitem>
</varlistentry>
Expand Down Expand Up @@ -617,18 +621,21 @@ ALTER TABLE [ IF EXISTS ] <replaceable class="parameter">nom</replaceable>
<term><literal>REPLICA IDENTITY</literal></term>
<listitem>
<para>
This form changes the information which is written to the write-ahead log
to identify rows which are updated or deleted. This option has no effect
except when logical replication is in use. <literal>DEFAULT</literal>
(the default for non-system tables) records the
old values of the columns of the primary key, if any. <literal>USING INDEX</literal>
records the old values of the columns covered by the named index, which
must be unique, not partial, not deferrable, and include only columns marked
<literal>NOT NULL</literal>. <literal>FULL</literal> records the old values of all columns
in the row. <literal>NOTHING</literal> records no information about the old row.
(This is the default for system tables.)
In all cases, no old values are logged unless at least one of the columns
that would be logged differs between the old and new versions of the row.
Cette forme change l'information écrite dans les journaux de transactions
permettant d'identifier les lignes qui sont mises à jour ou supprimées.
Cette option n'a pas d'effet si la réplication logique n'est pas
utilisée. <literal>DEFAULT</literal> (la valeur par défaut pour les
tables non systèmes) enregistre les anciennes valeurs des colonnes de la
clé primaire, s'il y en a une. <literal>USING INDEX</literal> enregistre
les anciennes valeurs des colonnes couvertes par l'index, qui doit être
de type unique, non partiel, non différée, et inclut uniquement les
colonnes marquées <literal>NOT NULL</literal>. <literal>FULL</literal>
enregistre les anciennes valeurs de toutes les colonnes de la ligne.
<literal>NOTHING</literal> n'enregistre aucune information sur l'ancienne
ligne. (Il s'agit de la valeur par défaut pour les tables systèmes).
Dans tous les cas, aucune ancienne valeur ne sera enregistrée sauf si au
moins une des colonnes qui aurait du être enregistrée présente des
différences entre les anciennes et les nouvelles versions de la ligne.
</para>
</listitem>
</varlistentry>
Expand Down Expand Up @@ -901,17 +908,17 @@ ALTER TABLE [ IF EXISTS ] <replaceable class="parameter">nom</replaceable>
les lignes existantes de cette table sont initialisées avec la valeur par
défaut de la colonne (NULL si aucune clause <literal>DEFAULT</literal> n'a été
définie).
If there is no <literal>DEFAULT</literal> clause, this is merely a metadata
change and does not require any immediate update of the table's data;
the added NULL values are supplied on readout, instead.
S'il n'y a pas de clause <literal>DEFAULT</literal>, il s'agit seulement
d'un changement de métadonnée qui ne nécessite pas une mise à jour
immédiate des données de la table&nbsp;; les valeurs NULL ajoutées sont
fournies lors de la lecture, à la place.
</para>

<para>
Adding a column with a <literal>DEFAULT</literal> clause or changing the type of
an existing column will require the entire table and its indexes to be
rewritten. As an exception when changing the type of an existing column,
if the <literal>USING</literal> clause
ne change pas le
AJouter une colonne avec une clause <literal>DEFAULT</literal> ou changer
le type d'une colonne existante nécessitera la réécriture de la totalité de
la table ainsi que de ses index. La seule exception sur le changement de
type d'une colonne existante est si la clause <literal>USING</literal> ne change pas le
contenu de la colonne et que l'ancien type est soit transformable de façon binaire
dans le nouveau type, ou bien un domaine sans contrainte reposant sur le nouveau type, alors
il n'est pas nécessaire de réécrire la table, mais tous les index sur les colonnes affectées
Expand Down Expand Up @@ -1123,10 +1130,11 @@ ALTER TABLE ONLY distributeurs DROP CONSTRAINT verif_cp;
</para>

<para>
To add a foreign key constraint to a table with the least impact on other work:
Pour ajouter une contrainte de clé étrangère à une table avec le moins
d'impact sur le reste de l'activité&nbsp;
<programlisting>
ALTER TABLE distributors ADD CONSTRAINT distfk FOREIGN KEY (address) REFERENCES addresses (address) NOT VALID;
ALTER TABLE distributors VALIDATE CONSTRAINT distfk;
ALTER TABLE distributeurs ADD CONSTRAINT distfk FOREIGN KEY (address) REFERENCES adresses (adresse) NOT VALID;
ALTER TABLE distributeurs VALIDATE CONSTRAINT distfk;
</programlisting>
</para>

Expand Down Expand Up @@ -1188,7 +1196,7 @@ ALTER TABLE distributeurs DROP CONSTRAINT distributeurs_pkey,
</refsect1>

<refsect1>
<title>See Also</title>
<title>Voir aussi</title>

<simplelist type="inline">
<member><xref linkend="sql-createtable"/></member>
Expand Down

0 comments on commit 1b7c163

Please sign in to comment.