Skip to content

Commit

Permalink
Relecture en attendant la fin de l'isolement...
Browse files Browse the repository at this point in the history
  • Loading branch information
@gleu
gleu committed Jul 19, 2022
1 parent e7cc18f commit 3344d93
Show file tree
Hide file tree
Showing 44 changed files with 1,887 additions and 1,908 deletions.
2 changes: 1 addition & 1 deletion postgresql/manage-ag.xml
View file
Original file line number Diff line number Diff line change
Expand Up @@ -504,7 +504,7 @@ CREATE TABLE foo(i int);</programlisting>
Deux tablespaces sont automatiquement créés lors de l'initialisation du
cluster de bases de données. Le tablespace <literal>pg_global</literal>
est utilisé pour les catalogues système partagés. Le tablespace
<literal>pg_default</literal> est l'espace logique par défaut des bases de
<literal>pg_default</literal> est le tablespace par défaut des bases de
données <literal>template1</literal> et <literal>template0</literal> (et,
du coup, sera le tablespace par défaut pour les autres bases de données
sauf en cas de surcharge par une clause <literal>TABLESPACE</literal> dans
Expand Down
28 changes: 13 additions & 15 deletions postgresql/ref/abort.xml
View file
Original file line number Diff line number Diff line change
Expand Up @@ -25,12 +25,11 @@ ABORT [ WORK | TRANSACTION ] [ AND [ NO ] CHAIN ]
<title>Description</title>

<para>
<command>ABORT</command> annule la transaction en cours et
toutes les mises à jour effectuées pendant cette transaction.
Cette commande a un comportement identique
à la commande <acronym>SQL</acronym>
<link linkend="sql-rollback"><command>ROLLBACK</command></link>.
Elle n'est présente que pour des raisons historiques.
<command>ABORT</command> annule la transaction en cours et toutes les mises à
jour effectuées pendant cette transaction. Cette commande a un comportement
identique à la commande <acronym>SQL</acronym> <link
linkend="sql-rollback"><command>ROLLBACK</command></link>. Elle n'est
présente que pour des raisons historiques.
</para>
</refsect1>

Expand All @@ -53,11 +52,10 @@ ABORT [ WORK | TRANSACTION ] [ AND [ NO ] CHAIN ]
<listitem>
<para>
Si la clause <literal>AND CHAIN</literal> est indiquée, une nouvelle
transaction est immédiatement démarrée avec les mêmes caractéristiques
de transaction (voir <link linkend="sql-set-transaction"><command>SET
TRANSACTION</command></link>) que celle
qui vient de se terminer. Sinon aucune nouvelle transaction n'est
démarrée.
transaction est immédiatement démarrée avec les mêmes caractéristiques de
transaction (voir <link linkend="sql-set-transaction"><command>SET
TRANSACTION</command></link>) que celle qui vient de se terminer. Sinon
aucune nouvelle transaction n'est démarrée.
</para>
</listitem>
</varlistentry>
Expand All @@ -68,13 +66,13 @@ ABORT [ WORK | TRANSACTION ] [ AND [ NO ] CHAIN ]
<title>Notes</title>

<para>
<link linkend="sql-commit"><command>COMMIT</command></link> est utilisé
pour terminer avec succès une transaction.
<link linkend="sql-commit"><command>COMMIT</command></link> est utilisé pour
terminer avec succès une transaction.
</para>

<para>
Exécuter <command>ABORT</command> à l'extérieur de toute transaction
provoque un message d'avertissement mais ne cause aucun dégât.
Exécuter <command>ABORT</command> à l'extérieur de toute transaction provoque
un message d'avertissement mais ne cause aucun dégât.
</para>
</refsect1>

Expand Down
79 changes: 37 additions & 42 deletions postgresql/ref/alter_aggregate.xml
View file
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@ ALTER AGGREGATE <replaceable>nom</replaceable> ( <replaceable>signature_agrégat
OWNER TO { <replaceable>nouveau_propriétaire</replaceable> | CURRENT_ROLE | CURRENT_USER | SESSION_USER }
ALTER AGGREGATE <replaceable>nom</replaceable> ( <replaceable>signature_agrégat</replaceable> ) SET SCHEMA <replaceable>nouveau_schéma</replaceable>

<phrase>where <replaceable>signature_agrégat</replaceable> is:</phrase>
<phrase>où <replaceable>signature_agrégat</replaceable> correspond à&nbsp;:</phrase>

* |
[ <replaceable>mode_arg</replaceable> ] [ <replaceable>nom_arg</replaceable> ] <replaceable>type_arg</replaceable> [ , ... ] |
Expand All @@ -39,17 +39,16 @@ ALTER AGGREGATE <replaceable>nom</replaceable> ( <replaceable>signature_agrégat
</para>

<para>
Seul le propriétaire de la fonction d'agrégat peut utiliser
<command>ALTER AGGREGATE</command>. Pour modifier le schéma
d'une fonction d'agrégat, il est
nécessaire de posséder le droit <literal>CREATE</literal> sur le nouveau schéma.
Pour modifier le propriétaire de la fonction, il faut être un membre direct ou
indirect du nouveau rôle propriétaire, rôle qui doit en outre posséder le droit
<literal>CREATE</literal> sur le schéma de la fonction d'agrégat.
Ces restrictions assurent que la modification du propriétaire
ne permet pas d'aller au-delà de ce que permet la suppression et
la recréation d'une fonction d'agrégat. Toutefois, un super-utilisateur
peut modifier la possession de n'importe quelle fonction d'agrégat.
Seul le propriétaire de la fonction d'agrégat peut utiliser <command>ALTER
AGGREGATE</command>. Pour modifier le schéma d'une fonction d'agrégat, il est
nécessaire de posséder le droit <literal>CREATE</literal> sur le nouveau
schéma. Pour modifier le propriétaire de la fonction, il faut être un membre
direct ou indirect du nouveau rôle propriétaire, rôle qui doit en outre
posséder le droit <literal>CREATE</literal> sur le schéma de la fonction
d'agrégat. Ces restrictions assurent que la modification du propriétaire ne
permet pas d'aller au-delà de ce que permet la suppression et la recréation
d'une fonction d'agrégat. Toutefois, un super-utilisateur peut modifier le
propriétaire de n'importe quelle fonction d'agrégat.
</para>
</refsect1>

Expand All @@ -61,7 +60,8 @@ ALTER AGGREGATE <replaceable>nom</replaceable> ( <replaceable>signature_agrégat
<term><replaceable class="parameter">nom</replaceable></term>
<listitem>
<para>
Le nom (éventuellement qualifié du nom du schéma) de la fonction d'agrégat.
Le nom (éventuellement qualifié du nom du schéma) de la fonction
d'agrégat.
</para>
</listitem>
</varlistentry>
Expand All @@ -71,8 +71,9 @@ ALTER AGGREGATE <replaceable>nom</replaceable> ( <replaceable>signature_agrégat

<listitem>
<para>
Le mode d'un argument&nbsp;: <literal>IN</literal> or <literal>VARIADIC</literal>.
La valeur par défaut est <literal>IN</literal>.
Le mode d'un argument&nbsp;: <literal>IN</literal> ou
<literal>VARIADIC</literal>. La valeur par défaut est
<literal>IN</literal>.
</para>
</listitem>
</varlistentry>
Expand All @@ -82,11 +83,10 @@ ALTER AGGREGATE <replaceable>nom</replaceable> ( <replaceable>signature_agrégat

<listitem>
<para>
Le nom d'un argument.
Notez que <command>ALTER AGGREGATE</command> ne fait pas réellement
attention aux noms des arguments car seuls les types de données des
arguments sont nécessaires pour déterminer l'identité de la fonction
d'agrégat.
Le nom d'un argument. Notez que <command>ALTER AGGREGATE</command> ne
fait pas réellement attention aux noms des arguments car seuls les types
de données des arguments sont nécessaires pour déterminer l'identité de la
fonction d'agrégat.
</para>
</listitem>
</varlistentry>
Expand All @@ -95,10 +95,10 @@ ALTER AGGREGATE <replaceable>nom</replaceable> ( <replaceable>signature_agrégat
<term><replaceable class="parameter">type_arg</replaceable></term>
<listitem>
<para>
Un type de données en entrée sur lequel la fonction d'agrégat opère.
Pour référencer une fonction d'agrégat sans argument, écrivez <literal>*</literal>
à la place de la liste des argument specifications.
Pour référencer une fonction d'agrégat avec ensemble trié, ajoutez
Un type de données en entrée sur lequel la fonction d'agrégat opère. Pour
référencer une fonction d'agrégat sans argument, écrivez
<literal>*</literal> à la place de la liste des arguments. Pour
référencer une fonction d'agrégat avec ensemble trié, ajoutez
<literal>ORDER BY</literal> entre les spécifications des arguments direct
et agrégé.
</para>
Expand All @@ -119,9 +119,6 @@ ALTER AGGREGATE <replaceable>nom</replaceable> ( <replaceable>signature_agrégat
<listitem>
<para>
Le nouveau propriétaire de la fonction d'agrégat.
<!-- SAS : Conflit avec ce qui est écrit plus haut
Seul un super-utilisateur peut modifier le propriétaire de l'agrégat.
-->
</para>
</listitem>
</varlistentry>
Expand All @@ -143,14 +140,13 @@ ALTER AGGREGATE <replaceable>nom</replaceable> ( <replaceable>signature_agrégat
<para>
La syntaxe recommandée pour référencer un agrégat dont l'ensemble est trié
revient à écrire <literal>ORDER BY</literal> entre les spécifications de
l'argument direct et de l'argument agrégé, dans le même style que
<link linkend="sql-createaggregate"><command>CREATE AGGREGATE</command></link>.
Néanmoins, cela fonctionnera aussi
d'omettre <literal>ORDER BY</literal> en plaçant uniquement les spécifications
de l'argument direct et de l'argument agrégé. Dans cette forme abréviée, si
<literal>VARIADIC "any"</literal> a été utilisé à la fois dans l'argument
direct et l'argument agrégé, écrire <literal>VARIADIC "any"</literal>
seulement une fois.
l'argument direct et de l'argument agrégé, dans le même style que <link
linkend="sql-createaggregate"><command>CREATE AGGREGATE</command></link>.
Néanmoins, cela fonctionnera aussi d'omettre <literal>ORDER BY</literal> en
plaçant uniquement les spécifications de l'argument direct et de l'argument
agrégé. Dans cette forme abréviée, si <literal>VARIADIC "any"</literal> a été
utilisé à la fois dans l'argument direct et l'argument agrégé, écrire
<literal>VARIADIC "any"</literal> seulement une fois.
</para>
</refsect1>

Expand All @@ -165,16 +161,15 @@ ALTER AGGREGATE <replaceable>nom</replaceable> ( <replaceable>signature_agrégat
</para>

<para>
Changer le propriétaire de la fonction d'agrégat
<literal>mamoyenne</literal> de type
<type>integer</type> en <literal>joe</literal>&nbsp;:
Changer le propriétaire de la fonction d'agrégat <literal>mamoyenne</literal>
de type <type>integer</type> en <literal>joe</literal>&nbsp;:
<programlisting>ALTER AGGREGATE mamoyenne(integer) OWNER TO joe;
</programlisting>
</para>

<para>
Pour déplacer l'agrégat <literal>mon_pourcentage</literal> dont l'argument direct
est de type <type>float8</type> et l'argument agrégé de type
Pour déplacer l'agrégat <literal>mon_pourcentage</literal> dont l'argument
direct est de type <type>float8</type> et l'argument agrégé de type
<type>integer</type> dans le schéma <literal>mon_schema</literal>&nbsp;:
<programlisting>ALTER AGGREGATE mamoyenne(integer) SET SCHEMA mon_schema;
ALTER AGGREGATE mon_pourcentage(float8 ORDER BY integer) SET SCHEMA mon_schema;
Expand All @@ -190,8 +185,8 @@ ALTER AGGREGATE mon_pourcentage(float8, integer) SET SCHEMA mon_schema;
<title>Compatibilité</title>

<para>
Il n'y a pas de commande <command>ALTER AGGREGATE</command> dans le
standard SQL.
Il n'y a pas de commande <command>ALTER AGGREGATE</command> dans le standard
SQL.
</para>
</refsect1>

Expand Down
64 changes: 32 additions & 32 deletions postgresql/ref/alter_collation.xml
View file
Original file line number Diff line number Diff line change
Expand Up @@ -29,18 +29,18 @@ ALTER COLLATION <replaceable>nom</replaceable> SET SCHEMA <replaceable>nouveau_s
<title>Description</title>

<para>
<command>ALTER COLLATION</command> modifie la définition d'une
collation.
<command>ALTER COLLATION</command> modifie la définition d'une collation.
</para>

<para>
Vous devez être propriétaire de la collation pour utiliser <command>ALTER COLLATION</command>.
Pour en modifier le propriétaire, vous devez également être un membre direct ou indirect du nouveau
rôle propriétaire, et ce rôle doit détenir le privilège <literal>CREATE</literal>
sur le schéma de la collation. (Ces restrictions garantissent que, en modifiant le
propriétaire, vous ne pouvez rien faire qui ne soit impossible en supprimant et en recréant la collation.
De toute manière, un super-utilisateur peut modifier le propriétaire de n'importe
quelle collation.)
Vous devez être propriétaire de la collation pour utiliser <command>ALTER
COLLATION</command>. Pour en modifier le propriétaire, vous devez également
être un membre direct ou indirect du nouveau rôle propriétaire, et ce rôle
doit détenir le droit <literal>CREATE</literal> sur le schéma de la
collation. (Ces restrictions garantissent que, en modifiant le propriétaire,
vous ne pouvez rien faire qui ne soit impossible en supprimant et en recréant
la collation. De toute manière, un super-utilisateur peut modifier le
propriétaire de n'importe quelle collation.)
</para>
</refsect1>

Expand Down Expand Up @@ -88,8 +88,8 @@ ALTER COLLATION <replaceable>nom</replaceable> SET SCHEMA <replaceable>nouveau_s
<term><literal>REFRESH VERSION</literal></term>
<listitem>
<para>
Met à jour la version de la collation.
Voir <xref linkend="sql-altercollation-notes"/> ci-dessous.
Met à jour la version de la collation. Voir <xref
linkend="sql-altercollation-notes"/> ci-dessous.
</para>
</listitem>
</varlistentry>
Expand All @@ -100,10 +100,10 @@ ALTER COLLATION <replaceable>nom</replaceable> SET SCHEMA <replaceable>nouveau_s
<title>Notes</title>

<para>
Quand un objet de collation est créé, la version spécifique du fournisseur de la collation
est enregistré dans le catalogue système. Quand la collation est utilisée,
la version courante est comparée à la version enregistrée, et un
avertissement est émis en cas d'incompatibilité, par exemple&nbsp;:
Quand un objet de collation est créé, la version spécifique du fournisseur de
la collation est enregistrée dans le catalogue système. Quand la collation
est utilisée, la version courante est comparée à la version enregistrée, et
un avertissement est émis en cas d'incompatibilité, par exemple&nbsp;:
<screen>
WARNING: collation "xx-x-icu" has version mismatch
DETAIL: The collation in the database was created using version 1.2.3.4, but the operating system provides version 2.3.4.5.
Expand All @@ -112,8 +112,8 @@ HINT: Rebuild all objects affected by this collation and run ALTER COLLATION pg
Un changement dans des définitions de collations peut entraîner des
corruptions d'index et d'autres problèmes, car le moteur de la base de
données s'appuie sur le fait que les objets stockées ont un certain ordre. En
général, cela devrait être évité, mais peut arriver dans certaines
circonstances légitimes, telles que la mise à jour d'un système
général, cela devrait être évité, mais cela peut néanmoins arriver dans
certaines circonstances légitimes, telles que la mise à jour d'un système
d'exploitation vers une nouvelle version majeure ou comme l'utilisation de
<command>pg_upgrade</command> pour mettre à jour vers des binaires du serveur
liés à une version plus récente d'ICU. Dans ces circonstances, tous les
Expand All @@ -136,19 +136,19 @@ HINT: Rebuild all objects affected by this collation and run ALTER COLLATION pg

<note>
<para>
Si les collations utilisent la bibliothèque C GNU, la version de
la bibliothèque C est utilisée comme proxy pour la version de la collation.
Beaucoup de distributions Linux ne changent les définitions de collation
que lors des mises à jour de la bibliothèque C. Cette approche
pose problème, car les mainteneurs sont libres de rétroporter des définitions
de collation récentes vers des versions anciennes de la bibliothèque C.
Si les collations utilisent la bibliothèque C GNU, la version de la
bibliothèque C est utilisée comme proxy pour la version de la collation.
Beaucoup de distributions Linux ne changent les définitions de collation que
lors des mises à jour de la bibliothèque C. Cette approche pose problème,
car les mainteneurs sont libres de rétroporter des définitions de collation
récentes vers des versions anciennes de la bibliothèque C.
</para>

<para>
Si les collations utilisent celles de Windows, l'information de version
n'est disponible que pour celles définies avec des étiquettes d'identification de langue
<!-- = lanquage tag,
cf https://fr.wikipedia.org/wiki/%C3%89tiquette_d%27identification_de_langues_IETF -->
BCP&nbsp;47, par exemple <literal>en-US</literal>.
n'est disponible que pour celles définies avec des étiquettes
d'identification de langue BCP&nbsp;47, par exemple
<literal>en-US</literal>.
</para>
</note>

Expand Down Expand Up @@ -177,15 +177,15 @@ SELECT pg_describe_object(refclassid, refobjid, refobjsubid) AS "Collation",

<para>
Pour renommer la collation <literal>de_DE</literal> en
<literal>german</literal>:
<literal>german</literal>&nbsp;:
<programlisting>
ALTER COLLATION "de_DE" RENAME TO german;
</programlisting>
</para>

<para>
Pour donner la propriété de la collation <literal>en_US</literal> à
<literal>joe</literal>:
Pour changer le propriétaire la propriété de la collation
<literal>en_US</literal> par <literal>joe</literal>&nbsp;:
<programlisting>
ALTER COLLATION "en_US" OWNER TO joe;
</programlisting>
Expand All @@ -196,8 +196,8 @@ ALTER COLLATION "en_US" OWNER TO joe;
<title>Compatibilité</title>

<para>
Il n'y a pas de commande <command>ALTER COLLATION</command> dans
le standard SQL.
Il n'y a pas de commande <command>ALTER COLLATION</command> dans le standard
SQL.
</para>
</refsect1>

Expand Down
25 changes: 11 additions & 14 deletions postgresql/ref/alter_conversion.xml
View file
Original file line number Diff line number Diff line change
Expand Up @@ -26,20 +26,18 @@ ALTER CONVERSION <replaceable>nom</replaceable> SET SCHEMA <replaceable>nouveau_
<title>Description</title>

<para>
<command>ALTER CONVERSION</command> modifie la définition d'une
conversion.
<command>ALTER CONVERSION</command> modifie la définition d'une conversion.
</para>

<para>
Seul le propriétaire de la conversion peut utiliser
<command>ALTER CONVERSION</command>. Pour changer le propriétaire,
il faut aussi être un
membre direct ou indirect du nouveau rôle propriétaire et ce rôle doit
avoir le droit <literal>CREATE</literal> sur le schéma de la conversion.
Ces restrictions assurent que le changement de propriétaire ne va pas
au-delà de ce qui peut être obtenu en supprimant et en re-créant
la conversion. Toutefois, un super-utilisateur peut changer
le propriétaire de n'importe quelle conversion.
Seul le propriétaire de la conversion peut utiliser <command>ALTER
CONVERSION</command>. Pour changer le propriétaire, il faut aussi être un
membre direct ou indirect du nouveau rôle propriétaire et ce rôle doit avoir
le droit <literal>CREATE</literal> sur le schéma de la conversion. Ces
restrictions assurent que le changement de propriétaire ne va pas au-delà de
ce qui peut être obtenu en supprimant et en re-créant la conversion.
Toutefois, un super-utilisateur peut changer le propriétaire de n'importe
quelle conversion.
</para>
</refsect1>

Expand Down Expand Up @@ -90,15 +88,14 @@ ALTER CONVERSION <replaceable>nom</replaceable> SET SCHEMA <replaceable>nouveau_

<para>
Renommer la conversion <literal>iso_8859_1_to_utf8</literal> en
<literal>latin1_to_unicode</literal> :
<literal>latin1_to_unicode</literal>&nbsp;:
<programlisting>ALTER CONVERSION iso_8859_1_to_utf8 RENAME TO latin1_to_unicode;
</programlisting>
</para>

<para>
Changer le propriétaire de la conversion
<literal>iso_8859_1_to_utf8</literal> en
<literal>joe</literal> :
<literal>iso_8859_1_to_utf8</literal> en <literal>joe</literal>&nbsp;:
<programlisting>ALTER CONVERSION iso_8859_1_to_utf8 OWNER TO joe;
</programlisting>
</para>
Expand Down

0 comments on commit 3344d93

Please sign in to comment.