[Trad] [svn:pgfr] r1116 - traduc/trunk/postgresql
admin at listes.postgresql.fr
admin at listes.postgresql.fr
Jeu 7 Aou 14:40:34 CEST 2008
Author: sas
Date: 2008-08-07 14:40:34 +0200 (Thu, 07 Aug 2008)
New Revision: 1116
Modified:
traduc/trunk/postgresql/func.xml
Log:
Relu !
close #180
Modified: traduc/trunk/postgresql/func.xml
===================================================================
--- traduc/trunk/postgresql/func.xml 2008-08-05 15:26:24 UTC (rev 1115)
+++ traduc/trunk/postgresql/func.xml 2008-08-07 12:40:34 UTC (rev 1116)
@@ -8927,7 +8927,6 @@
</sect1>
-<!-- SAS::ICI -->
<sect1 id="functions-sequence">
<title>Fonctions de manipulation de séquences</title>
@@ -8957,8 +8956,8 @@
utilisée pour engendrer des identifiants uniques de lignes d'une table.
Les fonctions de séquence, listées dans le <xref
linkend="functions-sequence-table"/>, fournissent des méthodes simples, et
- sûres en environnement multi-utilisateurs, d'obtention de valeurs successive de séquence
- à partir d'objets séquence.
+ sûres en environnement multi-utilisateurs, d'obtention de valeurs
+ successives à partir d'objets séquence.
</para>
<table id="functions-sequence-table">
@@ -9010,12 +9009,12 @@
</table>
<para>
- La séquence à traiter lors de l'appel à une fonction de traitement de séquences est
+ La séquence à traiter par l'appel d'une fonction de traitement de séquences est
identifiée par un argument <type>regclass</type>, qui n'est autre que l'OID de la
séquence dans le catalogue système <structname>pg_class</structname>. Il
n'est toutefois pas nécessaire de se préoccuper de la recherche de cet OID car
le convertisseur de saisie du type de données <type>regclass</type> s'en
- charge. Il suffit d'écrire le nom de la séquence entre guillemets simples de
+ charge. Il suffit d'écrire le nom de la séquence entre guillemets simples, de
façon à le faire ressembler à un libellé. Pour obtenir une
compatibilité avec la gestion des noms <acronym>SQL</acronym> ordinaires,
la chaîne est convertie en minuscules, sauf si le nom de la séquence est
@@ -9035,15 +9034,15 @@
<note>
<para>
Avant la version 8.1 de <productname>PostgreSQL</productname>, les arguments des
- fonctions de triatement de séquence étaient du type <type>text</type>, et non <type>regclass</type>.
+ fonctions de traitement de séquences étaient du type <type>text</type>, et non <type>regclass</type>.
De ce fait, les conversions précédemment décrites d'une chaîne de caractères
en valeur OID se produisaient à chaque appel. Pour des raisons de compatibilité,
- cette fonctionnalité existe toujours. En revanche, en interne, un transtypage implicite
+ cette fonctionnalité existe toujours. Mais, en interne, un transtypage implicite
est effectué entre <type>text</type> et <type>regclass</type> avant l'appel de la fonction.
</para>
<para>
- Lorsque l'argument d'une fonction de traitement de séquence est écrit comme une simple chaîne
+ Lorsque l'argument d'une fonction de traitement de séquences est écrit comme une simple chaîne
de caractères, il devient une constante de type <type>regclass</type>.
Puisqu'il ne s'agit que d'un OID, il permet de suivre
la séquence originelle même en cas de renommage, changement de schéma...
@@ -9054,15 +9053,15 @@
stockage des constantes sous la forme de constantes <type>text</type> plutôt
que <type>regclass</type> :
<programlisting>nextval('foo'::text) <lineannotation><literal>foo</literal> est recherché à l'exécution</lineannotation></programlisting>
- Le lien faible est le seul comportement accesiible dans les versions de <productname>PostgreSQL</productname>
+ Le lien faible est le seul comportement accessible dans les versions de <productname>PostgreSQL</productname>
antérieures à 8.1. Il peut donc être nécessaire de le conserver pour maintenir la sémantique d'anciennes
applications.
</para>
<para>
- L'argument d'une fonction de traitement de séquence peut être une expression ou une constante.
- S'il s'agit d'une expression textuelle, le transtypage implicite implique
- une recherche lors à l'exécution.
+ L'argument d'une fonction de traitement de séquences peut être une expression ou une constante.
+ S'il s'agit d'une expression textuelle, le transtypage implicite impose
+ une recherche à l'exécution.
<!-- run-time lookup -->
</para>
</note>
@@ -9122,7 +9121,7 @@
deux paramètres initialise le champ <literal>last_value</literal> de la
séquence à la valeur précisée et initialise le champ
<literal>is_called</literal> à <literal>true</literal>, signifiant que
- le prochain <function>nextval</function> avancera la séquence avant de
+ le prochain <function>nextval</function> avance la séquence avant de
renvoyer une valeur. La valeur renvoyée par <function>currval</function>
est aussi configuré à la valeur indiquée. Dans la forme à trois paramètres,
<literal>is_called</literal> peut être initialisé à
@@ -9132,12 +9131,12 @@
<function>nextval</function> retourne exactement la valeur indiquée
et l'incrémentation de la séquence commence avec le
<function>nextval</function> suivant. De plus, la valeur indiquée par
- <function>currval</function> n'est pas modifiée dans ce cas (ceci est
- une modification du comportement des versions antérieures à la 8.3).
+ <function>currval</function> n'est pas modifiée dans ce cas. (Il s'agit
+ d'une modification du comportement des versions antérieures à la 8.3.)
Par exemple,
<screen>SELECT setval('foo', 42); <lineannotation>Le <function>nextval</function> suivant retourne 43</lineannotation>
-SELECT setval('foo', 42, true); <lineannotation>Identique à ci-dessus</lineannotation>
+SELECT setval('foo', 42, true); <lineannotation>Comme ci-dessus</lineannotation>
SELECT setval('foo', 42, false); <lineannotation>Le <function>nextval</function> suivant retourne 42</lineannotation></screen>
Le résultat renvoyé par <function>setval</function> est la valeur
@@ -9151,7 +9150,7 @@
<para>
Si un objet séquence a été créé avec les paramètres par défaut, les
appels à <function>nextval</function> sur celui-ci renvoient des valeurs
- successives débutant à 1. D'autres comportements peuvent être obtenus en
+ successives à partir de 1. D'autres comportements peuvent être obtenus en
utilisant des paramètres spéciaux de la commande <xref
linkend="sql-createsequence" endterm="sql-createsequence-title"/> ; voir
la page de référence de la commande pour plus d'informations.
@@ -9162,9 +9161,9 @@
Pour éviter le blocage de transactions concurrentes qui obtiennent des
nombres de la même séquence, une opération <function>nextval</function>
n'est jamais annulée ; c'est-à-dire qu'une fois la valeur
- récupérée, elle est considérée utilisée, même si la transaction qui exécuta
- le <function>nextval</function> avorte par la suite. Ceci signifie que les transactions
- annulées pourraient laisser des <quote>trous</quote> inutilisés dans la
+ récupérée, elle est considérée utilisée, même si la transaction qui exécute
+ <function>nextval</function> avorte par la suite. Cela signifie que les transactions
+ annulées peuvent laisser des <quote>trous</quote> inutilisés dans la
séquence des valeurs assignées. Les opérations <function>setval</function>
ne sont jamais annulées non plus.
</para>
@@ -9267,11 +9266,11 @@
END</synopsis>
L'<replaceable>expression</replaceable> est calculée et comparée à toutes
- les spécifications de <replaceable>valeur</replaceable> des clauses
+ les indications de <replaceable>valeur</replaceable> des clauses
<token>WHEN</token> jusqu'à en trouver une égale. Si aucune ne correspond, le
<replaceable>résultat</replaceable> de la clause
- <token>ELSE</token> (ou une valeur NULL) est renvoyée. Ceci est similaire
- à l'instruction <function>switch</function> en C.
+ <token>ELSE</token> (ou une valeur NULL) est renvoyé(e). C'est similaire
+ à l'instruction <function>switch</function> du langage C.
</para>
<para>
@@ -9317,7 +9316,7 @@
<synopsis><function>COALESCE</function>(<replaceable>valeur</replaceable> <optional>, ...</optional>)</synopsis>
<para>
- La fonction <function>COALESCE</function> renvoie le premier de ces
+ La fonction <function>COALESCE</function> renvoie le premier de ses
arguments qui n'est pas nul. Une valeur NULL n'est renvoyée que si tous
les arguments sont nuls. Cette fonction est souvent utile pour substituer une
valeur par défaut aux valeurs NULL lorsque la donnée est récupérée pour
@@ -9339,7 +9338,7 @@
<title><literal>NULLIF</literal></title>
<indexterm>
- <primary>NULLif</primary>
+ <primary>NULLIF</primary>
</indexterm>
<synopsis><function>NULLIF</function>(<replaceable>valeur1</replaceable>, <replaceable>valeur2</replaceable>)</synopsis>
@@ -9514,13 +9513,15 @@
</tgroup>
</table>
-<!-- row-major doit-il être conservé, sans traduction ? -->
+<!-- SAS 20080806 : row-major doit-il être conservé, sans traduction ?
+ Non. Traduit pas premier index, ou lignes, un tableau à deux dimensions
+ est une matrice [ligne][colonne] -->
<para>
- Les comparaisons comparent les contenus des tableaux élément par
+ Les comparaisons de tableaux comparent les contenus des tableaux élément par
élément, en utilisant la fonction de comparaison par défaut du B-Tree pour
le type de données de l'élément. Dans les tableaux multi-dimensionnels,
- les éléments sont visités dans l'ordre <quote>row-major</quote>
- (le dernier indice varie le plus rapidement).
+ les éléments sont visités dans l'ordre des colonnes (<quote>row-major
+ order</quote>, le dernier indice varie le plus rapidement).
Si le contenu de deux tableaux est identique mais que les dimensions sont
différentes, la première différence dans l'information de dimension
détermine l'ordre de tri. (Ce fonctionnement diffère de celui des versions de
@@ -9678,7 +9679,7 @@
<!-- Fonctions d'agrégat tout-terrain -->
<!-- Fonctions d'agrégat multi-usage -->
<table id="functions-aggregate-table">
- <title>Fonctions d'agrégat à but général</title>
+ <title>Fonctions d'agrégat générales</title>
<tgroup cols="4">
<thead>
@@ -10103,7 +10104,7 @@
sum(<replaceable class="parameter">X</replaceable>) *
sum(<replaceable class="parameter">Y</replaceable>) /
<replaceable class="parameter">N</replaceable></literal>
- (<quote>somme des produits</quote> des indépeendantes
+ (<quote>somme des produits</quote> de la variable indépendante
multipliée par la variable dépendante)</entry>
</row>
@@ -10305,7 +10306,7 @@
<para>
La sous-requête peut faire référence à des variables de la requête
- englobante qui agiront comme des constantes à chaque évaluation de la
+ englobante qui agissent comme des constantes à chaque évaluation de la
sous-requête.
</para>
@@ -10315,8 +10316,8 @@
renvoyée. Elle n'est donc pas forcément exécutée dans son intégralité. Il
est de ce fait fortement déconseillé d'écrire
une sous-requête qui présente des effets de bord (tels que l'appel de fonctions de
- séquence) ; il est extrèmement difficile de prédire si celui-ci va
- intervenir.
+ séquence) ; il est extrèmement difficile de prédire si ceux-ci se
+ produisent.
</para>
<para>
@@ -10401,7 +10402,7 @@
<para>
Le côté droit est une sous-requête entre parenthèses, qui doit
retourner exactement une colonne. L'expression de gauche est évalué et
- comparée à cauqe ligne de résultat de la sous-requête.
+ comparée à chaque ligne de résultat de la sous-requête.
Le résultat de <token>NOT IN</token> n'est <quote>true</quote> que si des
lignes différentes de la sous-requête sont trouvées (ce qui inclut le cas
spécial de la sous-requête ne retournant pas de ligne).
@@ -10427,7 +10428,7 @@
Le côté gauche de cette forme de <token>NOT IN</token> est un constructeur
de lignes, comme décrit dans la <xref linkend="sql-syntax-row-constructors"/>.
Le côté droit est une sous-requête entre parenthèses qui doit renvoyer
- exactement autant colonnes qu'il y a d'expressions dans la ligne de gauche.
+ exactement autant de colonnes qu'il y a d'expressions dans la ligne de gauche.
Les expressions de gauche sont évaluées et comparée ligne à ligne au
résultat de la sous-requête. Le résultat de <token>NOT IN</token>
n'est vrai (<quote>true</quote>) que si seules des lignes différentes de la sous-requête
@@ -10439,8 +10440,8 @@
<para>
Comme d'habitude, les valeurs nulles des lignes sont combinées en accord
avec les règles normales des expressions bouléennes SQL. Deux lignes sont
- considérées égales si tous leurs membres correspondant sont non-nuls et
- égaux ; les lignes sont différentes si les membres correspondant sont
+ considérées égales si tous leurs membres correspondants sont non-nuls et
+ égaux ; les lignes sont différentes si les membres correspondants sont
non-nuls et différents ; dans tous les autres cas, le résultat de cette
comparaison de ligne est inconnu (nul). Si tous les résultats par ligne sont
différents ou nuls, avec au minimum un nul, alors le résultat du <token>NOT
@@ -10458,7 +10459,7 @@
Le côté droit est une sous-requête entre parenthèses qui ne doit retourner
qu'une seule colonne. L'expression du côté gauche est évaluée et comparée à
chaque ligne du résultat de la sous-requête à l'aide de
- l'<replaceable>opérateur</replaceable> indiqué, ce qui doit aboutir à une
+ l'<replaceable>opérateur</replaceable> indiqué, ce qui doit aboutir à un
résultat booléen. Le résultat de <token>ANY</token> est vrai
(<quote>true</quote>) si l'un des résultats est vrai. Le résultat est faux
(<quote>false</quote>) si aucun
@@ -10499,8 +10500,7 @@
Le résultat est <quote>false</quote> si la comparaison renvoie false pour
chaque ligne de la sous-requête (ce qui inclut le cas spécial de la sous-requête
ne retournant aucune ligne). Le résultat est NULL si la comparaison ne renvoie
- true pour aucune ligne, et renvoie NULL pour au moins une
- ligne.
+ true pour aucune ligne, et renvoie NULL pour au moins une ligne.
</para>
<para>
@@ -10523,8 +10523,8 @@
Le résultat de <token>ALL</token> est vrai (<quote>true</quote>) si toutes les
lignes renvoient true (ce qui inclut le cas spécial de la sous-requête ne
retournant aucune ligne). Le résultat est faux (<quote>false</quote>) si un résultat
- faux est découvert. Le résultat est NULL si la comparaison ne renvoie pas
- false pour toutes les lignes, et si elle renvoie NULL pour au moins une ligne.
+ faux est découvert. Le résultat est NULL si la comparaison ne renvoie
+ false pour aucune ligne, mais NULL pour au moins une ligne.
</para>
<para>
@@ -10543,7 +10543,7 @@
lignes, tel que décrit dans la <xref linkend="sql-syntax-row-constructors"/>.
Le côté droit est une sous-requête entre
parenthèses qui doit renvoyer exactement le même nombre de colonnes qu'il y a
- d'expressions dans la ligne de gauche. Les expressions du côté gauche sont
+ d'expressions dans la colonne de gauche. Les expressions du côté gauche sont
évaluées et comparées ligne à ligne au résultat de la
sous-requête à l'aide de l'<replaceable>opérateur</replaceable> donné.
Le résultat de <token>ALL</token> est <quote>true</quote> si la comparaison
@@ -10552,7 +10552,7 @@
Le résultat est <quote>false</quote> si la comparaison renvoie false pour
une ligne quelconque de la sous-requête.
Le résultat est NULL si la comparaison ne renvoie false pour aucune ligne
- de la sous-requête, et si elle renvoie NULL pour au moins une ligne.
+ de la sous-requête, mais NULL pour au moins une ligne.
</para>
<para>
@@ -10659,7 +10659,7 @@
<para>
Si l'expression du côté gauche renvoie NULL, ou s'il n'y a pas
- de valeurs du côté droit égales et qu'au moins une expression du côté
+ de valeur égale du côté droit et qu'au moins une expression du côté
droit renvoie NULL, le résultat de la construction
<token>IN</token> est NULL et non pas faux. Ceci est en accord avec les
règles du standard SQL pour les combinaisons booléennes de valeurs NULL.
@@ -10767,8 +10767,6 @@
<sect2 id="row-wise-comparison">
<title>Comparaison de lignes entières</title>
-<!-- Etrangement, à ce niveau-là, le fichier de traduction contient déjà 300
-lignes de plus que la VO... -->
<synopsis><replaceable>constructeur_ligne</replaceable> opérateur <replaceable>constructeur_ligne</replaceable></synopsis>
<para>
@@ -10860,12 +10858,10 @@
<primary>generate_series</primary>
</indexterm>
-<!-- Joli contresens :-)
- et générer N'est PAS français -->
<para>
Cette section décrit des fonctions qui peuvent renvoyer plus d'une
ligne. Actuellement, les seules fonctions dans cette classe sont les
- les fonctions de génération de séries, détaillées dans le <xref
+ fonctions de génération de séries, détaillées dans le <xref
linkend="functions-srf-series"/>.
</para>
@@ -11428,13 +11424,13 @@
</para>
<para>
- <function>has_table_privilege</function> vérifie si l'utilisateur possède
+ <function>has_table_privilege</function> vérifie si l'utilisateur possède
un privilège particulier d'accès à une table. L'utilisateur peut être
indiqué par son nom ou son OID (<literal>pg_authid.oid</literal>). Si
l'argument est omis, <function>current_user</function> est utilisé. La table
peut être indiquée par son nom ou par son OID. (Il existe donc six
versions de <function>has_table_privilege</function> qui se distinguent
- par le nombre et le types de leurs arguments.) Lors de l'indication par
+ par le nombre et le type de leurs arguments.) Lors de l'indication par
nom, il est possible de préciser le schéma. Les privilèges possibles,
indiqués sous la forme d'une chaîne de caractères, sont :
<literal>SELECT</literal>, <literal>INSERT</literal>,
@@ -11476,7 +11472,7 @@
permettent de savoir si un objet particulier est <firstterm>visible</firstterm> dans le chemin
de recherche courant. Une table est dite visible si son schéma
contenant est dans le chemin de recherche et qu'aucune table de même
- nom n'apparaît avant dans le chemin de recherche. C'est équivalent
+ nom ne la précède dans le chemin de recherche. C'est équivalent
au fait que la table peut être référencée par son nom sans qualification
explicite de schéma. Par exemple, pour lister les noms de toutes les
tables visibles :
@@ -11606,7 +11602,7 @@
objet de même nom <emphasis>et prenant des arguments de mêmes types
de données</emphasis> n'est précédemment présent dans le chemin de recherche. Pour les
classes d'opérateurs, on considère à la fois le nom et la méthode
- d'accès à l'index associée.
+ d'accès à l'index associé.
</para>
<para>
@@ -11695,14 +11691,14 @@
<row>
<entry><literal><function>pg_get_expr</function>(<parameter>expr_text</parameter>, <parameter>relation_oid</parameter>)</literal></entry>
<entry><type>text</type></entry>
- <entry>décompile la forme interne d'une expression, en supposant que tous
- les Vars font référence à la relation indiquée par le second paramètre</entry>
+ <entry>décompile la forme interne d'une expression, en supposant que
+ toutes les variables qu'elle contient font référence à la relation indiquée par le second paramètre</entry>
</row>
<row>
<entry><literal><function>pg_get_expr</function>(<parameter>expr_text</parameter>, <parameter>relation_oid</parameter>, <parameter>pretty_bool</parameter>)</literal></entry>
<entry><type>text</type></entry>
- <entry>décompile la forme interne d'une expression, en supposant que tous
- les Vars font référence à la relation indiquée par le second paramètre</entry>
+ <entry>décompile la forme interne d'une expression, en supposant que
+ toutes les variables qu'elle contient font référence à la relation indiquée par le second paramètre</entry>
</row>
<row>
<entry><literal><function>pg_get_indexdef</function>(<parameter>index_oid</parameter>)</literal></entry>
@@ -11797,9 +11793,9 @@
<function>pg_get_viewdef</function> reconstruit la requête <command>SELECT</command>
qui définit une vue. La plupart de ces fonctions existent en deux versions,
l'une d'elles permettant, optionnellement, d'<quote>afficher joliment</quote>
- le résultat. Ce format est plus lisible, mais il est plus probable que les
- futures versions de <productname>PostgreSQL</productname> sachent toujours
- interprêter le format par défaut de la même façon ; la version
+ le résultat. Ce format est plus lisible, mais il est probable que les
+ futures versions de <productname>PostgreSQL</productname> continuent
+ d'interprêter le format par défaut actuel de la même façon ; la version
<quote>jolie</quote> doit être évitée dans les sauvegardes. Passer
<literal>false</literal> pour le paramètre de <quote>jolie</quote> sortie
conduit au même résultat que la variante sans ce paramètre.
@@ -12146,7 +12142,7 @@
<parameter>nom_paramètre</parameter> à
<parameter>nouvelle_valeur</parameter>. Si
<parameter>est_local</parameter> vaut <literal>true</literal>, la
- nouvelle valeur s'applique uniquement la transaction en cours. Si
+ nouvelle valeur s'applique uniquement à la transaction en cours. Si
la nouvelle valeur doit s'appliquer à la session en cours,
on utilise <literal>false</literal>. La fonction correspond à
la commande SQL <command>SET</command>. Par exemple :
@@ -12382,13 +12378,6 @@
terminer la sauvegarde.
</para>
-<!-- SAS 20071218 : Partie qui n'apparaît plus dans la doc PG83b4
- <para>
- Pour des détails sur le bon usage de ces fonctions, voir la
- <xref linkend="continuous-archiving"/>.
- </para>
--->
-
<para>
<function>pg_switch_xlog</function> bascule sur le prochain journal de
transactions, ce qui permet d'archiver le journal courant (en supposant que
@@ -12825,7 +12814,7 @@
<function>pg_try_advisory_lock</function> est similaire à
<function>pg_advisory_lock</function> sauf que la fonction n'attend pas
la disponibilité du verrou. Si le verrou peut être obtenu immédiatement,
- et la fonction renvoie <literal>true</literal>, sinon, elle renvoie
+ la fonction renvoie <literal>true</literal>, sinon, elle renvoie
<literal>false</literal>.
</para>
More information about the Trad
mailing list