Changeset 847
- Timestamp:
- 12/14/07 16:48:21 (1 year ago)
- Files:
-
- traduc/trunk/manuel/config.xml (modified) (1 diff)
- traduc/trunk/manuel/dblink.xml (modified) (75 diffs)
- traduc/trunk/manuel/frenchtranslation.xml (modified) (7 diffs)
- traduc/trunk/manuel/ltree.xml (modified) (49 diffs)
- traduc/trunk/manuel/pgcrypto.xml (modified) (55 diffs)
- traduc/trunk/manuel/tablefunc.xml (modified) (35 diffs)
Legend:
- Unmodified
- Added
- Removed
- Modified
- Copied
- Moved
traduc/trunk/manuel/config.xml
r842 r847 1396 1396 <para> 1397 1397 Voir aussi la <xref linkend="wal-configuration"/> pour les détails 1398 concernant l'optimisation des desWAL.1398 concernant l'optimisation des WAL. 1399 1399 </para> 1400 1400 traduc/trunk/manuel/dblink.xml
r838 r847 7 7 8 8 <para> 9 <literal>dblink</literal> is a module which allows connections with10 other databases.9 <literal>dblink</literal> est un module qui permet la connexion à d'autres 10 bases de données. 11 11 </para> 12 12 … … 14 14 <refnamediv> 15 15 <refname>dblink_connect</refname> 16 <refpurpose>opens a persistent connection to a remote database</refpurpose> 16 <refpurpose>ouvre une connexion persistante vers une base de données 17 distante</refpurpose> 17 18 </refnamediv> 18 19 … … 25 26 26 27 <refsect1> 27 <title> Inputs</title>28 <title>Arguments</title> 28 29 29 30 <refsect2> 30 31 <title>connname</title> 31 32 <para> 32 if 2 arguments ar given, the first is used as a name for a persistent33 conne ction33 Si deux arguments sont donnés, le premier est utilisé comme nom pour la 34 connexion persistante. 34 35 </para> 35 36 </refsect2> … … 38 39 <title>connstr</title> 39 40 <para> 40 standard libpq format connection string,41 e.g. "hostaddr=127.0.0.1 port=5432 dbname=mydb user=postgres password=mypasswd"42 </para> 43 <para> 44 if only one argument is given, the connection is unnamed; only one unnamed45 connection can exist at a time46 </para> 47 </refsect2> 48 </refsect1> 49 50 <refsect1> 51 <title> Outputs</title>52 <para>Re turns status= "OK"</para>53 </refsect1> 54 55 <refsect1> 56 <title>Ex ample</title>41 Chaîne de connexion au format standard de la libpq, par exemple 42 <literal>hostaddr=127.0.0.1 port=5432 dbname=mabase user=postgres password=monmotdepasse</literal> 43 </para> 44 <para> 45 Si un seul argument est donné, la connexion n'a pas de nom. Attention, 46 seule une connexion sans nom peut exister à un instant t. 47 </para> 48 </refsect2> 49 </refsect1> 50 51 <refsect1> 52 <title>Valeur de retour</title> 53 <para>Renvoie le statut = "OK"</para> 54 </refsect1> 55 56 <refsect1> 57 <title>Exemple</title> 57 58 <programlisting> 58 59 select dblink_connect('dbname=postgres'); … … 74 75 <refnamediv> 75 76 <refname>dblink_disconnect</refname> 76 <refpurpose>closes a persistent connection to a remote database</refpurpose> 77 <refpurpose>ferme une connexion persistante vers une base de données 78 distantes</refpurpose> 77 79 </refnamediv> 78 80 … … 85 87 86 88 <refsect1> 87 <title> Inputs</title>89 <title>Arguments</title> 88 90 89 91 <refsect2> 90 92 <title>connname</title> 91 93 <para> 92 if an argument is given, it is used as a name for a persistent93 connection to close; otherwiase the unnamed connection is closed94 </para> 95 </refsect2> 96 </refsect1> 97 98 <refsect1> 99 <title> Outputs</title>100 <para>Re turns status= "OK"</para>101 </refsect1> 102 103 <refsect1> 104 <title>Ex ample</title>94 Si un argument est donné, il est utilisé comme nom de la connexion 95 persistante à fermer ; sinon la connexion sans nom est fermée. 96 </para> 97 </refsect2> 98 </refsect1> 99 100 <refsect1> 101 <title>Valeur de retour</title> 102 <para>Renvoie le statut = "OK"</para> 103 </refsect1> 104 105 <refsect1> 106 <title>Exemple</title> 105 107 <programlisting> 106 108 test=# select dblink_disconnect(); … … 122 124 <refnamediv> 123 125 <refname>dblink_open</refname> 124 <refpurpose>o pens a cursor on a remote database</refpurpose>126 <refpurpose>ouvre un curseur vers une base de données distante</refpurpose> 125 127 </refnamediv> 126 128 … … 133 135 134 136 <refsect1> 135 <title> Inputs</title>137 <title>Argument</title> 136 138 137 139 <refsect2> 138 140 <title>connname</title> 139 141 <para> 140 if three arguments are present, the first is taken as the specific141 conne ction name to use; otherwise the unnamed connection is assumed142 Si trois arguments sont présents, le premier est utilisé comme nom de la 143 connexion ; sinon, la connexion sans nom est utilisée. 142 144 </para> 143 145 </refsect2> … … 146 148 <title>cursorname</title> 147 149 <para> 148 a reference name for the cursor150 Un nom de référence pour le curseur. 149 151 </para> 150 152 </refsect2> … … 153 155 <title>sql</title> 154 156 <para> 155 sql statement that you wish to execute on the remote host156 e.g. "select * from pg_class"157 L'instruction SQL à exécuter sur l'hÃŽte distant, par exemple 158 <literal>select * from pg_class</literal> 157 159 </para> 158 160 </refsect2> … … 161 163 <title>fail_on_error</title> 162 164 <para> 163 If true (default when not present) then an ERROR thrown on the remote side 164 of the connection causes an ERROR to also be thrown locally. If false, the 165 remote ERROR is locally treated as a NOTICE, and the return value is set 166 to 'ERROR'. 167 </para> 168 </refsect2> 169 </refsect1> 170 171 <refsect1> 172 <title>Outputs</title> 173 <para>Returns status = "OK"</para> 165 Si true (la valeur par défaut si elle n'est pas précisée), un message 166 de type ERROR sur la base distante cause l'envoi d'un message de type 167 ERROR en local. Dans le cas contraire, le message distant de type ERROR 168 est traité localement comme un NOTICE, et la valeur renvoyée est 169 'ERROR'. 170 </para> 171 </refsect2> 172 </refsect1> 173 174 <refsect1> 175 <title>Valeur de retour</title> 176 <para>Renvoie le statut = "OK"</para> 174 177 </refsect1> 175 178 … … 179 182 <listitem> 180 183 <para> 181 dblink_connect(text connstr) must be executed first184 dblink_connect(text connstr) doit d'abord être exécuté. 182 185 </para> 183 186 </listitem> 184 187 <listitem> 185 188 <para> 186 dblink_open starts an explicit transaction. If, after using dblink_open, 187 you use dblink_exec to change data, and then an error occurs or you use 188 dblink_disconnect without a dblink_close first, your change *will* be 189 lost. Also, using dblink_close explicitly ends the transaction and thus 190 effectively closes *all* open cursors. 189 dblink_open lance une transaction explicite. Si, aprÚs avoir utilisé 190 dblink_open, vous utilisez dblink_exec pour modifier les données et 191 qu'une erreur survient ou que vous utilisez dblink_disconnect sans 192 avoir utilisé précédemment dblink_close, vos modifications seront 193 perdues. De plus, utiliser dblink_close explicitement termine la 194 transaction et, du coup, ferme en fait tous les curseurs ouverts. 191 195 </para> 192 196 </listitem> … … 195 199 </refsect1> 196 200 <refsect1> 197 <title>Ex ample</title>201 <title>Exemple</title> 198 202 <programlisting> 199 203 test=# select dblink_connect('dbname=postgres'); … … 215 219 <refnamediv> 216 220 <refname>dblink_fetch</refname> 217 <refpurpose>returns a set from an open cursor on a remote database</refpurpose> 221 <refpurpose>renvoie un ensemble à partir d'un curseur ouvert sur une 222 base de données distante</refpurpose> 218 223 </refnamediv> 219 224 … … 226 231 227 232 <refsect1> 228 <title> Inputs</title>233 <title>Arguments</title> 229 234 230 235 <refsect2> 231 236 <title>connname</title> 232 237 <para> 233 if three arguments are present, the first is taken as the specific234 connection name to use; otherwise the unnamed connection is assumed238 Si trois arguments sont présents, le premier est utilisé comme nom de 239 la connexion ; sinon la connexion sans nom est utilisée. 235 240 </para> 236 241 </refsect2> … … 239 244 <title>cursorname</title> 240 245 <para> 241 The reference name for the cursor246 Le nom de référence pour le curseur 242 247 </para> 243 248 </refsect2> … … 246 251 <title>howmany</title> 247 252 <para> 248 Maximum number of rows to retrieve. The next howmany rows are fetched,249 starting at the current cursor position, moving forward. Once the cursor250 has positioned to the end, no more rows are produced.253 Nombre maximum de lignes à récupérer. Les howmany lignes suivantes sont 254 récupérées, en commençant à la position actuelle du curseur, vers l'avant. 255 Une fois le curseur positionné à la fin, aucune ligne ne sera renvoyée. 251 256 </para> 252 257 </refsect2> … … 255 260 <title>fail_on_error</title> 256 261 <para> 257 If true (default when not present) then an ERROR thrown on the remote side 258 of the connection causes an ERROR to also be thrown locally. If false, the 259 remote ERROR is locally treated as a NOTICE, and no rows are returned. 260 </para> 261 </refsect2> 262 </refsect1> 263 264 <refsect1> 265 <title>Outputs</title> 266 <para>Returns setof record</para> 262 Si true (la valeur par défaut si elle n'est pas précisée), un message 263 de type ERROR sur la base distante cause l'envoi d'un message de type 264 ERROR en local. Dans le cas contraire, le message distant de type ERROR 265 est traité localement comme un NOTICE, et la valeur renvoyée est 266 'ERROR'. 267 </para> 268 </refsect2> 269 </refsect1> 270 271 <refsect1> 272 <title>Valeur de retour</title> 273 <para>Renvoie setof record</para> 267 274 </refsect1> 268 275 … … 270 277 <title>Note</title> 271 278 <para> 272 On a mismatch between the number of return fields as specified in the FROM273 clause, and the actual number of fields returned by the remote cursor, an274 ERROR will be thrown. In this event, the remote cursor is still advanced275 by as many rows as it would have been if the ERROR had not occurred.279 Si le nombre de champs spécifiés dans la clause FROM et celui renvoyés 280 par le curseur distant ne correspondent pas, un message de type ERROR 281 est envoyé. Dans ce cas, le curseur distant est bien avancé du nombre 282 de lignes demandés. 276 283 </para> 277 284 </refsect1> 278 285 279 286 <refsect1> 280 <title>Ex ample</title>287 <title>Exemple</title> 281 288 <programlisting> 282 289 test=# select dblink_connect('dbname=postgres'); … … 330 337 <refnamediv> 331 338 <refname>dblink_close</refname> 332 <refpurpose> closes a cursor on a remote database</refpurpose>339 <refpurpose>ferme un curseur sur une base de données distante</refpurpose> 333 340 </refnamediv> 334 341 … … 341 348 342 349 <refsect1> 343 <title> Inputs</title>350 <title>Arguments</title> 344 351 345 352 <refsect2> 346 353 <title>connname</title> 347 354 <para> 348 if two arguments are present, the first is taken as the specific349 conne ction name to use; otherwise the unnamed connection is assumed355 Si deux arguments sont présents, le premier est utilisé pour le nom de 356 connexion ; sinon la connexion sans nom est utilisée. 350 357 </para> 351 358 </refsect2> … … 354 361 <title>cursorname</title> 355 362 <para> 356 a reference name for the cursor363 Le nom de référence pour le curseur. 357 364 </para> 358 365 </refsect2> … … 361 368 <title>fail_on_error</title> 362 369 <para> 363 If true (default when not present) then an ERROR thrown on the remote side 364 of the connection causes an ERROR to also be thrown locally. If false, the 365 remote ERROR is locally treated as a NOTICE, and the return value is set 366 to 'ERROR'. 367 </para> 368 </refsect2> 369 </refsect1> 370 371 <refsect1> 372 <title>Outputs</title> 373 <para>Returns status = "OK"</para> 370 Si true (la valeur par défaut si elle n'est pas précisée), un message 371 de type ERROR sur la base distante cause l'envoi d'un message de type 372 ERROR en local. Dans le cas contraire, le message distant de type ERROR 373 est traité localement comme un NOTICE, et la valeur renvoyée est 374 'ERROR'. 375 </para> 376 </refsect2> 377 </refsect1> 378 379 <refsect1> 380 <title>Valeur de retour</title> 381 <para>Renvoie le statut = "OK"</para> 374 382 </refsect1> 375 383 … … 377 385 <title>Note</title> 378 386 <para> 379 dblink_connect(text connstr) o rdblink_connect(text connname, text connstr)380 must be executed first.387 dblink_connect(text connstr) ou dblink_connect(text connname, text connstr) 388 doivent être exécutés en premier. 381 389 </para> 382 390 </refsect1> 383 391 384 392 <refsect1> 385 <title>Ex ample</title>393 <title>Exemple</title> 386 394 <programlisting> 387 395 test=# select dblink_connect('dbname=postgres'); … … 427 435 <refnamediv> 428 436 <refname>dblink_exec</refname> 429 <refpurpose>executes an UPDATE/INSERT/DELETE on a remote database</refpurpose> 437 <refpurpose>exécute un UPDATE/INSERT/DELETE sur une base de données 438 distante</refpurpose> 430 439 </refnamediv> 431 440 … … 439 448 440 449 <refsect1> 441 <title> Inputs</title>450 <title>Arguments</title> 442 451 443 452 <refsect2> 444 453 <title>connname/connstr</title> 445 454 <para> 446 If two arguments are present, the first is first assumed to be a specific447 conne ction name to use. If the name is not found, the argument is then448 assumed to be a valid connection string, of standard libpq format,449 e.g.: "hostaddr=127.0.0.1 dbname=mydb user=postgres password=mypasswd"450 451 If only one argument is used, then the unnamed connection is used.455 Si deux arguments sont présents, le premier est utilisé comme nom de 456 connexion. Si le nom n'est pas trouvé, l'argument est pris pour une 457 chaîne de connexion au format standard de libpq, par exemple 458 <literal>hostaddr=127.0.0.1 dbname=mabase user=postgres password=monmotdepasse</literal> 459 Si un seul argument est utilisé, alors la connexion sans nom est prise 460 en compte. 452 461 </para> 453 462 </refsect2> … … 456 465 <title>sql</title> 457 466 <para> 458 sql statement that you wish to execute on the remote host, e.g.:459 insert into foo values(0,'a','{"a0","b0","c0"}');467 Une instruction SQL que vous souhaitez exécuter sur l'hÃŽte distant, par 468 exemple : insert into foo values(0,'a','{"a0","b0","c0"}'); 460 469 </para> 461 470 </refsect2> … … 463 472 <title>fail_on_error</title> 464 473 <para> 465 If true (default when not present) then an ERROR thrown on the remote side 466 of the connection causes an ERROR to also be thrown locally. If false, the 467 remote ERROR is locally treated as a NOTICE, and the return value is set 468 to 'ERROR'. 469 </para> 470 </refsect2> 471 </refsect1> 472 473 <refsect1> 474 <title>Outputs</title> 475 <para>Returns status of the command, or 'ERROR' if the command failed.</para> 474 Si true (la valeur par défaut si elle n'est pas précisée), un message 475 de type ERROR sur la base distante cause l'envoi d'un message de type 476 ERROR en local. Dans le cas contraire, le message distant de type ERROR 477 est traité localement comme un NOTICE, et la valeur renvoyée est 478 'ERROR'. 479 </para> 480 </refsect2> 481 </refsect1> 482 483 <refsect1> 484 <title>Valeur de retour</title> 485 <para>Renvoie le statut de la commande ou 'ERROR' en cas d'échec.</para> 476 486 </refsect1> 477 487 … … 479 489 <title>Notes</title> 480 490 <para> 481 dblink_open starts an explicit transaction. If, after using dblink_open,482 you use dblink_exec to change data, and then an error occurs or you use483 dblink_disconnect without a dblink_close first, your change *will* be484 lost.491 dblink_open lance une transaction explicite. Si, aprÚs avoir utilisé 492 dblink_open, vous utilisez dblink_exec pour modifier vos données et qu'une 493 erreur survient ou que vous utilisez dblink_disconnect sans utiliser 494 dblink_close en premier, vos modifications seront perdues. 485 495 </para> 486 496 </refsect1> 487 497 488 498 <refsect1> 489 <title>Ex ample</title>499 <title>Exemple</title> 490 500 <programlisting> 491 501 select dblink_connect('dbname=dblink_test_slave'); … … 528 538 <refnamediv> 529 539 <refname>dblink_current_query</refname> 530 <refpurpose>re turns the current query string</refpurpose>540 <refpurpose>renvoie la requête en cours</refpurpose> 531 541 </refnamediv> 532 542 … … 538 548 539 549 <refsect1> 540 <title> Inputs</title>541 542 <refsect2> 543 <title> None</title>544 <para> 545 </para> 546 </refsect2> 547 </refsect1> 548 549 <refsect1> 550 <title> Outputs</title>551 <para>Re turns test -- a copy of the currenty executing query</para>552 </refsect1> 553 554 <refsect1> 555 <title>Ex ample</title>550 <title>Argument</title> 551 552 <refsect2> 553 <title>Aucun</title> 554 <para> 555 </para> 556 </refsect2> 557 </refsect1> 558 559 <refsect1> 560 <title>Valeur de retour</title> 561 <para>Renvoie test -- une copie de la requête en cours d'exécution</para> 562 </refsect1> 563 564 <refsect1> 565 <title>Exemple</title> 556 566 <programlisting> 557 567 test=# select dblink_current_query() from (select dblink('dbname=postgres','select oid, proname from pg_proc where proname = ''byteacat''') as f1) as t1; … … 567 577 <refnamediv> 568 578 <refname>dblink_get_pkey</refname> 569 <refpurpose>re turns the position and field names of a relation's570 primary key fields579 <refpurpose>renvoie la position et le nom des champs de clé primaire 580 d'une relation. 571 581 </refpurpose> 572 582 </refnamediv> … … 579 589 580 590 <refsect1> 581 <title> Inputs</title>591 <title>Arguments</title> 582 592 583 593 <refsect2> 584 594 <title>relname</title> 585 595 <para> 586 any relation name;587 e.g.'foobar'588 </para> 589 </refsect2> 590 </refsect1> 591 592 <refsect1> 593 <title> Outputs</title>596 tout nom de relation ; 597 par exemple 'foobar' 598 </para> 599 </refsect2> 600 </refsect1> 601 602 <refsect1> 603 <title>Valeur de retour</title> 594 604 <para> 595 Returns setof dblink_pkey_results -- one row for each primary key field, 596 in order of position in the key. dblink_pkey_results is defined as follows: 605 Renvoie un ensemble (setof) de dblink_pkey_results -- une ligne pour chaque 606 champ de la clé primaire, dans son ordre dans la clé. 607 dblink_pkey_results est défini ainsi : 597 608 CREATE TYPE dblink_pkey_results AS (position int4, colname text); 598 609 </para> … … 600 611 601 612 <refsect1> 602 <title>Ex ample</title>613 <title>Exemple</title> 603 614 <programlisting> 604 615 test=# select * from dblink_get_pkey('foobar'); … … 618 629 <refname>dblink_build_sql_insert</refname> 619 630 <refpurpose> 620 builds an insert statement using a local tuple, replacing the 621 selection key field values with alternate supplied values 631 construit une instruction d'insertion en utilisant une ligne locale, 632 remplaçant les valeurs des champs de la clé primaire pour la sélection 633 avec les valeurs fournies 622 634 </refpurpose> 623 635 </refnamediv> … … 634 646 635 647 <refsect1> 636 <title> Inputs</title>648 <title>Arguments</title> 637 649 638 650 <refsect2> 639 651 <title>relname</title> 640 652 <para> 641 any relation name;642 e.g. 'foobar';653 tout nom de relation ; 654 par exemple 'foobar' 643 655 </para> 644 656 </refsect2> … … 646 658 <title>primary_key_attnums</title> 647 659 <para> 648 vect or of primary key attnums (1 based, see pg_index.indkey);649 e.g.'1 2'660 vecteur de la clé primaire (commençant à 1, voir pg_index.indkey) ; 661 par exemple '1 2' 650 662 </para> 651 663 </refsect2> … … 653 665 <title>num_primary_key_atts</title> 654 666 <para> 655 number of primary key attnums in the vector; e.g. 2 667 nombre d'attributs de la clé primaire dans le vecteur ; par 668 exemple, 2 656 669 </para> 657 670 </refsect2> … … 659 672 <title>src_pk_att_vals_array</title> 660 673 <para> 661 array of primary key values, used to look up the local matching662 tuple, the values of which are then used to construct the SQL663 statement674 tableau des valeurs de la clé primaire, utilisé pour recherche la 675 ligne locale correspondante, valeurs qui sont utilisées pour construire 676 l'instruction SQL 664 677 </para> 665 678 </refsect2> … … 667 680 <title>tgt_pk_att_vals_array</title> 668 681 <para> 669 array of primary key values, used to replace the local tuple670 values in the SQL statement671 </para> 672 </refsect2> 673 </refsect1> 674 675 <refsect1> 676 <title> Outputs</title>677 <para>Re turns text -- requested SQL statement</para>678 </refsect1> 679 680 <refsect1> 681 <title>Ex ample</title>682 tableau des valeurs de la clé primaire, utilisé pour remplacer les valeurs 683 de la ligne locale dans l'instruction SQL 684 </para> 685 </refsect2> 686 </refsect1> 687 688 <refsect1> 689 <title>Valeur de retour</title> 690 <para>Renvoie du texte -- l'instruction SQL demandée</para> 691 </refsect1> 692 693 <refsect1> 694 <title>Exemple</title> 682 695 <programlisting> 683 696 test=# select dblink_build_sql_insert('foo','1 2',2,'{"1", "a"}','{"1", "b''a"}'); … … 693 706 <refnamediv> 694 707 <refname>dblink_build_sql_delete</refname> 695 <refpurpose>builds a delete statement using supplied values for selection 696 key field values 708 <refpurpose> 709 construit une instruction de suppression en utilisant une ligne locale, 710 remplaçant les valeurs des champs de la clé primaire pour la sélection 711 avec les valeurs fournies 697 712 </refpurpose> 698 713 </refnamediv> … … 708 723 709 724 <refsect1> 710 <title> Inputs</title>725 <title>Arguments</title> 711 726 712 727 <refsect2> 713 728 <title>relname</title> 714 729 <para> 715 any relation name;716 e.g. 'foobar';730 tout nom de relation ; 731 par exemple 'foobar' 717 732 </para> 718 733 </refsect2> … … 720 735 <title>primary_key_attnums</title> 721 736 <para> 722 vect or of primary key attnums (1 based, see pg_index.indkey);723 e.g.'1 2'737 vecteur de la clé primaire (commençant à 1, voir pg_index.indkey) ; 738 par exemple '1 2' 724 739 </para> 725 740 </refsect2> … … 727 742 <title>num_primary_key_atts</title> 728 743 <para> 729 number of primary key attnums in the vector; e.g. 2 744 nombre d'attributs de la clé primaire dans le vecteur ; par 745 exemple, 2 730 746 </para> 731 747 </refsect2> … … 733 749 <title>src_pk_att_vals_array</title> 734 750 <para> 735 array of primary key values, used to look up the local matching736 tuple, the values of which are then used to construct the SQL737 statement751 tableau des valeurs de la clé primaire, utilisé pour recherche la 752 ligne locale correspondante, valeurs qui sont utilisées pour construire 753 l'instruction SQL 738 754 </para> 739 755 </refsect2> … … 741 757 <title>tgt_pk_att_vals_array</title> 742 758 <para> 743 array of primary key values, used to replace the local tuple744 values in the SQL statement745 </para> 746 </refsect2> 747 </refsect1> 748 749 <refsect1> 750 <title> Outputs</title>751 <para>Re turns text -- requested SQL statement</para>752 </refsect1> 753 754 <refsect1> 755 <title>Ex ample</title>759 tableau des valeurs de la clé primaire, utilisé pour remplacer les valeurs 760 de la ligne locale dans l'instruction SQL 761 </para> 762 </refsect2> 763 </refsect1> 764 765 <refsect1> 766 <title>Valeur de retour</title> 767 <para>Renvoie du texte -- l'instruction SQL demandée</para> 768 </refsect1> 769 770 <refsect1> 771 <title>Exemple</title> 756 772 <programlisting> 757 773 test=# select dblink_build_sql_delete('MyFoo','1 2',2,'{"1", "b"}'); … … 767 783 <refnamediv> 768 784 <refname>dblink_build_sql_update</refname> 769 <refpurpose>builds an update statement using a local tuple, replacing 770 the selection key field values with alternate supplied values 785 <refpurpose> 786 construit une instruction de mise à jour en utilisant une ligne locale, 787 remplaçant les valeurs des champs de la clé primaire pour la sélection 788 avec les valeurs fournies 771 789 </refpurpose> 772 790 </refnamediv> … … 783 801 784 802 <refsect1> 785 <title> Inputs</title>803 <title>Arguments</title> 786 804 787 805 <refsect2> 788 806 <title>relname</title> 789 807 <para> 790 any relation name;791 e.g. 'foobar';808 tout nom de relation ; 809 par exemple 'foobar' 792 810 </para> 793 811 </refsect2> … … 795 813 <title>primary_key_attnums</title> 796 814 <para> 797 vect or of primary key attnums (1 based, see pg_index.indkey);798 e.g.'1 2'815 vecteur de la clé primaire (commençant à 1, voir pg_index.indkey) ; 816 par exemple '1 2' 799 817 </para> 800 818 </refsect2> … … 802 820 <title>num_primary_key_atts</title> 803 821 <para> 804 number of primary key attnums in the vector; e.g. 2 822 nombre d'attributs de la clé primaire dans le vecteur ; par 823 exemple, 2 805 824 </para> 806 825 </refsect2> … … 808 827 <title>src_pk_att_vals_array</title> 809 828 <para> 810 array of primary key values, used to look up the local matching811 tuple, the values of which are then used to construct the SQL812 statement829 tableau des valeurs de la clé primaire, utilisé pour recherche la 830 ligne locale correspondante, valeurs qui sont utilisées pour construire 831 l'instruction SQL 813 832 </para> 814 833 </refsect2> … … 816 835 <title>tgt_pk_att_vals_array</title> 817 836 <para> 818 array of primary key values, used to replace the local tuple819 values in the SQL statement820 </para> 821 </refsect2> 822 </refsect1> 823 824 <refsect1> 825 <title> Outputs</title>826 <para>Re turns text -- requested SQL statement</para>827 </refsect1> 828 829 <refsect1> 830 <title>Ex ample</title>837 tableau des valeurs de la clé primaire, utilisé pour remplacer les valeurs 838 de la ligne locale dans l'instruction SQL 839 </para> 840 </refsect2> 841 </refsect1> 842 843 <refsect1> 844 <title>Valeur de retour</title> 845 <para>Renvoie du texte -- l'instruction SQL demandée</para> 846 </refsect1> 847 848 <refsect1> 849 <title>Exemple</title> 831 850 <programlisting> 832 851 test=# select dblink_build_sql_update('foo','1 2',2,'{"1", "a"}','{"1", "b"}'); … … 842 861 <refnamediv> 843 862 <refname>dblink_get_connections</refname> 844 <refpurpose>returns a text array of all active named dblink connections</refpurpose> 863 <refpurpose>renvoie un tableau de type texte de toutes les connexions 864 nommées et actives de dblink 865 </refpurpose> 845 866 </refnamediv> 846 867 … … 852 873 853 874 <refsect1> 854 <title> Inputs</title>855 856 <refsect2> 857 <title> none</title>875 <title>Arguments</title> 876 877 <refsect2> 878 <title>Aucun</title> 858 879 <para></para> 859 880 </refsect2> … … 861 882 862 883 <refsect1> 863 <title>Outputs</title> 864 <para>Returns text array of all active named dblink connections</para> 865 </refsect1> 866 867 <refsect1> 868 <title>Example</title> 884 <title>Valeur de retour</title> 885 <para>Renvoie un tableau de texte de toutes les connexions nommées et 886 actives de dblink</para> 887 </refsect1> 888 889 <refsect1> 890 <title>Exemple</title> 869 891 <programlisting> 870 892 SELECT dblink_get_connections(); … … 876 898 <refnamediv> 877 899 <refname>dblink_is_busy</refname> 878 <refpurpose>checks to see if named connection is busy with an async query</refpurpose> 900 <refpurpose>vérifie si la connexion nommée est occupée avec une requête 901 asynchrone</refpurpose> 879 902 </refnamediv> 880 903 … … 886 909 887 910 <refsect1> 888 <title> Inputs</title>911 <title>Arguments</title> 889 912 890 913 <refsect2> 891 914 <title>connname</title> 892 915 <para> 893 The specific connection name to use894 </para> 895 </refsect2> 896 </refsect1> 897 898 <refsect1> 899 <title> Outputs</title>916 Le nom de la connexion à utiliser. 917 </para> 918 </refsect2> 919 </refsect1> 920 921 <refsect1> 922 <title>Valeur de retour</title> 900 923 <para> 901 Re turns 1 if connection is busy, 0 if it is not busy.902 If this function returns 0, it is guaranteed that dblink_get_result903 will not block.924 Renvoie 1 si la connexion est occupée, 0 dans le cas contraire. 925 Si cette fonction renvoie 0, il est garanti que dblink_get_result ne 926 bloquera pas. 904 927 </para> 905 928 </refsect1> 906 929 907 930 <refsect1> 908 <title>Ex ample</title>931 <title>Exemple</title> 909 932 <programlisting> 910 933 SELECT dblink_is_busy('dtest1'); … … 916 939 <refnamediv> 917 940 <refname>dblink_cancel_query</refname> 918 <refpurpose>cancels any active query on the named connection</refpurpose> 941 <refpurpose>annule toute requête en cours d'exécution sur la connexion 942 nommée</refpurpose> 919 943 </refnamediv> 920 944 … … 926 950 927 951 <refsect1> 928 <title> Inputs</title>952 <title>Arguments</title> 929 953 930 954 <refsect2> 931 955 <title>connname</title> 932 956 <para> 933 The specific connection name to use.934 </para> 935 </refsect2> 936 </refsect1> 937 938 <refsect1> 939 <title> Outputs</title>957 Le nom de la connexion à utiliser. 958 </para> 959 </refsect2> 960 </refsect1> 961 962 <refsect1> 963 <title>Valeur de retour</title> 940 964 <para> 941 Re turns "OK" on success, or an error message on failure.965 Renvoie "OK" en cas de succÚs, un message d'erreur en cas d'échec. 942 966 </para> 943 967 </refsect1> 944 968 945 969 <refsect1> 946 <title>Ex ample</title>970 <title>Exemple</title> 947 971 <programlisting> 948 972 SELECT dblink_cancel_query('dtest1'); … … 954 978 <refnamediv> 955 979 <refname>dblink_error_message</refname> 956 <refpurpose>gets last error message on the named connection</refpurpose> 980 <refpurpose>récupÚre le dernier message d'erreur sur la connexion 981 nommée</refpurpose> 957 982 </refnamediv> 958 983 … … 964 989 965 990 <refsect1> 966 <title> Inputs</title>991 <title>Arguments</title> 967 992 968 993 <refsect2> 969 994 <title>connname</title> 970 995 <para> 971 The specific connection name to use.972 </para> 973 </refsect2> 974 </refsect1> 975 976 <refsect1> 977 <title> Outputs</title>996 Le nom de la connexion à utiliser. 997 </para> 998 </refsect2> 999 </refsect1> 1000 1001 <refsect1> 1002 <title>Valeur de retour</title> 978 1003 <para> 979 Re turns last error message.1004 Renvoie le dernier message d'erreur. 980 1005 </para> 981 1006 </refsect1> 982 1007 983 1008 <refsect1> 984 <title>Ex ample</title>1009 <title>Exemple</title> 985 1010 <programlisting> 986 1011 SELECT dblink_error_message('dtest1'); … … 992 1017 <refnamediv> 993 1018 <refname>dblink</refname> 994 <refpurpose>returns a set from a remote database</refpurpose> 1019 <refpurpose>renvoie un ensemble à partir d'une base de données 1020 distante</refpurpose> 995 1021 </refnamediv> 996 1022 … … 1004 1030 1005 1031 <refsect1> 1006 <title> Inputs</title>1032 <title>Arguments</title> 1007 1033 1008 1034 <refsect2> 1009 1035 <title>connname/connstr</title> 1010 1036 <para> 1011 If two arguments are present, the first is first assumed to be a specific1012 conne ction name to use. If the name is not found, the argument is then1013 assumed to be a valid connection string, of standard libpq format,1014 e.g.: "hostaddr=127.0.0.1 dbname=mydb user=postgres password=mypasswd"1015 1016 If only one argument is used, then the unnamed connection is used.1037 Si deux arguments sont présents, le premier est utilisé comme nom de 1038 connexion. Si le nom n'est pas trouvé, l'argument est pris pour une 1039 chaîne de connexion au format standard de libpq, par exemple 1040 <literal>hostaddr=127.0.0.1 dbname=mabase user=postgres password=monmotdepasse</literal> 1041 &

