Changeset 919

Show
Ignore:
Timestamp:
02/14/08 00:05:33 (1 year ago)
Author:
jca
Message:

Travail de relecture effectué à 71%, début de reformulation
nous/vous à la forme impersonnelle.

Files:

Legend:

Unmodified
Added
Removed
Modified
Copied
Moved

  • traduc/trunk/postgresql/dblink.xml

    r905 r919  
    330330    <function>dblink</function> peut être utilisée avec toute requête, elle 
    331331    est déclarée comme renvoyant le type <type>record</type>, et ne spécifie 
    332     donc aucun ensemble particulier de colonnes. Ceci signifie que vous 
    333     devez spécifier l'ensemble de colonnes attendues dans la requête 
    334     appelant &mdash; sinon <productname>PostgreSQL</productname> ne sait pas 
     332    donc aucun ensemble particulier de colonnes. Ceci signifie que 
     333    l'ensemble des colonnes attendues doit être spécifié dans la 
     334    requête appelante &mdash; sinon 
     335    <productname>PostgreSQL</productname> ne sait pas  
    335336    à quoi s'attendre. Voici un exemple&nbsp;: 
    336337 
    …… 
    527528     <listitem> 
    528529      <para> 
    529        La commande SQL que vous souhaitez exécuter dans la base de données 
     530       La commande SQL à exécuter dans la base de données 
    530531       distante&nbsp;; par exemple 
    531532       <literal>INSERT INTO foo VALUES(0,'a','{"a0","b0","c0"}')</literal>. 
    …… 
    688689    pas déjà à l'intérieur d'une transaction. Cette transaction sera de 
    689690    nouveau fermée quand l'instruction <function>dblink_close</function> 
    690     est exécutée. Notez que si vous utilisez <function>dblink_exec</function> 
     691    est exécutée. Notez que si <function>dblink_exec</function> est utilisé 
    691692    pour modifier les données entre <function>dblink_open</function> et 
    692693    <function>dblink_close</function>, et qu'ensuite une erreur survient ou 
    693     que vous utilisez <function>dblink_disconnect</function> avant 
     694    que <function>dblink_disconnect</function> est utilisé avant 
    694695    <function>dblink_close</function>, vos modifications <emphasis>seront 
    695696    perdues</emphasis> car la transaction sera annulée. 
    …… 
    794795   <para> 
    795796    La fonction renvoie les lignes récupérées à partir du curseur. Pour 
    796     utiliser cette fonction, vous devez spécifier l'ensemble des colonnes 
    797     attendues, comme décrit précédemment pour <function>dblink</function>. 
     797    utiliser cette fonction, l'ensemble des colonnes  
     798    attendues doit être spécifié, comme décrit précédemment pour 
     799    <function>dblink</function>.  
    798800   </para> 
    799801  </refsect1> 
    …… 
    863865  </refsect1> 
    864866 </refentry> 
    865 <!-- JCA::TAG RELECTURE --> 
     867 
    866868 <refentry id="CONTRIB-DBLINK-CLOSE"> 
    867869  <refnamediv> 
    …… 
    948950 
    949951   <programlisting> 
    950  test=# select dblink_connect('dbname=postgres'); 
     952 select dblink_connect('dbname=postgres'); 
    951953  dblink_connect 
    952954 ---------------- 
    …… 
    954956 (1 row) 
    955957 
    956  test=# select dblink_open('foo', 'select proname, prosrc from pg_proc'); 
     958 select dblink_open('foo', 'select proname, prosrc from pg_proc'); 
    957959  dblink_open 
    958960 ------------- 
    …… 
    960962 (1 row) 
    961963 
    962  test=# select dblink_close('foo'); 
     964 select dblink_close('foo'); 
    963965  dblink_close 
    964966 -------------- 
    …… 
    10871089 
    10881090   <para> 
    1089     Après un envoi réussi d'une requête asynchrone, le statut de fin 
     1091    Après l'envoi réussi d'une requête asynchrone, le statut de fin 
    10901092    d'exécution de la requête se vérifie avec 
    10911093    <function>dblink_is_busy</function>, et les résultats sont finalement 
    1092     récupérés avec <function>dblink_get_result</function>. Il est aussi 
    1093     de tenter l'annulation d'une rquête asynchrone active en utilisant 
    1094     <function>dblink_cancel_query</function>. 
     1094    récupérés avec <function>dblink_get_result</function>. Il est 
     1095    aussi possible de tenter l'annulation d'une rquête asynchrone 
     1096    active en utilisant  <function>dblink_cancel_query</function>.  
    10951097   </para> 
    10961098  </refsect1> 
    …… 
    11131115     <listitem> 
    11141116      <para> 
    1115        L'instruction SQL que vous voulez exécuter dans la base de données 
     1117       L'instruction SQL à exécuter dans la base de données 
    11161118       distante, par exemple <literal>select * from pg_class</literal>. 
    11171119      </para> 
    …… 
    11411143  <refnamediv> 
    11421144   <refname>dblink_is_busy</refname> 
    1143    <refpurpose>vérifie si la connexion est occupée avec une requête 
     1145   <refpurpose>vérifie si la connexion est occupée par le traitement d'une requête 
    11441146   asynchrone</refpurpose> 
    11451147  </refnamediv> 
    …… 
    11801182   <para> 
    11811183    Renvoie 1 si la connexion est occupée, 0 dans le cas contraire. 
    1182     Si cette fonction renvoie 0, il est garantie que 
    1183     <function>dblink_get_result</function> ne bloquera pas. 
     1184    Si cette fonction renvoie 0, il est garanti que l'appel à 
     1185    <function>dblink_get_result</function> sera pas bloquant. 
    11841186   </para> 
    11851187  </refsect1> 
    …… 
    12511253    Pour une requête asynchrone (c'est-à-dire une requête SQL renvoyant des 
    12521254    lignes), la fonction renvoie les lignes produites par la requête. Pour 
    1253     utiliser cette fonction, vous devez indiquer l'ensemble des colonnes 
    1254     attendues comme indiqué pour <function>dblink</function>. 
    1255    </para> 
    1256  
    1257    <para> 
    1258     Pour une commande asynchrone (c'est-à-dire une requête SQL renvoyant des 
    1259     lignes), la fonction renvoie une seule ligne avec une colonne texte 
     1255    utiliser cette fonction, l'ensemble des colonnes 
     1256    attendues doit être spécifié comme indiqué pour <function>dblink</function>. 
     1257   </para> 
     1258 
     1259   <para> 
     1260    Pour une commande asynchrone (c'est-à-dire une requête SQL ne renvoyant aucune 
     1261    ligne), la fonction renvoie une seule ligne avec une colonne texte 
    12601262    contenant la chaîne de statut de la commande. Il est nécessaire de 
    1261     spécifier que le résultat aura une colonne texte dans la clause 
     1263    d'indiquer dans la requête que le résultat aura une colonne texte dans la clause 
    12621264    <literal>FROM</literal> appelante. 
    12631265   </para> 
    …… 
    12691271   <para> 
    12701272    Cette fonction <emphasis>doit</emphasis> être appelée si 
    1271     <function>dblink_send_query</function> a renvoyé 1. Elle doit être appelée 
     1273    <function>dblink_send_query</function> a renvoyé 1. Elle doit l'être 
    12721274    une fois pour chaque requête envoyée, et une fois de plus pour obtenir 
    12731275    un ensemble vide avant de pouvoir utiliser de nouveau la connexion. 
    …… 
    13361338  </refsect1> 
    13371339 </refentry> 
    1338  
     1340<!-- JCA::TAG RELECTURE --> 
    13391341 <refentry id="CONTRIB-DBLINK-CANCEL-QUERY"> 
    13401342  <refnamediv> 
    …… 
    14311433 
    14321434   <programlisting> 
    1433 test=# select dblink_current_query(); 
     1435select dblink_current_query(); 
    14341436      dblink_current_query 
    14351437-------------------------------- 
    …… 
    15011503 
    15021504   <programlisting> 
    1503 test=# create table foobar(f1 int, f2 int, f3 int, 
     1505create table foobar(f1 int, f2 int, f3 int, 
    15041506test(#   primary key(f1,f2,f3)); 
    15051507CREATE TABLE 
    1506 test=# select * from dblink_get_pkey('foobar'); 
     1508select * from dblink_get_pkey('foobar'); 
    15071509 position | colname 
    15081510----------+--------- 
    …… 
    16201622 
    16211623   <programlisting> 
    1622  test=# select dblink_build_sql_insert('foo', '1 2', 2, '{"1", "a"}', '{"1", "b''a"}'); 
     1624 select dblink_build_sql_insert('foo', '1 2', 2, '{"1", "a"}', '{"1", "b''a"}'); 
    16231625              dblink_build_sql_insert 
    16241626 -------------------------------------------------- 
    …… 
    17171719 
    17181720   <programlisting> 
    1719  test=# select dblink_build_sql_delete('"MyFoo"', '1 2', 2, '{"1", "b"}'); 
     1721 select dblink_build_sql_delete('"MyFoo"', '1 2', 2, '{"1", "b"}'); 
    17201722            dblink_build_sql_delete 
    17211723 --------------------------------------------- 
    …… 
    18341836 
    18351837   <programlisting> 
    1836  test=# select dblink_build_sql_update('foo', '1 2', 2, '{"1", "a"}', '{"1", "b"}'); 
     1838 select dblink_build_sql_update('foo', '1 2', 2, '{"1", "a"}', '{"1", "b"}'); 
    18371839                    dblink_build_sql_update 
    18381840 -------------------------------------------------------------