[Trad] [svn:pgfr] r1088 - traduc/trunk/postgresql
svncommit at kryskool.org
svncommit at kryskool.org
Ven 4 Juil 10:09:44 CEST 2008
Auteur: sas
Date: 2008-07-04 10:09:40 +0200 (ven, 04 jui 2008)
Nouvelle Révision: 1088
Modification:
traduc/trunk/postgresql/dblink.xml
traduc/trunk/postgresql/dict-int.xml
traduc/trunk/postgresql/dict-xsyn.xml
traduc/trunk/postgresql/diskusage.xml
traduc/trunk/postgresql/dml.xml
Log:
Back in Business
Modified: traduc/trunk/postgresql/dblink.xml
===================================================================
--- traduc/trunk/postgresql/dblink.xml 2008-07-03 09:08:14 UTC (rev 1087)
+++ traduc/trunk/postgresql/dblink.xml 2008-07-04 08:09:40 UTC (rev 1088)
@@ -260,14 +260,13 @@
SQL qui renvoie des lignes est valable) sur une base de données distante.
</para>
-<!-- ICI -->
<para>
- Si deux arguments <type>text</type> sont présents, le premier est utilisé
- comme nom d'une connexion persistante. Si cette connexion est trouvée,
- la commande est exécutée sur cette connexion. Si elle n'est pas trouvée,
- le premier argument est pris pour une chaîne de connexion comme
- <function>dblink_connect</function>, et la connexion indiquée est
- conservée uniquement pendant la durée d'exécution de cette commande.
+ Si deux arguments <type>text</type> sont présents, le premier est d'abord
+ considéré comme nom de connexion persistante ; si cette connexion
+ est trouvée, la commande est exécutée sur cette connexion. Dans le cas
+ contraire, le premier argument est considéré être une chaîne de connexion
+ comme dans le cas de <function>dblink_connect</function>, et la connexion
+ indiquée n'est conservée que pour la durée d'exécution de cette commande.
</para>
</refsect1>
@@ -279,8 +278,8 @@
<term><parameter>conname</parameter></term>
<listitem>
<para>
- Le nom à utiliser pour cette connexion ; omettez ce paramètre
- pour utiliser la connexion sans nom.
+ Le nom de la connexion à utiliser ; ce paramètre doit être omis
+ pour utiliser une connexion sans nom.
</para>
</listitem>
</varlistentry>
@@ -289,7 +288,7 @@
<term><parameter>connstr</parameter></term>
<listitem>
<para>
- Une chaîne de connexion décrite précédemment pour
+ Une chaîne de connexion similaire à celle décrite précédemment pour
<function>dblink_connect</function>.
</para>
</listitem>
@@ -309,10 +308,10 @@
<term><parameter>fail_on_error</parameter></term>
<listitem>
<para>
- Si true (la valeur par défaut si elle n'est pas précisée), un message
- de type ERROR sur la base distante cause l'envoi d'un message de type
- ERROR en local. Dans le cas contraire, le message distant de type ERROR
- est traité localement comme un NOTICE, et aucune ligne n'est renvoyée.
+ Si true (valeur par défaut en cas d'omission), une erreur distante
+ est reportée localement comme une erreur. Dans le cas contraire, un
+ message d'erreur distant est traité localement comme un message de type
+ NOTICE, et la fonction ne retourne aucune ligne.
</para>
</listitem>
</varlistentry>
@@ -325,12 +324,11 @@
<para>
La fonction renvoie les lignes produites par la requête. Comme
<function>dblink</function> peut être utilisée avec toute requête, elle
- est déclarée comme renvoyant le type <type>record</type>, et ne spécifie
- donc aucun ensemble particulier de colonnes. Ceci signifie que
- l'ensemble des colonnes attendues doit être spécifié dans la
- requête appelante — sinon
- <productname>PostgreSQL</productname> ne sait pas
- à quoi s'attendre. Voici un exemple :
+ est déclarée comme renvoyant le type <type>record</type>, plutôt que de
+ préciser un ensemble particulier de colonnes. Cela signifie que
+ l'ensemble des colonnes attendues doit être précisé dans la
+ requête appelante — sinon <productname>PostgreSQL</productname>
+ ne sait pas quoi attendre. Voici un exemple :
<programlisting>
SELECT *
@@ -340,19 +338,19 @@
</programlisting>
La partie <quote>alias</quote> de la clause <literal>FROM</literal> doit
- spécifier les noms et types des colonnes que la fonction va renvoyer.
- (Spécifier les noms des colonnes dans un alias est en fait une syntaxe
- du standard SQL mais spécifier les types des colonnes est une extension
- <productname>PostgreSQL</productname>.) Ceci permet au système de
+ spécifier les noms et types des colonnes retournés par la fonction.
+ (La précision des noms des colonnes dans un alias est une syntaxe
+ du standard SQL mais la précision des types des colonnes est une extension
+ <productname>PostgreSQL</productname>.) Cela permet au système de
savoir comment étendre <literal>*</literal>, et à quoi correspond
<structname>proname</structname> dans la clause
<literal>WHERE</literal>
avant de tenter l'exécution de la fonction. À l'exécution, une erreur
- sera renvoyée si le résultat réel de la requête à partir de la base de
- données distante n'a pas le même nombre de colonnes que celui indiqué
+ est renvoyée si le nombre de colonnes du résultat effectif de la requête
+ sur la base de données distante diffère de celui indiqué
dans la clause <literal>FROM</literal>. Les noms de colonnes n'ont pas
- besoin de correspondre et <function>dblink</function> n'insiste pas
- sur une correspondance exacte des types. L'opération sera une réussite
+ besoin de correspondre et <function>dblink</function> n'impose pas
+ une correspondance exacte des types. L'opération réussit
si les chaînes de données renvoyées sont valides pour le type déclaré
dans la clause <literal>FROM</literal>.
</para>
@@ -362,18 +360,18 @@
<title>Notes</title>
<para>
- <function>dblink</function> récupère les résultats complets de la
- requête avant des les renvoyer au système local. Si la requête doit
+ <function>dblink</function> récupère l'intégralité des résultats de la
+ requête avant de les renvoyer au système local. Si la requête doit
renvoyer un grand nombre de lignes, il est préférable d'ouvrir un
curseur avec <function>dblink_open</function> puis de récupérer un
nombre gérable de lignes.
</para>
<para>
- Une façon agréable d'utiliser <function>dblink</function> avec des
- requêtes prédéterminées est de créer une vue. Ceci permet de stocker
- l'information sur les colonnes dans la vue, au lieu d'avoir à la saisir
- pour chaque requête. Par exemple :
+ Il est souvent plus pratique de créer une vue pour utiliser
+ <function>dblink</function> avec des requêtes prédéterminées.
+ Cela permet de laisser la vue gérer le type de la colonne plutôt que
+ d'avoir à le saisir pour chaque requête. Par exemple :
<programlisting>
CREATE VIEW myremote_pg_proc AS
@@ -487,11 +485,11 @@
<para>
Quand deux arguments de type <type>text</type> sont fournis, le premier
- est recherché comme nom d'une connexion persistante ; si cette
+ est d'abord considéré comme nom d'une connexion persistante ; si cette
connexion est trouvée, la commande est exécutée sur cette connexion. Dans
le cas contraire, le premier argument est traitée comme une chaîne de
connexion pour <function>dblink_connect</function>, et la connexion
- indiquée est maintenue uniquement pour la durée d'exécution de cette
+ indiquée n'est maintenue que pour la durée d'exécution de cette
commande.
</para>
</refsect1>
@@ -504,8 +502,8 @@
<term><parameter>conname</parameter></term>
<listitem>
<para>
- Nom de la connexion à utiliser ; omettez ce paramètre pour
- utiliser la connexion sans nom.
+ Le nom de la connexion à utiliser ; ce paramètre doit être omis
+ pour utiliser une connexion sans nom.
</para>
</listitem>
</varlistentry>
@@ -514,8 +512,8 @@
<term><parameter>connstr</parameter></term>
<listitem>
<para>
- Une chaîne de connexion identique à celle décrite pour
- <function>dblink_connect</function>.
+ Une chaîne de connexion similaire à celle décrite précédemment pour
+ <function>dblink_connect</function>.
</para>
</listitem>
</varlistentry>
@@ -524,7 +522,7 @@
<term><parameter>sql</parameter></term>
<listitem>
<para>
- La commande SQL à exécuter dans la base de données
+ La commande SQL à exécuter sur la base de données
distante ; par exemple
<literal>INSERT INTO foo VALUES(0,'a','{"a0","b0","c0"}')</literal>.
</para>
@@ -535,10 +533,10 @@
<term><parameter>fail_on_error</parameter></term>
<listitem>
<para>
- Si true (la valeur par défaut si elle n'est pas précisée), un message
- de type ERROR sur la base distante cause l'envoi d'un message de type
- ERROR en local. Dans le cas contraire, le message distant de type ERROR
- est traité localement comme un NOTICE, et la valeur renvoyée est
+ Si true (valeur par défaut en cas d'omission), une erreur distante
+ est reportée localement comme une erreur locale. Dans le cas contraire, un
+ message d'erreur distant est traité localement comme un message de type
+ NOTICE, et la valeur de retour de la fonction est positionné à
<literal>ERROR</literal>.
</para>
</listitem>
@@ -598,7 +596,7 @@
<refentry id="CONTRIB-DBLINK-OPEN">
<refnamediv>
<refname>dblink_open</refname>
- <refpurpose>ouvre un curseur vers une base de données distante</refpurpose>
+ <refpurpose>ouvre un curseur sur une base de données distante</refpurpose>
</refnamediv>
<refsynopsisdiv>
@@ -612,7 +610,7 @@
<title>Description</title>
<para>
- <function>dblink_open()</function> ouvre un curseur vers une base de
+ <function>dblink_open()</function> ouvre un curseur sur une base de
données distante. Le curseur peut ensuite être manipulé avec
<function>dblink_fetch()</function> et
<function>dblink_close()</function>.
@@ -627,8 +625,8 @@
<term><parameter>conname</parameter></term>
<listitem>
<para>
- Nom de la connexion à utiliser ; omettez ce paramètre pour
- utiliser la connexion sans nom.
+ Le nom de la connexion à utiliser ; ce paramètre doit être omis
+ pour utiliser une connexion sans nom.
</para>
</listitem>
</varlistentry>
@@ -656,10 +654,10 @@
<term><parameter>fail_on_error</parameter></term>
<listitem>
<para>
- Si true (la valeur par défaut si elle n'est pas précisée), un message
- de type ERROR sur la base distante cause l'envoi d'un message de type
- ERROR en local. Dans le cas contraire, le message distant de type ERROR
- est traité localement comme un NOTICE, et la valeur renvoyée est
+ Si true (valeur par défaut en cas d'omission), une erreur distante
+ est reportée localement comme une erreur locale. Dans le cas contraire, un
+ message d'erreur distant est traité localement comme un message de type
+ NOTICE, et la valeur de retour de la fonction est positionné à
<literal>ERROR</literal>.
</para>
</listitem>
@@ -680,17 +678,17 @@
<title>Notes</title>
<para>
- Comme un curseur peut seulement persister dans une transaction,
+ Puisqu'un curseur ne peut persister qu'au sein d'une transaction,
<function>dblink_open</function> lance un bloc de transaction explicite
- (<command>BEGIN</command>) du côté distant, si le côté distant n'était
- pas déjà à l'intérieur d'une transaction. Cette transaction sera de
- nouveau fermée quand l'instruction <function>dblink_close</function>
- est exécutée. Notez que si <function>dblink_exec</function> est utilisé
+ (<command>BEGIN</command>) côté distant, si le côté distant n'est
+ pas déjà à l'intérieur d'une transaction. Cette transaction est refermée
+ à l'exécution de l'instruction <function>dblink_close</function>.
+ Si <function>dblink_exec</function> est utilisée
pour modifier les données entre <function>dblink_open</function> et
- <function>dblink_close</function>, et qu'ensuite une erreur survient ou
+ <function>dblink_close</function>, et qu'une erreur survient ou
que <function>dblink_disconnect</function> est utilisé avant
- <function>dblink_close</function>, vos modifications <emphasis>seront
- perdues</emphasis> car la transaction sera annulée.
+ <function>dblink_close</function>, les modifications <emphasis>sont
+ perdues</emphasis> car la transaction est annulée.
</para>
</refsect1>
@@ -744,8 +742,8 @@
<term><parameter>conname</parameter></term>
<listitem>
<para>
- Nom de la connexion à utiliser ; omettez ce paramètre pour
- utiliser la connexion sans nom.
+ Nom de la connexion à utiliser ; ce paramètre doit être omis pour
+ utiliser une connexion sans nom.
</para>
</listitem>
</varlistentry>
@@ -766,7 +764,7 @@
Nombre maximum de lignes à récupérer. Les
<parameter>howmany</parameter> lignes suivantes sont récupérées, en
commençant à la position actuelle du curseur, vers l'avant. Une fois
- le curseur positionné à la fin, aucune ligne supplémentaire ne sera
+ le curseur arrivé à la fin, aucune ligne supplémentaire n'est
renvoyée.
</para>
</listitem>
@@ -776,10 +774,10 @@
<term><parameter>fail_on_error</parameter></term>
<listitem>
<para>
- Si true (la valeur par défaut si elle n'est pas précisée), alors une
- erreur sur la base distante cause l'envoie d'un rapport d'erreur en
- local. Si elle vaut false, l'erreur distante est rapportée localement
- comme un NOTICE et la fonction ne renvoie aucune ligne.
+ Si true (valeur par défaut en cas d'omission), une erreur distante
+ est reportée localement comme une erreur locale. Dans le cas contraire, un
+ message d'erreur distant est traité localement comme un message de type
+ NOTICE, et la fonction ne retourne aucune ligne.
</para>
</listitem>
</varlistentry>
@@ -801,12 +799,12 @@
<title>Notes</title>
<para>
- S'il existe une différence entre le nombre de colonnes renvoyées spécifiées dans
+ Si le nombre de colonnes de retour spécifiées dans
la clause <literal>FROM</literal>, et le nombre réel de colonnes renvoyées
- par le curseur distant, une erreur sera remontée. Dans ce cas, le curseur
- distant sera toujours avancé du nombre de lignes spécifié comme si
- l'erreur n'avait pas eu lieu. Il en est de même pour
- toute autre erreur survenant dans la requête locale après l'exécution
+ par le curseur distant diffèrent, une erreur est remontée. Dans ce cas, le curseur
+ distant est tout de même avancé du nombre de lignes indiqué, comme si
+ l'erreur n'avait pas eu lieu. Il en est de même pour toute autre erreur
+ survenant dans la requête locale après l'exécution
du <command>FETCH</command> distant.
</para>
</refsect1>
@@ -892,8 +890,8 @@
<term><parameter>conname</parameter></term>
<listitem>
<para>
- Nom de la connexion à utiliser ; omettez ce paramètre pour
- utiliser la connexion sans nom.
+ Le nom de la connexion à utiliser ; ce paramètre doit être omis pour
+ utiliser une connexion sans nom.
</para>
</listitem>
</varlistentry>
@@ -902,7 +900,7 @@
<term><parameter>cursorname</parameter></term>
<listitem>
<para>
- Nom du curseur à fermer
+ Nom du curseur à fermer.
</para>
</listitem>
</varlistentry>
@@ -911,10 +909,10 @@
<term><parameter>fail_on_error</parameter></term>
<listitem>
<para>
- Si true (la valeur par défaut si elle n'est pas précisée), un message
- de type ERROR sur la base distante cause l'envoi d'un message de type
- ERROR en local. Dans le cas contraire, le message distant de type ERROR
- est traité localement comme un NOTICE, et la valeur renvoyée est
+ Si true (valeur par défaut en cas d'omission), une erreur distante
+ est reportée localement comme une erreur. Dans le cas contraire, un
+ message d'erreur distant est traité localement comme un message de type
+ NOTICE, et la valeur de retour est positionnée à
<literal>ERROR</literal>.
</para>
</listitem>
@@ -935,9 +933,9 @@
<title>Notes</title>
<para>
- Si <function>dblink_open</function> a commencé un bloc de transaction
- explicite, et que c'est le dernier curseur ouvrant restant dans cette
- connexion, <function>dblink_close</function> exécutera le
+ Si <function>dblink_open</function> a ouvert un bloc de transaction
+ explicite, et que c'est le dernier curseur ouvert restant dans cette
+ connexion, <function>dblink_close</function> exécute le
<command>COMMIT</command> correspondant.
</para>
</refsect1>
@@ -985,7 +983,7 @@
<para>
<function>dblink_get_connections</function> renvoie un tableau contenant
- le nom de toutes les connexions nommées et ouvertes de
+ le nom de toutes les connexions nommées ouvertes de
<filename>dblink</filename>.
</para>
</refsect1>
@@ -993,8 +991,8 @@
<refsect1>
<title>Valeur de retour</title>
- <para>Renvoie un tableau de texte des noms des connexion, ou NULL s'il n'y
- en as pas.</para>
+ <para>Renvoie un tableau texte des noms des connexions, ou NULL s'il n'y
+ en a pas.</para>
</refsect1>
<refsect1>
@@ -1024,7 +1022,7 @@
<para>
<function>dblink_error_message</function> récupère le dernier message
- d'erreur sur la connexion nommée.
+ d'erreur sur une connexion donnée.
</para>
</refsect1>
@@ -1036,7 +1034,7 @@
<term><parameter>conname</parameter></term>
<listitem>
<para>
- Nom de la connexion.
+ Nom de la connexion à utiliser.
</para>
</listitem>
</varlistentry>
@@ -1080,7 +1078,7 @@
<para>
<function>dblink_send_query</function> envoie une requête à exécuter
de façon asynchrone, c'est-à-dire sans attendre immédiatement le résultat.
- Il ne doit pas y avoir une requête asynchrone déjà en exécution sur la
+ Il ne doit pas déjà exister de requête asynchrone en exécution sur la
connexion.
</para>
@@ -1102,7 +1100,7 @@
<term><parameter>conname</parameter></term>
<listitem>
<para>
- Nom de la connexion à utiliser.
+ Le nom de la connexion à utiliser.
</para>
</listitem>
</varlistentry>
@@ -1166,7 +1164,7 @@
<term><parameter>conname</parameter></term>
<listitem>
<para>
- Nom de la connexion à vérifier
+ Le nom de la connexion à vérifier.
</para>
</listitem>
</varlistentry>
@@ -1179,7 +1177,7 @@
<para>
Renvoie 1 si la connexion est occupée, 0 dans le cas contraire.
Si cette fonction renvoie 0, il est garanti que l'appel à
- <function>dblink_get_result</function> sera pas bloquant.
+ <function>dblink_get_result</function> ne bloque pas.
</para>
</refsect1>
@@ -1210,9 +1208,8 @@
<para>
<function>dblink_get_result</function> récupère le résultat d'une
requête asynchrone précédemment envoyée avec
- <function>dblink_send_query</function>. Si la requête n'est pas déjà
- terminée, <function>dblink_get_result</function> attendra jusqu'à ce que
- ce soit le cas.
+ <function>dblink_send_query</function>. Si la requête n'est pas
+ terminée, <function>dblink_get_result</function> en attend la fin.
</para>
</refsect1>
@@ -1224,7 +1221,7 @@
<term><parameter>conname</parameter></term>
<listitem>
<para>
- Nom de la connexion à utiliser
+ Le nom de la connexion à utiliser.
</para>
</listitem>
</varlistentry>
@@ -1233,10 +1230,10 @@
<term><parameter>fail_on_error</parameter></term>
<listitem>
<para>
- Si true (la valeur par défaut si elle n'est pas précisée), un message
- de type ERROR sur la base distante cause l'envoi d'un message de type
- ERROR en local. Dans le cas contraire, le message distant de type ERROR
- est traité localement comme un NOTICE, et aucune ligne n'est renvoyée.
+ Si true (valeur par défaut en cas d'omission), une erreur distante
+ est reportée localement comme une erreur locale. Dans le cas contraire, un
+ message d'erreur distant est traité localement comme un message de type
+ NOTICE, et la fonction ne retourne aucune ligne.
</para>
</listitem>
</varlistentry>
@@ -1246,19 +1243,20 @@
<refsect1>
<title>Valeur de retour</title>
+<!-- statement : instruction -->
<para>
- Pour une requête asynchrone (c'est-à-dire une requête SQL renvoyant des
+ Pour une requête asynchrone (c'est-à-dire une instruction SQL renvoyant des
lignes), la fonction renvoie les lignes produites par la requête. Pour
- utiliser cette fonction, l'ensemble des colonnes
- attendues doit être spécifié comme indiqué pour <function>dblink</function>.
+ utiliser cette fonction, il faut spécifier l'ensemble des colonnes
+ attendues, comme indiqué pour <function>dblink</function>.
</para>
<para>
- Pour une commande asynchrone (c'est-à-dire une requête SQL ne renvoyant aucune
+ Pour une commande asynchrone (c'est-à-dire une instruction SQL ne renvoyant aucune
ligne), la fonction renvoie une seule ligne avec une colonne texte
- contenant la chaîne de statut de la commande. Il est nécessaire de
- d'indiquer dans la requête que le résultat aura une colonne texte dans la clause
- <literal>FROM</literal> appelante.
+ contenant la chaîne de statut de la commande. Il est impératif
+ d'indiquer dans la clause <literal>FROM</literal> appelante que le résultat
+ est constitué d'une unique colonne texte .
</para>
</refsect1>
@@ -1269,7 +1267,7 @@
Cette fonction <emphasis>doit</emphasis> être appelée si
<function>dblink_send_query</function> a renvoyé 1. Elle doit l'être
une fois pour chaque requête envoyée, et une fois de plus pour obtenir
- un ensemble vide avant de pouvoir utiliser de nouveau la connexion.
+ un ensemble vide, avant de pouvoir utiliser à nouveau la connexion.
</para>
</refsect1>
@@ -1353,11 +1351,11 @@
<para>
<function>dblink_cancel_query</function> tente d'annuler toute requête
- en cours d'exécution sur la connexion nommée. Notez que la réussite de
- la fonction n'est pas assurée (car, par exemple, la requête distante
- pourrait être déjà terminée). Une demande d'annulation améliore simplement
- les possibilités que la question échoue rapidement. Vous devez toujours
- terminer le protocole de la requête, par exemple en appelant
+ en cours d'exécution sur la connexion nommée. La réussite de
+ la fonction n'est pas assurée (la requête distante pourrait, par exemple,
+ être déjà terminée). Une demande d'annulation augmente simplement
+ la probabilité que la requête échoue rapidement. Le protocoel de requête
+ normal doit toujours être terminé, par exemple en appelant
<function>dblink_get_result</function>.
</para>
</refsect1>
@@ -1370,7 +1368,7 @@
<term><parameter>conname</parameter></term>
<listitem>
<para>
- Nom de la connexion à utiliser.
+ Le nom de la connexion à utiliser.
</para>
</listitem>
</varlistentry>
@@ -1381,7 +1379,7 @@
<title>Valeur de retour</title>
<para>
- Renvoie <literal>OK</literal> si la demande d'annulation a bien été
+ Renvoie <literal>OK</literal> si la demande d'annulation a été
envoyée, ou le texte d'un message d'erreur en cas d'échec.
</para>
</refsect1>
@@ -1412,10 +1410,10 @@
<para>
Renvoie la commande en cours d'exécution sur la session locale, ou
- NULL si ce n'est pas déterminable. Notez que cette fonction n'a pas
- de relation avec d'autres fonctionnalités de <filename>dblink</filename>.
- Elle est fournie car elles est parfois utile pour générer des requêtes à
- envoyer à des bases distantes.
+ NULL si elle ne peut être déterminée. Cette fonction n'est pas liée
+ aux autres fonctionnalités de <filename>dblink</filename>.
+ Elle est fournie car il est parfois utile de produire des requêtes à
+ transmettre à des bases distantes.
</para>
</refsect1>
@@ -1457,8 +1455,8 @@
<para>
<function>dblink_get_pkey</function> fournit des informations sur la clé
- primaire d'une relation dans la base de données locale. C'est parfois
- utile dans la génération de requêtes à envoyer sur des bases distantes.
+ primaire d'une relation de la base de données locale. Il est parfois
+ utile de produire des requêtes à transmettre à des bases distantes.
</para>
</refsect1>
@@ -1470,18 +1468,18 @@
<term><parameter>relname</parameter></term>
<listitem>
<para>
- Nom d'une relation existante, par exemple <literal>foo</literal> ou
- <literal>monschema.matable</literal>. Ajoutez des guillemets doubles
- si le nom est en minuscule et en majuscule, ou contient des
+ Le nom d'une relation locale, par exemple <literal>foo</literal> ou
+ <literal>monschema.matable</literal>. Ajouter des guillemets doubles
+ si le nom a une casse mixte, ou contient des
caractères spéciaux, par exemple <literal>"FooBar"</literal> ;
- sans guillemets, la chaîne sera mise en minuscule.
+ sans guillemets, la chaîne est forcée en minuscule.
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
-5H <refsect1>
+ <refsect1>
<title>Valeur de retour</title>
<para>
@@ -1517,8 +1515,8 @@
<refnamediv>
<refname>dblink_build_sql_insert</refname>
<refpurpose>
- construit une instruction d'insertion en utilisant une ligne locale,
- remplaçant les valeurs des champs de la clé primaire pour la sélection
+ construit une instruction d'insertion en utilisant un tuple local,
+ remplaçant les valeurs des champs de la clé primaire
avec les valeurs fournies
</refpurpose>
</refnamediv>
@@ -1539,11 +1537,11 @@
<para>
<function>dblink_build_sql_insert</function> peut être utile pour réaliser
une réplication sélective d'une table locale vers une base distante.
- Elle sélectionne une ligne de la table locale basée sur la clé primaire
- et construit une commande SQL <command>INSERT</command> qui dupliquera
- cette ligne, mais avec les valeurs de clé primaire remplacées par les
- valeurs du dernier argument. (Pour réaliser une copie exacte de la ligne,
- indiquez simplement les mêmes valeurs pour les deux derniers arguments.)
+ Elle sélectionne une ligne de la table locale sur la base de la clé primaire
+ et construit une commande SQL <command>INSERT</command> qui duplique
+ cette ligne, mais avec pour valeurs de clé primaire celles
+ du dernier argument. (Pour réaliser une copie exacte de la ligne,
+ il suffit d'indiquer les mêmes valeurs pour les deux derniers arguments.)
</para>
</refsect1>
@@ -1555,11 +1553,11 @@
<term><parameter>relname</parameter></term>
<listitem>
<para>
- Nom d'une relation existante, par exemple <literal>foo</literal> ou
- <literal>monschema.matable</literal>. Ajoutez des guillemets doubles
- si le nom est en minuscule et en majuscule, ou contient des
+ Le nom d'une relation locale, par exemple <literal>foo</literal> ou
+ <literal>monschema.matable</literal>. Ajouter des guillemets doubles
+ si le nom est en casse mixte ou contient des
caractères spéciaux, par exemple <literal>"FooBar"</literal> ;
- sans guillemets, la chaîne sera mise en minuscule.
+ sans guillemets, la chaîne est forcée en minuscule.
</para>
</listitem>
</varlistentry>
@@ -1568,7 +1566,7 @@
<term><parameter>primary_key_attnums</parameter></term>
<listitem>
<para>
- Numéros des attributs (commençant à 1) des champs de la clé primaire,
+ Les numéros des attributs (commençant à 1) des champs de la clé primaire,
par exemple <literal>1 2</literal>.
</para>
</listitem>
@@ -1578,7 +1576,7 @@
<term><parameter>num_primary_key_atts</parameter></term>
<listitem>
<para>
- Le nombre de champs de la clé primaire
+ Le nombre de champs de la clé primaire.
</para>
</listitem>
</varlistentry>
@@ -1587,9 +1585,9 @@
<term><parameter>src_pk_att_vals_array</parameter></term>
<listitem>
<para>
- Les valeurs des champs de la clé primaire pour rechercher la ligne
- locale. Chaque champ est représenté dans sa forme textuelle. Une
- erreur est renvoyé s'il n'y a pas de lignes locales avec ces valeurs
+ Les valeurs des champs de la clé primaire à utiliser pour identifier
+ le tuple local. Chaque champ est représenté dans sa forme textuelle. Une
+ erreur est renvoyée s'il n'y a pas de lignes locales avec ces valeurs
de clé primaire.
</para>
</listitem>
@@ -1630,9 +1628,8 @@
<refentry id="CONTRIB-DBLINK-BUILD-SQL-DELETE">
<refnamediv>
<refname>dblink_build_sql_delete</refname>
- <refpurpose>construit une instruction de suppression en utilisant une ligne
- locale, en remplaçant les valeurs des champs de la clé primaire pour la
- sélection avec les valeurs fournies
+ <refpurpose>construit une instruction de suppression en utilisant
+ les valeurs fournies pour les champs de la clé primaire
</refpurpose>
</refnamediv>
@@ -1651,8 +1648,8 @@
<para>
<function>dblink_build_sql_delete</function> peut être utile pour réaliser
une réplication sélective d'une table locale vers une base distante.
- Elle construit une commande SQL <command>DELETE</command> qui supprimera
- la ligne avec les valeurs indiquées pour la clé primaire.
+ Elle construit une commande SQL <command>DELETE</command> qui supprime
+ la ligne avec les valeurs indiquées de clé primaire.
</para>
</refsect1>
@@ -1664,11 +1661,11 @@
<term><parameter>relname</parameter></term>
<listitem>
<para>
- Nom d'une relation existante, par exemple <literal>foo</literal> ou
- <literal>monschema.matable</literal>. Ajoutez des guillemets doubles
- si le nom est en minuscule et en majuscule, ou contient des
+ Le nom d'une relation locale, par exemple <literal>foo</literal> ou
+ <literal>monschema.matable</literal>. Ajouter des guillemets doubles
+ si le nom est en casse mixte ou contient des
caractères spéciaux, par exemple <literal>"FooBar"</literal> ;
- sans guillemets, la chaîne sera mise en minuscule.
+ sans guillemets, la chaîne est forcée en minuscule.
</para>
</listitem>
</varlistentry>
@@ -1677,7 +1674,7 @@
<term><parameter>primary_key_attnums</parameter></term>
<listitem>
<para>
- Numéros des attributs (commençant à 1) des champs de la clé primaire,
+ Les numéros des attributs (commençant à 1) des champs de la clé primaire,
par exemple <literal>1 2</literal>.
</para>
</listitem>
@@ -1687,7 +1684,7 @@
<term><parameter>num_primary_key_atts</parameter></term>
<listitem>
<para>
- Le nombre de champs de la clé primaire
+ Le nombre de champs de la clé primaire.
</para>
</listitem>
</varlistentry>
@@ -1727,9 +1724,9 @@
<refentry id="CONTRIB-DBLINK-BUILD-SQL-UPDATE">
<refnamediv>
<refname>dblink_build_sql_update</refname>
- <refpurpose>construit une instruction de mise à jour en utilisant une ligne
- locale, en remplaçant les valeurs des champs de la clé primaire pour la
- sélection avec les valeurs fournies
+ <refpurpose>construit une instruction de mise à jour à partir d'un tuple
+ local, en remplaçant les valeurs des champs de la clé primaire par celles
+ fournies
</refpurpose>
</refnamediv>
@@ -1751,13 +1748,13 @@
une réplication sélective d'une table locale vers une base de donnée
distante. Elle sélectionne une ligne à partir de la table locale en se
basant sur la clé primaire, puis construit une commande SQL
- <command>UPDATE</command> qui dupliquera cette ligne, mais avec les valeurs
- de clé primaire remplacées par les valeurs dans le dernier argument.
- (Pour faire une copie exacte de la ligne, indiquez les mêmes valeurs
+ <command>UPDATE</command> qui duplique cette ligne, mais avec pour valeurs
+ de clé primaire celles du dernier argument.
+ (Pour faire une copie exacte de la ligne, on indique les mêmes valeurs
pour les deux derniers arguments.) La commande <command>UPDATE</command>
affecte toujours tous les champs de la ligne — la différence
- principale entre ceci et <function>dblink_build_sql_insert</function> est
- qu'il est supposé que la ligne cible existe déjà dans la table distante.
+ principale entre cette instruction et <function>dblink_build_sql_insert</function> est
+ l'hypothèse de l'existence de la ligne cible dans la table distante.
</para>
</refsect1>
@@ -1769,11 +1766,11 @@
<term><parameter>relname</parameter></term>
<listitem>
<para>
- Nom d'une relation existante, par exemple <literal>foo</literal> ou
- <literal>monschema.matable</literal>. Ajoutez des guillemets doubles
- si le nom est en minuscule et en majuscule, ou contient des
+ Le nom d'une relation locale, par exemple <literal>foo</literal> ou
+ <literal>monschema.matable</literal>. Ajouter des guillemets doubles
+ si le nom est en casse mixte ou contient des
caractères spéciaux, par exemple <literal>"FooBar"</literal> ;
- sans guillemets, la chaîne sera mise en minuscule.
+ sans guillemets, la chaîne est forcée en minuscule.
</para>
</listitem>
</varlistentry>
@@ -1782,7 +1779,7 @@
<term><parameter>primary_key_attnums</parameter></term>
<listitem>
<para>
- Numéros des attributs (commençant à 1) des champs de la clé primaire,
+ Les numéros des attributs (commençant à 1) des champs de la clé primaire,
par exemple <literal>1 2</literal>.
</para>
</listitem>
@@ -1792,7 +1789,7 @@
<term><parameter>num_primary_key_atts</parameter></term>
<listitem>
<para>
- Le nombre de champs de la clé primaire
+ Le nombre de champs de la clé primaire.
</para>
</listitem>
</varlistentry>
@@ -1801,9 +1798,9 @@
<term><parameter>src_pk_att_vals_array</parameter></term>
<listitem>
<para>
- Les valeurs des champs de la clé primaire pour rechercher la ligne
- locale. Chaque champ est représenté dans sa forme textuelle. Une
- erreur est renvoyé s'il n'y a pas de lignes locales avec ces valeurs
+ Les valeurs des champs de la clé primaire à utiliser pour identifier le
+ tuple local. Chaque champ est représenté dans sa forme textuelle. Une
+ erreur est renvoyée s'il n'y a pas de lignes locales avec ces valeurs
de clé primaire.
</para>
</listitem>
Modified: traduc/trunk/postgresql/dict-int.xml
===================================================================
--- traduc/trunk/postgresql/dict-int.xml 2008-07-03 09:08:14 UTC (rev 1087)
+++ traduc/trunk/postgresql/dict-int.xml 2008-07-04 08:09:40 UTC (rev 1088)
@@ -13,10 +13,10 @@
<para>
<filename>dict_int</filename> est un exemple de modèle de dictionnaire pour
- la recherche plein texte. Ce qui a motivé la création de ce dictionnaire
- est le contrôle de l'indexage des entiers (signés et non signés),
- permettant à des tels nombres d'être indexés tout en empêchant un
- grossissement excessif du nombre des mots uniques qui affecte
+ la recherche plein texte. La création de ce dictionnaire à été motivée par la
+ volonté de pouvoir contrôler l'indexage d'entiers (signés et non signés),
+ pour permettre à de tels nombres d'être indexés sans
+ grossissement excessif du nombre de mots uniques, ce qui affecte
grandement la performance de la recherche.
</para>
@@ -29,20 +29,21 @@
<itemizedlist>
<listitem>
<para>
- Le paramètre <literal>maxlen</literal> spécifie le nombre maximum de
- chiffres autorisée dans un mot de type entier. La valeur par défaut
- est de 6.
+ le paramètre <literal>maxlen</literal> indique le nombre maximum de
+ chiffres autorisés dans un mot de type entier. La valeur par défaut
+ est 6 ;
</para>
</listitem>
<listitem>
+ <!-- stop word : terme courant ??? -->
<para>
- Le paramètre <literal>rejectlong</literal> spécifie si un entier trop
- gros doit être tronqué ou ignoré. Si <literal>rejectlong</literal> vaut
- <literal>false</literal> (la valeur par défaut), le dictionnaire renvoie
+ Le paramètre <literal>rejectlong</literal> précise si un entier trop
+ long doit être tronqué ou ignoré. Si <literal>rejectlong</literal> vaut
+ <literal>false</literal> (valeur par défaut), le dictionnaire renvoie
les <literal>maxlen</literal> premiers chiffres de l'entier. Si
<literal>rejectlong</literal> vaut <literal>true</literal>, le
dictionnaire traite l'entier comme un terme courant, l'entier n'est
- donc pas indexé. Notez que cela signifie aussi qu'un tel nombre ne peut
+ donc pas indexé. Cela signifie aussi qu'un tel nombre ne peut
pas être recherché.
</para>
</listitem>
@@ -53,17 +54,17 @@
<title>Utilisation</title>
<para>
- Exécuter le script d'installation crée un modèle de recherche plein
+ L'exécution du script d'installation crée un modèle de recherche plein
texte <literal>intdict_template</literal> et un dictionnaire
<literal>intdict</literal> basé sur ce dernier avec les paramètres par
- défaut. Vous pouvez modifier les paramètres, par exemple :
+ défaut. Les paramètres peuvent être modifiés, par exemple :
<programlisting>
mabase ALTER TEXT SEARCH DICTIONARY intdict (MAXLEN = 4, REJECTLONG = true);
ALTER TEXT SEARCH DICTIONARY
</programlisting>
- ou créer des nouveaux dictionnaires basés sur le modèle.
+ ou de nouveaux dictionnaires basés sur le modèle créés.
</para>
<para>
@@ -78,7 +79,7 @@
mais une utilisation réelle nécessite de l'inclure dans une configuration
de recherche plein texte comme celle décrite dans <xref
- linkend="textsearch"/>. Cela pourrait ressembler à ceci :
+ linkend="textsearch"/>. Cela peut ressembler à ceci :
<programlisting>
ALTER TEXT SEARCH CONFIGURATION english
Modified: traduc/trunk/postgresql/dict-xsyn.xml
===================================================================
--- traduc/trunk/postgresql/dict-xsyn.xml 2008-07-03 09:08:14 UTC (rev 1087)
+++ traduc/trunk/postgresql/dict-xsyn.xml 2008-07-04 08:09:40 UTC (rev 1088)
@@ -13,11 +13,11 @@
<para>
Le module <filename>dict_xsyn</filename> (<foreignphrase>Extended Synonym
- Dictionary</foreignphrase>, autrement dit le dictionnaire étendu de
- synonymes) est un exemple d'un modèle de dictionnaire pour la recherche
+ Dictionary</foreignphrase>, dictionnaire étendu de
+ synonymes) est un exemple de modèle de dictionnaire pour la recherche
plein texte. Ce type de dictionnaire remplace des mots avec un ensemble
de synonymes, ce qui rend possible la recherche d'un mot en utilisant
- tous ses synonymes.
+ un de ses synonymes.
</para>
<sect2>
@@ -29,18 +29,19 @@
<itemizedlist>
<listitem>
<para>
- si <literal>keeporig</literal> vaut <literal>true</literal> (la valeur
- par défaut), le mot original est inclus dans la recherche. Dans le cas
- contraire, seuls les synonymes sont pris en compte.
+ <literal>keeporig</literal> indique si le mot original est inclus dans la
+ recherche (si <literal>true</literal>, valeur par défaut), ou seulement
+ ses synonymes (si <literal>false</literal>) ;
</para>
</listitem>
<listitem>
<para>
- <literal>rules</literal> est le nom de base du fichier contenant la liste
+ <literal>rules</literal> est le nom du fichier contenant la liste
des synonymes. Ce fichier doit être stocké dans
- <filename>$SHAREDIR/tsearch_data/</filename> (où <literal>$SHAREDIR</literal> est le répertoire des données partagées de
+ <filename>$SHAREDIR/tsearch_data/</filename>
+ (où <literal>$SHAREDIR</literal> est le répertoire des données partagées de
la distribution <productname>PostgreSQL</productname>).
- Son nom doit se terminer en <literal>.rules</literal> (cette extension
+ Son nom doit se terminer par <literal>.rules</literal> (cette extension
n'est pas à inclure dans le paramètre <literal>rules</literal>).
</para>
</listitem>
@@ -51,9 +52,9 @@
<itemizedlist>
<listitem>
<para>
- Chaque ligne représente une groupe de synonymes pour un mot simple qui
- est donné en premier sur la ligne. Les synonymes sont séparés par
- un espace blanc :
+ chaque ligne représente un groupe de synonymes pour un mot simple,
+ donné en premier sur la ligne. Les synonymes sont séparés par
+ une espace :
</para>
<programlisting>
mot syn1 syn2 syn3
@@ -61,15 +62,15 @@
</listitem>
<listitem>
<para>
- Un signe dièse (<literal>#</literal>) est un délimiteur de commentaires. Il peut
+ le signe dièse (<literal>#</literal>) est un délimiteur de commentaires. Il peut
apparaître dans la ligne. Le reste de la ligne est ignoré.
</para>
</listitem>
</itemizedlist>
<para>
- Cherchez dans <filename>xsyn_sample.rules</filename> qui est installé dans
- <filename>$SHAREDIR/tsearch_data/</filename> pour un exemple.
+ Un exemple est donné dans <filename>xsyn_sample.rules</filename> qui est installé dans
+ <filename>$SHAREDIR/tsearch_data/</filename>.
</para>
</sect2>
@@ -80,18 +81,18 @@
L'exécution du script d'installation crée un modèle
<literal>xsyn_template</literal> de recherche plein texte et un dictionnaire
<literal>xsyn</literal> basé sur le modèle, avec des paramètres par défaut.
- Vous pouvez modifier les paramètres, par exemple :
+ Il est possible de modifier les paramètres, par exemple :
<programlisting>
mydb# ALTER TEXT SEARCH DICTIONARY xsyn (RULES='my_rules', KEEPORIG=false);
ALTER TEXT SEARCH DICTIONARY
</programlisting>
- ou créer de nouveaux dictionnaires basés sur le modèle.
+ ou de créer de nouveaux dictionnaires basés sur le modèle.
</para>
<para>
- Pour tester le dictionnaire, vous pouvez essayer :
+ Pour tester le dictionnaire :
<programlisting>
mydb=# SELECT ts_lexize('xsyn', 'word');
@@ -100,7 +101,7 @@
{word,syn1,syn2,syn3}
</programlisting>
- mais une utilisation réelle impliquera son ajout dans une configuration de
+ mais une utilisation réelle implique son ajout dans une configuration de
recherche plein texte comme décrit dans <xref linkend="textsearch"/>. Cela
pourrait ressembler à ceci :
Modified: traduc/trunk/postgresql/diskusage.xml
===================================================================
--- traduc/trunk/postgresql/diskusage.xml 2008-07-03 09:08:14 UTC (rev 1087)
+++ traduc/trunk/postgresql/diskusage.xml 2008-07-04 08:09:40 UTC (rev 1088)
@@ -9,8 +9,8 @@
<title>Surveiller l'utilisation des disques</title>
<para>
- Ce chapitre explique comment surveiller l'utilisation des disques faite par
- <productname>PostgreSQL</productname>.
+ Ce chapitre explique comment surveiller l'utilisation que fait
+ <productname>PostgreSQL</productname> des disques.
</para>
@@ -26,7 +26,7 @@
des données sont stockées. Si la table contient des colonnes pouvant recevoir
des valeurs étendues, il existe aussi un fichier <acronym>TOAST</acronym> associé à la
table. Ce fichier permet de stocker les valeurs trop larges pour tenir
- dansle table principale (voir la <xref linkend="storage-toast"/>).
+ dans la table principale (voir la <xref linkend="storage-toast"/>).
Si la table <acronym>TOAST</acronym> existe, un index lui est associé.
Des index peuvent également être associés à la table de base.
Chaque table ou index est stocké dans un fichier distinct —
@@ -41,17 +41,12 @@
<command>VACUUM</command>, depuis <application>psql</application> avec les outils de
<filename>contrib/dbsize</filename> et en ligne de commande avec les outils de
<filename>contrib/oid2name</filename>.
- <!-- Ajout SAS 20070511
- The SQL functions are the easiest to use and report information about
- tables, tables with indexes and long value storage (TOAST), databases, and
- tablespaces. -->
</para>
<para>
- Les fonctions SQL sont les plus faciles à utilise. Elles rapporte des
+ Les fonctions SQL sont les plus faciles à utiliser. Elles rapportent des
informations concernant les tables, les tables avec index et stockage de
valeurs étendues (TOAST), les bases de données et les
<foreignphrase>tablespaces</foreignphrase>.
- <!-- Fin ajout -->
</para>
<para>
@@ -120,16 +115,8 @@
customer | 3144</programlisting>
</para>
-<!-- SAS 20070511 : le passage suivant n'est plus dans la doc 824...
<para>
- <filename>contrib/dbsize</filename> charge dans la base les fonctions permettant
- de calculer la taille d'une base ou d'une table à partir de
- <application>psql</application> sans utiliser <command>VACUUM</command> ou <command>ANALYZE</command>.
- </para>
-Jusque-là -->
-
- <para>
- L'utilitaire <filename>contrib/oid2name</filename> permet de connaître
+ L'utilitaire <filename>contrib/oid2name</filename> permet également de connaître
l'utilisation de l'espace disque. Des exemples d'utilisation sont repris dans
le fichier <filename>README.oid2name</filename> situé dans le répertoire
de l'utilitaire. On y trouve notamment un script permettant de connaître l'utilisation
Modified: traduc/trunk/postgresql/dml.xml
===================================================================
--- traduc/trunk/postgresql/dml.xml 2008-07-03 09:08:14 UTC (rev 1087)
+++ traduc/trunk/postgresql/dml.xml 2008-07-04 08:09:40 UTC (rev 1088)
@@ -39,7 +39,7 @@
La première chose à faire, c'est d'y insérer des données. Sans quoi
la base de données n'est pas d'une grande utilité.
Les données sont conceptuellement insérées ligne par ligne. Il est évidemment possible
- d'insérer plus d'une ligne mais il n'est pas possible d'entrer moins
+ d'insérer plus d'une ligne, mais il n'est pas possible d'entrer moins
d'une ligne à la fois. Même lorsque seules les valeurs d'une
partie des colonnes sont connues, une ligne complète doit être créée.
</para>
@@ -58,6 +58,7 @@
prix numeric
);</programlisting>
</para>
+ <!-- SAS::ICI -->
<para>
Une commande d'insertion d'une ligne peut être :
<programlisting>INSERT INTO produits VALUES (1, 'Fromage', 9.99);</programlisting>
More information about the Trad
mailing list