Changeset 1088
- Timestamp:
- 07/04/08 10:09:40 (5 months ago)
- Files:
-
- traduc/trunk/postgresql/dblink.xml (modified) (63 diffs)
- traduc/trunk/postgresql/dict-int.xml (modified) (5 diffs)
- traduc/trunk/postgresql/dict-xsyn.xml (modified) (8 diffs)
- traduc/trunk/postgresql/diskusage.xml (modified) (4 diffs)
- traduc/trunk/postgresql/dml.xml (modified) (2 diffs)
Legend:
- Unmodified
- Added
- Removed
- Modified
- Copied
- Moved
traduc/trunk/postgresql/dblink.xml
r1080 r1088 261 261 </para> 262 262 263 <!-- ICI --> 264 <para> 265 Si deux arguments <type>text</type> sont présents, le premier est utilisé 266 comme nom d'une connexion persistante. Si cette connexion est trouvée, 267 la commande est exécutée sur cette connexion. Si elle n'est pas trouvée, 268 le premier argument est pris pour une chaîne de connexion comme 269 <function>dblink_connect</function>, et la connexion indiquée est 270 conservée uniquement pendant la durée d'exécution de cette commande. 263 <para> 264 Si deux arguments <type>text</type> sont présents, le premier est d'abord 265 considéré comme nom de connexion persistante ; si cette connexion 266 est trouvée, la commande est exécutée sur cette connexion. Dans le cas 267 contraire, le premier argument est considéré être une chaîne de connexion 268 comme dans le cas de <function>dblink_connect</function>, et la connexion 269 indiquée n'est conservée que pour la durée d'exécution de cette commande. 271 270 </para> 272 271 </refsect1> … … 280 279 <listitem> 281 280 <para> 282 Le nom à utiliser pour cette connexion ; omettez ce paramètre283 pour utiliser laconnexion sans nom.281 Le nom de la connexion à utiliser ; ce paramètre doit être omis 282 pour utiliser une connexion sans nom. 284 283 </para> 285 284 </listitem> … … 290 289 <listitem> 291 290 <para> 292 Une chaîne de connexion décrite précédemment pour291 Une chaîne de connexion similaire à celle décrite précédemment pour 293 292 <function>dblink_connect</function>. 294 293 </para> … … 310 309 <listitem> 311 310 <para> 312 Si true ( la valeur par défaut si elle n'est pas précisée), un message313 de type ERROR sur la base distante cause l'envoi d'un message de type314 ERROR en local. Dans le cas contraire, le message distant de type ERROR315 est traité localement comme un NOTICE, et aucune ligne n'est renvoyée.311 Si true (valeur par défaut en cas d'omission), une erreur distante 312 est reportée localement comme une erreur. Dans le cas contraire, un 313 message d'erreur distant est traité localement comme un message de type 314 NOTICE, et la fonction ne retourne aucune ligne. 316 315 </para> 317 316 </listitem> … … 326 325 La fonction renvoie les lignes produites par la requête. Comme 327 326 <function>dblink</function> peut être utilisée avec toute requête, elle 328 est déclarée comme renvoyant le type <type>record</type>, et ne spécifie 329 donc aucun ensemble particulier de colonnes. Ceci signifie que 330 l'ensemble des colonnes attendues doit être spécifié dans la 331 requête appelante — sinon 332 <productname>PostgreSQL</productname> ne sait pas 333 à quoi s'attendre. Voici un exemple : 327 est déclarée comme renvoyant le type <type>record</type>, plutôt que de 328 préciser un ensemble particulier de colonnes. Cela signifie que 329 l'ensemble des colonnes attendues doit être précisé dans la 330 requête appelante — sinon <productname>PostgreSQL</productname> 331 ne sait pas quoi attendre. Voici un exemple : 334 332 335 333 <programlisting> … … 341 339 342 340 La partie <quote>alias</quote> de la clause <literal>FROM</literal> doit 343 spécifier les noms et types des colonnes que la fonction va renvoyer.344 ( Spécifier les noms des colonnes dans un alias est en fait une syntaxe345 du standard SQL mais spécifier les types des colonnes est une extension346 <productname>PostgreSQL</productname>.) Ce cipermet au système de341 spécifier les noms et types des colonnes retournés par la fonction. 342 (La précision des noms des colonnes dans un alias est une syntaxe 343 du standard SQL mais la précision des types des colonnes est une extension 344 <productname>PostgreSQL</productname>.) Cela permet au système de 347 345 savoir comment étendre <literal>*</literal>, et à quoi correspond 348 346 <structname>proname</structname> dans la clause 349 347 <literal>WHERE</literal> 350 348 avant de tenter l'exécution de la fonction. À l'exécution, une erreur 351 sera renvoyée si le résultat réel de la requête à partir de la base de352 données distante n'a pas le même nombre de colonnes que celui indiqué349 est renvoyée si le nombre de colonnes du résultat effectif de la requête 350 sur la base de données distante diffère de celui indiqué 353 351 dans la clause <literal>FROM</literal>. Les noms de colonnes n'ont pas 354 besoin de correspondre et <function>dblink</function> n'i nsiste pas355 sur une correspondance exacte des types. L'opération sera une réussite352 besoin de correspondre et <function>dblink</function> n'impose pas 353 une correspondance exacte des types. L'opération réussit 356 354 si les chaînes de données renvoyées sont valides pour le type déclaré 357 355 dans la clause <literal>FROM</literal>. … … 363 361 364 362 <para> 365 <function>dblink</function> récupère l es résultats complets de la366 requête avant de sles renvoyer au système local. Si la requête doit363 <function>dblink</function> récupère l'intégralité des résultats de la 364 requête avant de les renvoyer au système local. Si la requête doit 367 365 renvoyer un grand nombre de lignes, il est préférable d'ouvrir un 368 366 curseur avec <function>dblink_open</function> puis de récupérer un … … 371 369 372 370 <para> 373 Une façon agréable d'utiliser <function>dblink</function> avec des374 requêtes prédéterminées est de créer une vue. Ceci permet de stocker375 l'information sur les colonnes dans la vue, au lieu d'avoir à la saisir376 pour chaque requête. Par exemple :371 Il est souvent plus pratique de créer une vue pour utiliser 372 <function>dblink</function> avec des requêtes prédéterminées. 373 Cela permet de laisser la vue gérer le type de la colonne plutôt que 374 d'avoir à le saisir pour chaque requête. Par exemple : 377 375 378 376 <programlisting> … … 488 486 <para> 489 487 Quand deux arguments de type <type>text</type> sont fournis, le premier 490 est recherché comme nom d'une connexion persistante ; si cette488 est d'abord considéré comme nom d'une connexion persistante ; si cette 491 489 connexion est trouvée, la commande est exécutée sur cette connexion. Dans 492 490 le cas contraire, le premier argument est traitée comme une chaîne de 493 491 connexion pour <function>dblink_connect</function>, et la connexion 494 indiquée est maintenue uniquementpour la durée d'exécution de cette492 indiquée n'est maintenue que pour la durée d'exécution de cette 495 493 commande. 496 494 </para> … … 505 503 <listitem> 506 504 <para> 507 Nom de la connexion à utiliser ; omettez ce paramètre pour508 utiliser laconnexion sans nom.505 Le nom de la connexion à utiliser ; ce paramètre doit être omis 506 pour utiliser une connexion sans nom. 509 507 </para> 510 508 </listitem> … … 515 513 <listitem> 516 514 <para> 517 Une chaîne de connexion identique à celle décritepour518 <function>dblink_connect</function>.515 Une chaîne de connexion similaire à celle décrite précédemment pour 516 <function>dblink_connect</function>. 519 517 </para> 520 518 </listitem> … … 525 523 <listitem> 526 524 <para> 527 La commande SQL à exécuter dansla base de données525 La commande SQL à exécuter sur la base de données 528 526 distante ; par exemple 529 527 <literal>INSERT INTO foo VALUES(0,'a','{"a0","b0","c0"}')</literal>. … … 536 534 <listitem> 537 535 <para> 538 Si true ( la valeur par défaut si elle n'est pas précisée), un message539 de type ERROR sur la base distante cause l'envoi d'un message de type540 ERROR en local. Dans le cas contraire, le message distant de type ERROR541 est traité localement comme un NOTICE, et la valeur renvoyée est536 Si true (valeur par défaut en cas d'omission), une erreur distante 537 est reportée localement comme une erreur locale. Dans le cas contraire, un 538 message d'erreur distant est traité localement comme un message de type 539 NOTICE, et la valeur de retour de la fonction est positionné à 542 540 <literal>ERROR</literal>. 543 541 </para> … … 599 597 <refnamediv> 600 598 <refname>dblink_open</refname> 601 <refpurpose>ouvre un curseur versune base de données distante</refpurpose>599 <refpurpose>ouvre un curseur sur une base de données distante</refpurpose> 602 600 </refnamediv> 603 601 … … 613 611 614 612 <para> 615 <function>dblink_open()</function> ouvre un curseur versune base de613 <function>dblink_open()</function> ouvre un curseur sur une base de 616 614 données distante. Le curseur peut ensuite être manipulé avec 617 615 <function>dblink_fetch()</function> et … … 628 626 <listitem> 629 627 <para> 630 Nom de la connexion à utiliser ; omettez ce paramètre pour631 utiliser laconnexion sans nom.628 Le nom de la connexion à utiliser ; ce paramètre doit être omis 629 pour utiliser une connexion sans nom. 632 630 </para> 633 631 </listitem> … … 657 655 <listitem> 658 656 <para> 659 Si true ( la valeur par défaut si elle n'est pas précisée), un message660 de type ERROR sur la base distante cause l'envoi d'un message de type661 ERROR en local. Dans le cas contraire, le message distant de type ERROR662 est traité localement comme un NOTICE, et la valeur renvoyée est657 Si true (valeur par défaut en cas d'omission), une erreur distante 658 est reportée localement comme une erreur locale. Dans le cas contraire, un 659 message d'erreur distant est traité localement comme un message de type 660 NOTICE, et la valeur de retour de la fonction est positionné à 663 661 <literal>ERROR</literal>. 664 662 </para> … … 681 679 682 680 <para> 683 Comme un curseur peut seulement persister dansune transaction,681 Puisqu'un curseur ne peut persister qu'au sein d'une transaction, 684 682 <function>dblink_open</function> lance un bloc de transaction explicite 685 (<command>BEGIN</command>) du côté distant, si le côté distant n'était686 pas déjà à l'intérieur d'une transaction. Cette transaction sera de687 nouveau fermée quand l'instruction <function>dblink_close</function>688 est exécutée. Notez que si <function>dblink_exec</function> est utilisé683 (<command>BEGIN</command>) côté distant, si le côté distant n'est 684 pas déjà à l'intérieur d'une transaction. Cette transaction est refermée 685 à l'exécution de l'instruction <function>dblink_close</function>. 686 Si <function>dblink_exec</function> est utilisée 689 687 pour modifier les données entre <function>dblink_open</function> et 690 <function>dblink_close</function>, et qu' ensuiteune erreur survient ou688 <function>dblink_close</function>, et qu'une erreur survient ou 691 689 que <function>dblink_disconnect</function> est utilisé avant 692 <function>dblink_close</function>, vos modifications <emphasis>seront693 perdues</emphasis> car la transaction seraannulée.690 <function>dblink_close</function>, les modifications <emphasis>sont 691 perdues</emphasis> car la transaction est annulée. 694 692 </para> 695 693 </refsect1> … … 745 743 <listitem> 746 744 <para> 747 Nom de la connexion à utiliser ; omettez ce paramètrepour748 utiliser laconnexion sans nom.745 Nom de la connexion à utiliser ; ce paramètre doit être omis pour 746 utiliser une connexion sans nom. 749 747 </para> 750 748 </listitem> … … 767 765 <parameter>howmany</parameter> lignes suivantes sont récupérées, en 768 766 commençant à la position actuelle du curseur, vers l'avant. Une fois 769 le curseur positionné à la fin, aucune ligne supplémentaire ne sera767 le curseur arrivé à la fin, aucune ligne supplémentaire n'est 770 768 renvoyée. 771 769 </para> … … 777 775 <listitem> 778 776 <para> 779 Si true ( la valeur par défaut si elle n'est pas précisée), alors une780 e rreur sur la base distante cause l'envoie d'un rapport d'erreur en781 local. Si elle vaut false, l'erreur distante est rapportée localement782 comme un NOTICE et la fonction ne renvoie aucune ligne.777 Si true (valeur par défaut en cas d'omission), une erreur distante 778 est reportée localement comme une erreur locale. Dans le cas contraire, un 779 message d'erreur distant est traité localement comme un message de type 780 NOTICE, et la fonction ne retourne aucune ligne. 783 781 </para> 784 782 </listitem> … … 802 800 803 801 <para> 804 S 'il existe une différence entre le nombre de colonnes renvoyéesspécifiées dans802 Si le nombre de colonnes de retour spécifiées dans 805 803 la clause <literal>FROM</literal>, et le nombre réel de colonnes renvoyées 806 par le curseur distant , une erreur seraremontée. Dans ce cas, le curseur807 distant sera toujours avancé du nombre de lignes spécifiécomme si808 l'erreur n'avait pas eu lieu. Il en est de même pour 809 toute autre erreursurvenant dans la requête locale après l'exécution804 par le curseur distant diffèrent, une erreur est remontée. Dans ce cas, le curseur 805 distant est tout de même avancé du nombre de lignes indiqué, comme si 806 l'erreur n'avait pas eu lieu. Il en est de même pour toute autre erreur 807 survenant dans la requête locale après l'exécution 810 808 du <command>FETCH</command> distant. 811 809 </para> … … 893 891 <listitem> 894 892 <para> 895 Nom de la connexion à utiliser ; omettez ce paramètrepour896 utiliser laconnexion sans nom.893 Le nom de la connexion à utiliser ; ce paramètre doit être omis pour 894 utiliser une connexion sans nom. 897 895 </para> 898 896 </listitem> … … 903 901 <listitem> 904 902 <para> 905 Nom du curseur à fermer 903 Nom du curseur à fermer. 906 904 </para> 907 905 </listitem> … … 912 910 <listitem> 913 911 <para> 914 Si true ( la valeur par défaut si elle n'est pas précisée), un message915 de type ERROR sur la base distante cause l'envoi d'un message de type916 ERROR en local. Dans le cas contraire, le message distant de type ERROR917 est traité localement comme un NOTICE, et la valeur renvoyée est912 Si true (valeur par défaut en cas d'omission), une erreur distante 913 est reportée localement comme une erreur. Dans le cas contraire, un 914 message d'erreur distant est traité localement comme un message de type 915 NOTICE, et la valeur de retour est positionnée à 918 916 <literal>ERROR</literal>. 919 917 </para> … … 936 934 937 935 <para> 938 Si <function>dblink_open</function> a commencéun bloc de transaction939 explicite, et que c'est le dernier curseur ouv rant restant dans cette940 connexion, <function>dblink_close</function> exécute rale936 Si <function>dblink_open</function> a ouvert un bloc de transaction 937 explicite, et que c'est le dernier curseur ouvert restant dans cette 938 connexion, <function>dblink_close</function> exécute le 941 939 <command>COMMIT</command> correspondant. 942 940 </para> … … 986 984 <para> 987 985 <function>dblink_get_connections</function> renvoie un tableau contenant 988 le nom de toutes les connexions nommées etouvertes de986 le nom de toutes les connexions nommées ouvertes de 989 987 <filename>dblink</filename>. 990 988 </para> … … 994 992 <title>Valeur de retour</title> 995 993 996 <para>Renvoie un tableau de texte des noms des connexion, ou NULL s'il n'y997 en a spas.</para>994 <para>Renvoie un tableau texte des noms des connexions, ou NULL s'il n'y 995 en a pas.</para> 998 996 </refsect1> 999 997 … … 1025 1023 <para> 1026 1024 <function>dblink_error_message</function> récupère le dernier message 1027 d'erreur sur la connexion nommée.1025 d'erreur sur une connexion donnée. 1028 1026 </para> 1029 1027 </refsect1> … … 1037 1035 <listitem> 1038 1036 <para> 1039 Nom de la connexion .1037 Nom de la connexion à utiliser. 1040 1038 </para> 1041 1039 </listitem> … … 1081 1079 <function>dblink_send_query</function> envoie une requête à exécuter 1082 1080 de façon asynchrone, c'est-à-dire sans attendre immédiatement le résultat. 1083 Il ne doit pas y avoir une requête asynchrone déjàen exécution sur la1081 Il ne doit pas déjà exister de requête asynchrone en exécution sur la 1084 1082 connexion. 1085 1083 </para> … … 1103 1101 <listitem> 1104 1102 <para> 1105 Nom de la connexion à utiliser.1103 Le nom de la connexion à utiliser. 1106 1104 </para> 1107 1105 </listitem> … … 1167 1165 <listitem> 1168 1166 <para> 1169 Nom de la connexion à vérifier1167 Le nom de la connexion à vérifier. 1170 1168 </para> 1171 1169 </listitem> … … 1180 1178 Renvoie 1 si la connexion est occupée, 0 dans le cas contraire. 1181 1179 Si cette fonction renvoie 0, il est garanti que l'appel à 1182 <function>dblink_get_result</function> sera pas bloquant.1180 <function>dblink_get_result</function> ne bloque pas. 1183 1181 </para> 1184 1182 </refsect1> … … 1211 1209 <function>dblink_get_result</function> récupère le résultat d'une 1212 1210 requête asynchrone précédemment envoyée avec 1213 <function>dblink_send_query</function>. Si la requête n'est pas déjà 1214 terminée, <function>dblink_get_result</function> attendra jusqu'à ce que 1215 ce soit le cas. 1211 <function>dblink_send_query</function>. Si la requête n'est pas 1212 terminée, <function>dblink_get_result</function> en attend la fin. 1216 1213 </para> 1217 1214 </refsect1> … … 1225 1222 <listitem> 1226 1223 <para> 1227 Nom de la connexion à utiliser1224 Le nom de la connexion à utiliser. 1228 1225 </para> 1229 1226 </listitem> … … 1234 1231 <listitem> 1235 1232 <para> 1236 Si true ( la valeur par défaut si elle n'est pas précisée), un message1237 de type ERROR sur la base distante cause l'envoi d'un message de type1238 ERROR en local. Dans le cas contraire, le message distant de type ERROR1239 est traité localement comme un NOTICE, et aucune ligne n'est renvoyée.1233 Si true (valeur par défaut en cas d'omission), une erreur distante 1234 est reportée localement comme une erreur locale. Dans le cas contraire, un 1235 message d'erreur distant est traité localement comme un message de type 1236 NOTICE, et la fonction ne retourne aucune ligne. 1240 1237 </para> 1241 1238 </listitem> … … 1247 1244 <title>Valeur de retour</title> 1248 1245 1249 <para> 1250 Pour une requête asynchrone (c'est-à-dire une requête SQL renvoyant des 1246 <!-- statement : instruction --> 1247 <para> 1248 Pour une requête asynchrone (c'est-à-dire une instruction SQL renvoyant des 1251 1249 lignes), la fonction renvoie les lignes produites par la requête. Pour 1252 utiliser cette fonction, l'ensemble des colonnes1253 attendues doit être spécifiécomme indiqué pour <function>dblink</function>.1254 </para> 1255 1256 <para> 1257 Pour une commande asynchrone (c'est-à-dire une requêteSQL ne renvoyant aucune1250 utiliser cette fonction, il faut spécifier l'ensemble des colonnes 1251 attendues, comme indiqué pour <function>dblink</function>. 1252 </para> 1253 1254 <para> 1255 Pour une commande asynchrone (c'est-à-dire une instruction SQL ne renvoyant aucune 1258 1256 ligne), la fonction renvoie une seule ligne avec une colonne texte 1259 contenant la chaîne de statut de la commande. Il est nécessaire de1260 d'indiquer dans la requête que le résultat aura une colonne texte dans la clause1261 <literal>FROM</literal> appelante.1257 contenant la chaîne de statut de la commande. Il est impératif 1258 d'indiquer dans la clause <literal>FROM</literal> appelante que le résultat 1259 est constitué d'une unique colonne texte . 1262 1260 </para> 1263 1261 </refsect1> … … 1270 1268 <function>dblink_send_query</function> a renvoyé 1. Elle doit l'être 1271 1269 une fois pour chaque requête envoyée, et une fois de plus pour obtenir 1272 un ensemble vide avant de pouvoir utiliser denouveau la connexion.1270 un ensemble vide, avant de pouvoir utiliser à nouveau la connexion. 1273 1271 </para> 1274 1272 </refsect1> … … 1354 1352 <para> 1355 1353 <function>dblink_cancel_query</function> tente d'annuler toute requête 1356 en cours d'exécution sur la connexion nommée. Notez que la réussite de1357 la fonction n'est pas assurée ( car, par exemple, la requête distante1358 pourrait être déjà terminée). Une demande d'annulation améliore simplement1359 l es possibilités que la question échoue rapidement. Vous devez toujours1360 terminer le protocole de la requête, par exemple en appelant1354 en cours d'exécution sur la connexion nommée. La réussite de 1355 la fonction n'est pas assurée (la requête distante pourrait, par exemple, 1356 être déjà terminée). Une demande d'annulation augmente simplement 1357 la probabilité que la requête échoue rapidement. Le protocoel de requête 1358 normal doit toujours être terminé, par exemple en appelant 1361 1359 <function>dblink_get_result</function>. 1362 1360 </para> … … 1371 1369 <listitem> 1372 1370 <para> 1373 Nom de la connexion à utiliser.1371 Le nom de la connexion à utiliser. 1374 1372 </para> 1375 1373 </listitem> … … 1382 1380 1383 1381 <para> 1384 Renvoie <literal>OK</literal> si la demande d'annulation a bienété1382 Renvoie <literal>OK</literal> si la demande d'annulation a été 1385 1383 envoyée, ou le texte d'un message d'erreur en cas d'échec. 1386 1384 </para> … … 1413 1411 <para> 1414 1412 Renvoie la commande en cours d'exécution sur la session locale, ou 1415 NULL si ce n'est pas déterminable. Notez que cette fonction n'a pas1416 de relation avec d'autres fonctionnalités de <filename>dblink</filename>.1417 Elle est fournie car elles est parfois utile pour générerdes requêtes à1418 envoyerà des bases distantes.1413 NULL si elle ne peut être déterminée. Cette fonction n'est pas liée 1414 aux autres fonctionnalités de <filename>dblink</filename>. 1415 Elle est fournie car il est parfois utile de produire des requêtes à 1416 transmettre à des bases distantes. 1419 1417 </para> 1420 1418 </refsect1> … … 1458 1456 <para> 1459 1457 <function>dblink_get_pkey</function> fournit des informations sur la clé 1460 primaire d'une relation d ans la base de données locale. C'est parfois1461 utile d ans la génération de requêtes à envoyer surdes bases distantes.1458 primaire d'une relation de la base de données locale. Il est parfois 1459 utile de produire des requêtes à transmettre à des bases distantes. 1462 1460 </para> 1463 1461 </refsect1> … … 1471 1469 <listitem> 1472 1470 <para> 1473 Nom d'une relation existante, par exemple <literal>foo</literal> ou1474 <literal>monschema.matable</literal>. Ajoute zdes guillemets doubles1475 si le nom est en minuscule et en majuscule, ou contient des1471 Le nom d'une relation locale, par exemple <literal>foo</literal> ou 1472 <literal>monschema.matable</literal>. Ajouter des guillemets doubles 1473 si le nom a une casse mixte, ou contient des 1476 1474 caractères spéciaux, par exemple <literal>"FooBar"</literal> ; 1477 sans guillemets, la chaîne sera mise en minuscule.1475 sans guillemets, la chaîne est forcée en minuscule. 1478 1476 </para> 1479 1477 </listitem> … … 1482 1480 </refsect1> 1483 1481 1484 5H<refsect1>1482 <refsect1> 1485 1483 <title>Valeur de retour</title> 1486 1484 … … 1518 1516 <refname>dblink_build_sql_insert</refname> 1519 1517 <refpurpose> 1520 construit une instruction d'insertion en utilisant un e ligne locale,1521 remplaçant les valeurs des champs de la clé primaire pour la sélection1518 construit une instruction d'insertion en utilisant un tuple local, 1519 remplaçant les valeurs des champs de la clé primaire 1522 1520 avec les valeurs fournies 1523 1521 </refpurpose> … … 1540 1538 <function>dblink_build_sql_insert</function> peut être utile pour réaliser 1541 1539 une réplication sélective d'une table locale vers une base distante. 1542 Elle sélectionne une ligne de la table locale basée surla clé primaire1543 et construit une commande SQL <command>INSERT</command> qui duplique ra1544 cette ligne, mais avec les valeurs de clé primaire remplacées parles1545 valeursdu dernier argument. (Pour réaliser une copie exacte de la ligne,1546 i ndiquez simplementles mêmes valeurs pour les deux derniers arguments.)1540 Elle sélectionne une ligne de la table locale sur la base de la clé primaire 1541 et construit une commande SQL <command>INSERT</command> qui duplique 1542 cette ligne, mais avec pour valeurs de clé primaire celles 1543 du dernier argument. (Pour réaliser une copie exacte de la ligne, 1544 il suffit d'indiquer les mêmes valeurs pour les deux derniers arguments.) 1547 1545 </para> 1548 1546 </refsect1> … … 1556 1554 <listitem> 1557 1555 <para> 1558 Nom d'une relation existante, par exemple <literal>foo</literal> ou1559 <literal>monschema.matable</literal>. Ajoute zdes guillemets doubles1560 si le nom est en minuscule et en majuscule,ou contient des1556 Le nom d'une relation locale, par exemple <literal>foo</literal> ou 1557 <literal>monschema.matable</literal>. Ajouter des guillemets doubles 1558 si le nom est en casse mixte ou contient des 1561 1559 caractères spéciaux, par exemple <literal>"FooBar"</literal> ; 1562 sans guillemets, la chaîne sera mise en minuscule.1560 sans guillemets, la chaîne est forcée en minuscule. 1563 1561 </para> 1564 1562 </listitem> … … 1569 1567 <listitem> 1570 1568 <para> 1571 Numéros des attributs (commençant à 1) des champs de la clé primaire,1569 Les numéros des attributs (commençant à 1) des champs de la clé primaire, 1572 1570 par exemple <literal>1 2</literal>. 1573 1571 </para> … … 1579 1577 <listitem> 1580 1578 <para> 1581 Le nombre de champs de la clé primaire 1579 Le nombre de champs de la clé primaire. 1582 1580 </para> 1583 1581 </listitem> … … 1588 1586 <listitem> 1589 1587 <para> 1590 Les valeurs des champs de la clé primaire pour rechercher la ligne1591 l ocale. Chaque champ est représenté dans sa forme textuelle. Une1592 erreur est renvoyé s'il n'y a pas de lignes locales avec ces valeurs1588 Les valeurs des champs de la clé primaire à utiliser pour identifier 1589 le tuple local. Chaque champ est représenté dans sa forme textuelle. Une 1590 erreur est renvoyée s'il n'y a pas de lignes locales avec ces valeurs 1593 1591 de clé primaire. 1594 1592 </para> … … 1631 1629 <refnamediv> 1632 1630 <refname>dblink_build_sql_delete</refname> 1633 <refpurpose>construit une instruction de suppression en utilisant une ligne 1634 locale, en remplaçant les valeurs des champs de la clé primaire pour la 1635 sélection avec les valeurs fournies 1631 <refpurpose>construit une instruction de suppression en utilisant 1632 les valeurs fournies pour les champs de la clé primaire 1636 1633 </refpurpose> 1637 1634 </refnamediv> … … 1652 1649 <function>dblink_build_sql_delete</function> peut être utile pour réaliser 1653 1650 une réplication sélective d'une table locale vers une base distante. 1654 Elle construit une commande SQL <command>DELETE</command> qui supprime ra1655 la ligne avec les valeurs indiquées pour laclé primaire.1651 Elle construit une commande SQL <command>DELETE</command> qui supprime 1652 la ligne avec les valeurs indiquées de clé primaire. 1656 1653 </para> 1657 1654 </refsect1> … … 1665 1662 <listitem> 1666 1663 <para> 1667 Nom d'une relation existante, par exemple <literal>foo</literal> ou1668 <literal>monschema.matable</literal>. Ajoute zdes guillemets doubles1669 si le nom est en minuscule et en majuscule,ou contient des1664 Le nom d'une relation locale, par exemple <literal>foo</literal> ou 1665 <literal>monschema.matable</literal>. Ajouter des guillemets doubles 1666 si le nom est en casse mixte ou contient des 1670 1667 caractères spéciaux, par exemple <literal>"FooBar"</literal> ; 1671 sans guillemets, la chaîne sera mise en minuscule.1668 sans guillemets, la chaîne est forcée en minuscule. 1672 1669 </para> 1673 1670 </listitem> … … 1678 1675 <listitem> 1679 1676 <para> 1680 Numéros des attributs (commençant à 1) des champs de la clé primaire,1677 Les numéros des attributs (commençant à 1) des champs de la clé primaire, 1681 1678 par exemple <literal>1 2</literal>. 1682 1679 </para> … … 1688 1685 <listitem> 1689 1686 <para> 1690 Le nombre de champs de la clé primaire 1687 Le nombre de champs de la clé primaire. 1691 1688 </para> 1692 1689 </listitem> … … 1728 1725 <refnamediv> 1729 1726 <refname>dblink_build_sql_update</refname> 1730 <refpurpose>construit une instruction de mise à jour en utilisant une ligne1731 local e, en remplaçant les valeurs des champs de la clé primaire pour la1732 sélection avec les valeursfournies1727 <refpurpose>construit une instruction de mise à jour à partir d'un tuple 1728 local, en remplaçant les valeurs des champs de la clé primaire par celles 1729 fournies 1733 1730 </refpurpose> 1734 1731 </refnamediv> … … 1752 1749 distante. Elle sélectionne une ligne à partir de la table locale en se 1753 1750 basant sur la clé primaire, puis construit une commande SQL 1754 <command>UPDATE</command> qui duplique ra cette ligne, mais avec lesvaleurs1755 de clé primaire remplacées par les valeurs dans ledernier argument.1756 (Pour faire une copie exacte de la ligne, indiquezles mêmes valeurs1751 <command>UPDATE</command> qui duplique cette ligne, mais avec pour valeurs 1752 de clé primaire celles du dernier argument. 1753 (Pour faire une copie exacte de la ligne, on indique les mêmes valeurs 1757 1754 pour les deux derniers arguments.) La commande <command>UPDATE</command> 1758 1755 affecte toujours tous les champs de la ligne — la différence 1759 principale entre ce ciet <function>dblink_build_sql_insert</function> est1760 qu'il est supposé que la ligne cible existe déjàdans la table distante.1756 principale entre cette instruction et <function>dblink_build_sql_insert</function> est 1757 l'hypothèse de l'existence de la ligne cible dans la table distante. 1761 1758 </para> 1762 1759 </refsect1> … … 1770 1767 <listitem> 1771 1768 <para> 1772 Nom d'une relation existante, par exemple <literal>foo</literal> ou1773 <literal>monschema.matable</literal>. Ajoute zdes guillemets doubles1774 si le nom est en minuscule et en majuscule,ou contient des1769 Le nom d'une relation locale, par exemple <literal>foo</literal> ou 1770 <literal>monschema.matable</literal>. Ajouter des guillemets doubles 1771 si le nom est en casse mixte ou contient des 1775 1772 caractères spéciaux, par exemple <literal>"FooBar"</literal> ; 1776 sans guillemets, la chaîne sera mise en minuscule.1773 sans guillemets, la chaîne est forcée en minuscule. 1777 1774 </para> 1778 1775 </listitem> … … 1783 1780 <listitem> 1784 1781 <para> 1785 Numéros des attributs (commençant à 1) des champs de la clé primaire,1782 Les numéros des attributs (commençant à 1) des champs de la clé primaire, 1786 1783 par exemple <literal>1 2</literal>. 1787 1784 </para> … … 1793 1790 <listitem> 1794 1791 <para> 1795 Le nombre de champs de la clé primaire 1792 Le nombre de champs de la clé primaire. 1796 1793 </para> 1797 1794 </listitem> … … 1802 1799 <listitem> 1803 1800 <para> 1804 Les valeurs des champs de la clé primaire pour rechercher la ligne1805 locale. Chaque champ est représenté dans sa forme textuelle. Une1806 erreur est renvoyé s'il n'y a pas de lignes locales avec ces valeurs1801 Les valeurs des champs de la clé primaire à utiliser pour identifier le 1802 tuple local. Chaque champ est représenté dans sa forme textuelle. Une 1803 erreur est renvoyée s'il n'y a pas de lignes locales avec ces valeurs 1807 1804 de clé primaire. 1808 1805 </para> traduc/trunk/postgresql/dict-int.xml
r973 r1088 14 14 <para> 15 15 <filename>dict_int</filename> est un exemple de modèle de dictionnaire pour 16 la recherche plein texte. Ce qui a motivé la création de ce dictionnaire17 est le contrôle de l'indexage desentiers (signés et non signés),18 p ermettant à des tels nombres d'être indexés tout en empêchant un19 grossissement excessif du nombre de s mots uniquesqui affecte16 la recherche plein texte. La création de ce dictionnaire à été motivée par la 17 volonté de pouvoir contrôler l'indexage d'entiers (signés et non signés), 18 pour permettre à de tels nombres d'être indexés sans 19 grossissement excessif du nombre de mots uniques, ce qui affecte 20 20 grandement la performance de la recherche. 21 21 </para> … … 30 30 <listitem> 31 31 <para> 32 Le paramètre <literal>maxlen</literal> spécifie le nombre maximum de33 chiffres autorisé edans un mot de type entier. La valeur par défaut34 est de 6.32 le paramètre <literal>maxlen</literal> indique le nombre maximum de 33 chiffres autorisés dans un mot de type entier. La valeur par défaut 34 est 6 ; 35 35 </para> 36 36 </listitem> 37 37 <listitem> 38 <!-- stop word : terme courant ??? --> 38 39 <para> 39 Le paramètre <literal>rejectlong</literal> spécifie si un entier trop40 grosdoit être tronqué ou ignoré. Si <literal>rejectlong</literal> vaut41 <literal>false</literal> ( lavaleur par défaut), le dictionnaire renvoie40 Le paramètre <literal>rejectlong</literal> précise si un entier trop 41 long doit être tronqué ou ignoré. Si <literal>rejectlong</literal> vaut 42 <literal>false</literal> (valeur par défaut), le dictionnaire renvoie 42 43 les <literal>maxlen</literal> premiers chiffres de l'entier. Si 43 44 <literal>rejectlong</literal> vaut <literal>true</literal>, le 44 45 dictionnaire traite l'entier comme un terme courant, l'entier n'est 45 donc pas indexé. Notez que cela signifie aussi qu'un tel nombre ne peut46 donc pas indexé. Cela signifie aussi qu'un tel nombre ne peut 46 47 pas être recherché. 47 48 </para> … … 54 55 55 56 <para> 56 Exécuter lescript d'installation crée un modèle de recherche plein57 L'exécution du script d'installation crée un modèle de recherche plein 57 58 texte <literal>intdict_template</literal> et un dictionnaire 58 59 <literal>intdict</literal> basé sur ce dernier avec les paramètres par 59 défaut. Vous pouvez modifier les paramètres, par exemple :60 défaut. Les paramètres peuvent être modifiés, par exemple : 60 61 61 62 <programlisting> … … 64 65 </programlisting> 65 66 66 ou créer des nouveaux dictionnaires basés sur le modèle.67 ou de nouveaux dictionnaires basés sur le modèle créés. 67 68 </para> 68 69 … … 79 80 mais une utilisation réelle nécessite de l'inclure dans une configuration 80 81 de recherche plein texte comme celle décrite dans <xref 81 linkend="textsearch"/>. Cela p ourrait ressembler à ceci :82 linkend="textsearch"/>. Cela peut ressembler à ceci : 82 83 83 84 <programlisting> traduc/trunk/postgresql/dict-xsyn.xml
r973 r1088 14 14 <para> 15 15 Le module <filename>dict_xsyn</filename> (<foreignphrase>Extended Synonym 16 Dictionary</foreignphrase>, autrement dit ledictionnaire étendu de17 synonymes) est un exemple d 'unmodèle de dictionnaire pour la recherche16 Dictionary</foreignphrase>, dictionnaire étendu de 17 synonymes) est un exemple de modèle de dictionnaire pour la recherche 18 18 plein texte. Ce type de dictionnaire remplace des mots avec un ensemble 19 19 de synonymes, ce qui rend possible la recherche d'un mot en utilisant 20 tousses synonymes.20 un de ses synonymes. 21 21 </para> 22 22 … … 30 30 <listitem> 31 31 <para> 32 si <literal>keeporig</literal> vaut <literal>true</literal> (la valeur33 par défaut), le mot original est inclus dans la recherche. Dans le cas34 contraire, seuls les synonymes sont pris en compte.32 <literal>keeporig</literal> indique si le mot original est inclus dans la 33 recherche (si <literal>true</literal>, valeur par défaut), ou seulement 34 ses synonymes (si <literal>false</literal>) ; 35 35 </para> 36 36 </listitem> 37 37 <listitem> 38 38 <para> 39 <literal>rules</literal> est le nom d e base du fichier contenant la liste39 <literal>rules</literal> est le nom du fichier contenant la liste 40 40 des synonymes. Ce fichier doit être stocké dans 41 <filename>$SHAREDIR/tsearch_data/</filename> (où <literal>$SHAREDIR</literal> est le répertoire des données partagées de 41 <filename>$SHAREDIR/tsearch_data/</filename> 42 (où <literal>$SHAREDIR</literal> est le répertoire des données partagées de 42 43 la distribution <productname>PostgreSQL</productname>). 43 Son nom doit se terminer en<literal>.rules</literal> (cette extension44 Son nom doit se terminer par <literal>.rules</literal> (cette extension 44 45 n'est pas à inclure dans le paramètre <literal>rules</literal>). 45 46 </para> … … 52 53 <listitem> 53 54 <para> 54 Chaque ligne représente une groupe de synonymes pour un mot simple qui55 estdonné en premier sur la ligne. Les synonymes sont séparés par56 un espace blanc :55 chaque ligne représente un groupe de synonymes pour un mot simple, 56 donné en premier sur la ligne. Les synonymes sont séparés par 57 une espace : 57 58 </para> 58 59 <programlisting> … … 62 63 <listitem> 63 64 <para> 64 Unsigne dièse (<literal>#</literal>) est un délimiteur de commentaires. Il peut65 le signe dièse (<literal>#</literal>) est un délimiteur de commentaires. Il peut 65 66 apparaître dans la ligne. Le reste de la ligne est ignoré. 66 67 </para> … … 69 70 70 71 <para> 71 Cherchezdans <filename>xsyn_sample.rules</filename> qui est installé dans72 <filename>$SHAREDIR/tsearch_data/</filename> pour un exemple.72 Un exemple est donné dans <filename>xsyn_sample.rules</filename> qui est installé dans 73 <filename>$SHAREDIR/tsearch_data/</filename>. 73 74 </para> 74 75 </sect2> … … 81 82 <literal>xsyn_template</literal> de recherche plein texte et un dictionnaire 82 83 <literal>xsyn</literal> basé sur le modèle, avec des paramètres par défaut. 83 Vous pouvezmodifier les paramètres, par exemple :84 Il est possible de modifier les paramètres, par exemple : 84 85 85 86 <programlisting> … … 88 89 </programlisting> 89 90 90 ou créer de nouveaux dictionnaires basés sur le modèle.91 ou de créer de nouveaux dictionnaires basés sur le modèle. 91 92 </para> 92 93 93 94 <para> 94 Pour tester le dictionnaire , vous pouvez essayer :95 Pour tester le dictionnaire : 95 96 96 97 <programlisting> … … 101 102 </programlisting> 102 103 103 mais une utilisation réelle implique rason ajout dans une configuration de104 mais une utilisation réelle implique son ajout dans une configuration de 104 105 recherche plein texte comme décrit dans <xref linkend="textsearch"/>. Cela 105 106 pourrait ressembler à ceci : traduc/trunk/postgresql/diskusage.xml
r973 r1088 10 10 11 11 <para> 12 Ce chapitre explique comment surveiller l'utilisation des disques faite par13 <productname>PostgreSQL</productname> .12 Ce chapitre explique comment surveiller l'utilisation que fait 13 <productname>PostgreSQL</productname> des disques. 

