Changeset 1153
- Timestamp:
- 09/22/08 16:01:13 (2 months ago)
- Files:
-
- traduc/trunk/postgresql/func.xml (modified) (3 diffs)
- traduc/trunk/postgresql/ref/pg_dump.xml (modified) (56 diffs)
Legend:
- Unmodified
- Added
- Removed
- Modified
- Copied
- Moved
traduc/trunk/postgresql/func.xml
r1150 r1153 8622 8622 8623 8623 <para> 8624 La fonction <function>xmlagg</function> est, comme les autres fonctions 8625 ci-dessous, une fonction d'agrégat. Elle concatène les valeurs en entrée 8626 de l'appel de la fonction, comme <function>xmlconcat</function> le fait. 8624 La fonction <function>xmlagg</function> est, à la différence des 8625 fonctions qui suivent, une fonction d'aggrégat. Elle concatène les valeurs 8626 en entrée pour les passer en argument à la fonction d'aggrégat, comme le 8627 fait la fonction <function>xmlconcat</function>. 8627 8628 Voir <xref linkend="functions-aggregate"/> pour plus d'informations sur 8628 8629 les fonctions d'agrégat. … … 8643 8644 8644 8645 <para> 8645 Notez que, dans l'implémentation actuelle, l'ordre de la concaténation8646 n'est en principepas défini. Néanmoins, cela peut fonctionner en8646 Dans l'implantation actuelle, l'ordre de la concaténation 8647 n'est, par principe, pas défini. Néanmoins, cela peut fonctionner en 8647 8648 triant préalablement les valeurs en entrée. En reprenant l'exemple 8648 ci-dessus, on p ourrait influencer l'ordre de cette façon :8649 ci-dessus, on peut influencer l'ordre de cette façon : 8649 8650 <screen><![CDATA[ 8650 8651 SELECT xmlagg(x) FROM (SELECT * FROM test ORDER BY y DESC) AS tab; … … 8654 8655 ]]></screen> 8655 8656 8656 Mais le fonctionnement de cette approche n'est pas garantie dans toutes8657 les situations et dans toutes les versions de PostgreSQL. Une version8658 future de PostgreSQL pourrait fournirune fonctionnalité supplémentaire8659 pour contrôler l'ordre d 'une bonne façon8657 Il n'est toutefois pas garanti que cette approche fonctionne dans toutes 8658 les situations et pour toutes les versions de PostgreSQL. Il est probable 8659 qu'une future version de PostgreSQL fournisse une fonctionnalité supplémentaire 8660 pour contrôler l'ordre de façon propre 8660 8661 (<literal>xmlagg(expr ORDER BY expr, expr, ...</literal>). 8661 8662 </para> traduc/trunk/postgresql/ref/pg_dump.xml
r1152 r1153 4 4 par $Author$ 5 5 révision $Revision$ --> 6 <!-- SAS 20060530 : Relecture initiale -->7 6 8 7 <refentry id="app-pgdump"> … … 67 66 68 67 <para> 69 Lorsqu'il est utilisé avec un des formats de fichier d'archivé en combinaison68 Utilisé avec un des formats de fichier d'archive et combiné 70 69 avec <application>pg_restore</application>, 71 70 <application>pg_dump</application> fournit un mécanisme d'archivage … … 77 76 <quote>personnalisé</quote> (<foreignphrase>custom</foreignphrase> en anglais, <option>-Fc</option>). 78 77 Compressé par défaut, il permet de sélectionner et réordonner les éléments archivés. 79 No mcompressé, le format <application>tar</application> (<option>-Ft</option>)78 Non compressé, le format <application>tar</application> (<option>-Ft</option>) 80 79 ne permet pas de réordonner les données au 81 chargement mais est somme touteassez flexible. Qui plus est, il est utilisable80 chargement, mais est, somme toute, assez flexible. Qui plus est, il est utilisable 82 81 par des outils Unix standard comme <command>tar</command>. 83 82 </para> … … 115 114 <listitem> 116 115 <para> 117 Seules les données sont sauvegardées, pas le schéma (définition des données).116 Seules les données sont sauvegardées, pas le schéma (définition des données). 118 117 </para> 119 118 120 119 <para> 121 120 Cette option n'a d'intérêt que pour le format texte. 122 Pour les formats archive, l'option est spécifiée àl'appel de <command>pg_restore</command>.121 Pour les formats archive, l'option peut être précisée lors de l'appel de <command>pg_restore</command>. 123 122 </para> 124 123 </listitem> … … 131 130 <para> 132 131 Inclut les objets larges dans la sauvegarde. C'est le comportement par 133 défaut sauf si vous ajoutez une des options suivantes :132 défaut, sauf si une des options suivantes est ajoutée : 134 133 <option>--schema</option>, <option>--table</option> ou 135 <option>--schema-only</option>. Donc cetteoption <option>-b</option>136 est seulement utile pour ajouter les objets larges dans le cas des134 <option>--schema-only</option>. L'option <option>-b</option> 135 n'est utile que pour ajouter les objets larges aux 137 136 sauvegardes sélectives. 138 137 </para> … … 151 150 <para> 152 151 Cette option n'a d'intérêt que pour le format texte. Pour les 153 formats archive, l'option est spécifiée à l'appel de152 formats archive, l'option est précisée à l'appel de 154 153 <command>pg_restore</command>. 155 154 </para> … … 163 162 <para> 164 163 La sortie débute par une commande de création de la base de données 165 et de connexion à cette base. Peu importe dans ce casla base de données164 et de connexion à cette base. Peu importe, dans ce cas, la base de données 166 165 à laquelle la connexion est faite avant la restauration. 167 166 </para> … … 169 168 <para> 170 169 Cette option n'a d'intérêt que pour le format texte. Pour les 171 formats archive, l'option est spécifiée à l'appel de170 formats archive, l'option est précisée à l'appel de 172 171 <command>pg_restore</command>. 173 172 </para> … … 185 184 rechargées dans des bases de données autres que 186 185 <productname>PostgreSQL</productname>. 187 De plus, comme cette option génèreune commande séparée pour chaque188 ligne, une erreur lors du chargement d'une ligne ne fera que perdre186 De plus, comme cette option produit une commande séparée pour chaque 187 ligne, une erreur lors du chargement d'une ligne ne perd que 189 188 cette ligne plutôt que le contenu entier de la table. 190 La restauration échoue tout de mêmesi les colonnes ont été réorganisées.191 L'option <option>-D</option> est sûre même avec des modifications dans192 l'ordre des colonnes, mais elle est du coup bienplus lente.189 La restauration échoue également si les colonnes ont été réorganisées. 190 L'option <option>-D</option> permet de s'affranchir des modifications 191 de l'ordre des colonnes, mais est encore plus lente. 193 192 </para> 194 193 </listitem> … … 208 207 essentiellement utile pour créer des sauvegardes rechargées dans des 209 208 bases de données autres que <productname>PostgreSQL</productname>. 210 De plus, comme cette option génèreune commande séparée pour chaque211 ligne, une erreur lors du chargement d'une ligne ne fera que perdre209 De plus, comme cette option produit une commande séparée pour chaque 210 ligne, une erreur lors du chargement d'une ligne ne perd que 212 211 cette ligne plutôt que le contenu entier de la table. 213 212 </para> … … 220 219 <listitem> 221 220 <para> 222 La sortie est redirigée vers le fichier spécifié. Sans précision, la sortie221 La sortie est redirigée vers le fichier indiqué. Sans précision, la sortie 223 222 standard est utilisée. 224 223 </para> … … 231 230 <listitem> 232 231 <para> 233 La sauvegarde est créée dans l'encodage spécifié. Par défaut, la sauvegarde utilise celui232 La sauvegarde est créée dans l'encodage indiqué. Par défaut, la sauvegarde utilise celui 234 233 de la base de données. Le même résultat peut être obtenu en positionnant 235 234 la variable d'environnement <envar>PGCLIENTENCODING</envar> avec le codage désiré pour la … … 252 251 <listitem> 253 252 <para> 254 Fichier de scripts <acronym>SQL</acronym> en texte simple (défaut). 253 fichier de scripts <acronym>SQL</acronym> en texte simple 254 (défaut) ; 255 255 </para> 256 256 </listitem> … … 261 261 <listitem> 262 262 <para> 263 Archive <command>tar</command> utilisable par <application>pg_restore</application>.263 archive <command>tar</command> utilisable par <application>pg_restore</application>. 264 264 Ce format permet d'ordonner et/ou d'exclure des objets lors 265 265 de la restauration de la base. 266 Il est également possible de restreindre les données rechargées lors de la restauration. 266 Il est également possible de restreindre les données rechargées lors 267 de la restauration ; 267 268 </para> 268 269 </listitem> … … 273 274 <listitem> 274 275 <para> 275 Archive personnalisée utilisable par <application>pg_restore</application>.276 archive personnalisée utilisable par <application>pg_restore</application>. 276 277 C'est le format le plus flexible puisqu'il permet d'ordonner le chargement des 277 données et la définition des objets. Ce format est compressé par défaut.278 données et la définition des objets. Ce format est compressé par défaut. 278 279 </para> 279 280 </listitem> … … 314 315 <listitem> 315 316 <para> 316 Sauvegarde seulementsles schémas correspondant à <replaceable317 Sauvegarde uniquement les schémas correspondant à <replaceable 317 318 class="parameter">schema</replaceable> ; la sélection se fait à 318 319 la fois sur le schéma et sur les objets qu'il contient. Quand cette 319 320 option n'est pas indiquée, tous les schémas non système de la base cible 320 s eront sauvegardés. Plusieurs schémas peuvent être indiqués en utilisant321 sont sauvegardés. Plusieurs schémas peuvent être indiqués en utilisant 321 322 plusieurs fois l'option <option>-n</option>. De plus, le paramètre 322 323 <replaceable class="parameter">schéma</replaceable> est interprété comme 323 un modèle s uivantles règles utilisées par les commandes324 un modèle selon les règles utilisées par les commandes 324 325 <literal>\d</literal> de <application>psql</application> (voir <xref 325 326 linkend="app-psql-patterns" endterm="app-psql-patterns-title"/>). Du 326 327 coup, plusieurs schémas peuvent être sélectionnés en utilisant des 327 328 caractères joker dans le modèle. Lors de l'utilisation de ces caractères, 328 faites attention à placer le modèle entre guillemets si nécessaire pour329 empêcher le shell de remplacer les jokers.329 il faut faire attention à placer le modèle entre guillemets, si 330 nécessaire, pour empêcher le shell de remplacer les jokers. 330 331 </para> 331 332 … … 333 334 <para> 334 335 Quand <option>-n</option> est indiqué, <application>pg_dump</application> 335 ne sauvegarde aucun autre objet sde la base que ceux dont les schémas336 sélectionnés dépendent. Du coup, il n'est pas garanti eque la sauvegarde336 ne sauvegarde aucun autre objet de la base que ceux dont les schémas 337 sélectionnés dépendent. Du coup, il n'est pas garanti que la sauvegarde 337 338 d'un schéma puisse être restaurée avec succès dans une base vide. 338 339 </para> … … 342 343 <para> 343 344 Les objets qui ne font pas partie du schéma comme les objets larges ne 344 sont pas sauvegardés quand <option>-n</option> est précisé. Vous pouvez 345 de nouveau ajouter les objets larges avec l'option 346 <option>--blobs</option>. 345 sont pas sauvegardés quand <option>-n</option> est précisé. Ils 346 peuvent être rajouter avec l'option <option>--blobs</option>. 347 347 </para> 348 348 </note> … … 357 357 <para> 358 358 Ne sauvegarde pas les schémas correspondant au modèle <replaceable 359 class="parameter">schéma</replaceable>. Le modèle est interprété s uivant359 class="parameter">schéma</replaceable>. Le modèle est interprété selon 360 360 les même règles que <option>-n</option>. <option>-N</option> peut aussi 361 361 être indiqué plus d'une fois pour exclure des schémas correspondant à … … 365 365 <para> 366 366 Quand les options <option>-n</option> et <option>-N</option> sont 367 indiquées, se ront seulement sauvegardés les schémas qui correspondent à au moins367 indiquées, seuls sont sauvegardés les schémas qui correspondent à au moins 368 368 une option <option>-n</option> et à aucune option 369 369 <option>-N</option>. Si <option>-N</option> apparaît sans … … 380 380 <para> 381 381 Les identifiants d'objets (<acronym>OID</acronym>) sont sauvegardés comme 382 donnée des tables. Cette option est utilisée dans le cas d'applications382 données des tables. Cette option est utilisée dans le cas d'applications 383 383 utilisant des références aux colonnes <acronym>OID</acronym> 384 384 (dans une contrainte de clé étrangère, par exemple). Elle ne devrait pas être … … 394 394 <para> 395 395 Les commandes d'initialisation des possessions des objets au regard de 396 la base de données originale ne sont pas produites. Par défaut,397 <application>pg_dump</application> engendre des instructions398 <command>ALTER OWNER</command> ou399 <command>SET SESSION AUTHORIZATION</command> pour400 fixer ces possessions.401 Ces instructions échouent lorsque le script n'est pas402 lancé par un superutilisateur (ou par l'utilisateur403 qui possède tous les objets de ce script). L'option <option>-O</option>404 est utilisée pour créer un script qui puisse être restauré par n'importe405 quel utilisateur. En revanche, c'est cet utilisateur qui devient406 propriétaire de tous les objets.396 la base de données originale ne sont pas produites. Par défaut, 397 <application>pg_dump</application> engendre des instructions 398 <command>ALTER OWNER</command> ou 399 <command>SET SESSION AUTHORIZATION</command> pour 400 fixer ces possessions. 401 Ces instructions échouent lorsque le script n'est pas 402 lancé par un superutilisateur (ou par l'utilisateur 403 qui possède tous les objets de ce script). L'option <option>-O</option> 404 est utilisée pour créer un script qui puisse être restauré par n'importe 405 quel utilisateur. En revanche, c'est cet utilisateur qui devient 406 propriétaire de tous les objets. 407 407 </para> 408 408 409 409 <para> 410 410 Cette option n'a d'intérêt que pour le format texte. 411 Pour les formats archive, l'option est spécifiée à l'appel de <command>pg_restore</command>.411 Pour les formats archive, l'option est précisée à l'appel de <command>pg_restore</command>. 412 412 </para> 413 413 </listitem> … … 420 420 <para> 421 421 Cette option, obsolète, est toujours acceptée pour des raisons 422 de compatibilité ascendante.422 de compatibilité ascendante. 423 423 </para> 424 424 </listitem> … … 430 430 <listitem> 431 431 <para> 432 Seule la définition des objets (le schéma) est sauvegardée, pas les433 données.432 Seule la définition des objets (le schéma) est sauvegardée, pas les 433 données. 434 434 </para> 435 435 </listitem> … … 442 442 <para> 443 443 Le nom du superutilisateur à utiliser lors de la désactivation 444 des déclencheurs. Cela n'a d'intérêt que si l'option445 <option>--disable-triggers</option> est précisée. (En règle générale,446 il est préférable de ne pas utiliser cette option et de lancer le script447 engendréen tant que superutilisateur.)444 des déclencheurs. Cela n'a d'intérêt que si l'option 445 <option>--disable-triggers</option> est précisée. (En règle générale, 446 il est préférable de ne pas utiliser cette option et de lancer le script 447 produit en tant que superutilisateur.) 448 448 </para> 449 449 </listitem> … … 455 455 <listitem> 456 456 <para> 457 Sauvegarde seulement les tables (ou vues ou séquences) correspondant457 Sauvegarde uniquement les tables (ou vues ou séquences) correspondant 458 458 à <replaceable class="parameter">table</replaceable>. Plusieurs tables 459 459 sont sélectionnables en utilisant plusieurs fois l'option … … 465 465 coup, plusieurs tables peuvent être sélectionnées en utilisant des 466 466 caractères joker dans le modèle. Lors de l'utilisation de ces caractères, 467 faites attention à placer le modèle entre guillemets si nécessaire pour468 empêcher le shell de remplacer les jokers.467 il faut faire attention à placer le modèle entre guillemets, si 468 nécessaire, pour empêcher le shell de remplacer les jokers. 469 469 </para> 470 470 … … 472 472 Les options <option>-n</option> et <option>-N</option> n'ont aucun effet 473 473 quand l'option <option>-t</option> est utilisée car les tables 474 sélectionnées par <option>-t</option> s eront sauvegardées quelque soit475 la valeur des options relatives aux schémas et les objets qui ne sont476 pas des tables ne s eront pas sauvegardés.474 sélectionnées par <option>-t</option> sont sauvegardées quelle que soit 475 la valeur des options relatives aux schémas. Les objets qui ne sont 476 pas des tables ne sont pas sauvegardés. 477 477 </para> 478 478 … … 480 480 <para> 481 481 Quand <option>-t</option> est indiqué, <application>pg_dump</application> 482 ne sauvegarde aucun autre objet de la base quela (ou les) table(s)483 sélectionnée(s) dépendent. Du coup, il n'est pas garantieque la sauvegarde482 ne sauvegarde aucun autre objet de la base dont la (ou les) table(s) 483 sélectionnée(s) pourrai(en)t dépendre. Du coup, il n'est pas garanti que la sauvegarde 484 484 spécifique d'une table puisse être restaurée avec succès dans une base vide. 485 485 </para> … … 491 491 compatible avec les versions de <productname>PostgreSQL</productname> 492 492 antérieures à la 8.2. Auparavant, écrire <literal>-t tab</literal> 493 aurait sauvegardé toutes les tables nommées <literal>tab</literal>mais494 maintenant, seules sont sauvegardées celles qui sont visibles dans votre495 chemin de recherche des objets. Pour obtenir l'ancien comportement, vous496 pouvez écrire <literal>-t '*.tab'</literal>. De plus, vous devez aussi 493 sauvegardait toutes les tables nommées <literal>tab</literal>, mais 494 maintenant, seules sont sauvegardées celles qui sont visibles dans le 495 chemin de recherche des objets. Pour retrouver l'ancien comportement, 496 il faut écrire <literal>-t '*.tab'</literal>. De plus, il faut 497 497 écrire quelque chose comme <literal>-t sch.tab</literal> pour sélectionner 498 498 une table dans un schéma particulier plutôt que l'ancienne syntaxe … … 509 509 <para> 510 510 Ne sauvegarde pas les tables correspondant au modèle <replaceable 511 class="parameter">table</replaceable>. Le modèle est interprété s uivant511 class="parameter">table</replaceable>. Le modèle est interprété selon 512 512 les même règles que <option>-t</option>. <option>-T</option> peut aussi 513 être indiqué plus d'une fois pour exclure des tables correspondant à513 être indiqué plusieurs pour exclure des tables correspondant à 514 514 des modèles différents. 515 515 </para> … … 517 517 <para> 518 518 Quand les options <option>-t</option> et <option>-T</option> sont 519 indiquées, se ront seulement sauvegardées les tables qui correspondent à au moins519 indiquées, seules sont sauvegardées les tables qui correspondent à au moins 520 520 une option <option>-t</option> et à aucune option 521 521 <option>-T</option>. Si <option>-T</option> apparaît sans … … 534 534 détaillés sur les objets et les heures de début et de fin dans le fichier de 535 535 sauvegarde. Des messages de progression sont également affichés sur la 536 sortie erreur standard.536 sortie d'erreur standard. 537 537 </para> 538 538 </listitem> … … 545 545 <listitem> 546 546 <para> 547 Les droits d'accès (commandes grant/revoke) ne sont pas sauvegardés.547 Les privilèges d'accès (commandes grant/revoke) ne sont pas sauvegardés. 548 548 </para> 549 549 </listitem> … … 554 554 <listitem> 555 555 <para> 556 Cette option désactive l'utilisation des guillemets dollar pour le557 corps des fonctions. La syntaxe SQL standard des chaînes est utilisée pour558 la mise entre guillemets du corps des fonctions.556 Cette option désactive l'utilisation des guillemets dollar pour le 557 corps des fonctions. La syntaxe SQL standard des chaînes est utilisée pour 558 la mise entre guillemets du corps des fonctions. 559 559 </para> 560 560 </listitem> … … 566 566 <para> 567 567 Cette option n'a d'intérêt que dans le cas de sauvegarde des données seules. 568 Dans ce cas, <application>pg_dump</application> inclut à la sortie des569 commandes permettant de désactiver temporairement les déclencheurs sur les tables570 cibles lors du chargement des données.571 Cette commande est utilisée lorsqu'il existe sur les tables des vérifications d'intégrité572 référentielles ou des déclencheurs dont l'exécution n'est pas souhaitable573 lors du chargement des données.568 Dans ce cas, <application>pg_dump</application> inclut à la sortie des 569 commandes permettant de désactiver temporairement les déclencheurs sur les tables 570 cibles lors du chargement des données. 571 Cette commande est utilisée lorsqu'il existe sur les tables des vérifications d'intégrité 572 référentielles ou des déclencheurs dont l'exécution n'est pas souhaitable 573 lors du chargement des données. 574 574 </para> 575 575 576 576 <para> 577 577 À l'heure actuelle, les commandes engendrées par <option>--disable-triggers</option> 578 doivent être exécutées par le superutilisateur. Il est donc nécessaire que le nom579 du superutilisateur soit également précisé, à l'aide de <option>-S</option>.580 Le script résultant peut aussi être lancé par le superutilisateur (c'est d'ailleurs581 préférable).578 doivent être exécutées par le superutilisateur. Il est donc nécessaire que le nom 579 du superutilisateur soit également précisé, à l'aide de 580 <option>-S</option>, ou que le script résultant soit lancé par le 581 superutilisateur (c'est d'ailleurs préférable). 582 582 </para> 583 583 584 584 <para> 585 585 Cette option n'a d'intérêt que pour le format texte. Pour les 586 formats archive, l'option est spécifiée à l'appel de 587 <command>pg_restore</command>. 586 formats archive, l'option est précisée à l'appel de <command>pg_restore</command>. 588 587 </para> 589 588 </listitem> … … 594 593 <listitem> 595 594 <para> 596 Les commandes <command>SET SESSION AUTHORIZATION</command> du standard597 SQL sont affichées à la place des commandes <command>ALTER OWNER</command> pour598 préciser le propriétaire d'un objet. Cela rend la sauvegarde plus compatible599 avec le standard mais, en fonction de l'historique des objets dans la sauvegarde,600 il se peut que la restauration soit incorrecte. De plus, une sauvegarde qui utilise601 <command>SET SESSION AUTHORIZATION</command> nécessite pour la restauration des droits602 superutilisateur tandis que<command>ALTER OWNER</command> requiert des privilèges603 moins étendus.595 Les commandes <command>SET SESSION AUTHORIZATION</command> du standard 596 SQL sont affichées à la place des commandes <command>ALTER OWNER</command> pour 597 préciser le propriétaire d'un objet. Cela rend la sauvegarde plus compatible 598 avec le standard mais, en fonction de l'historique des objets dans la sauvegarde, 599 il se peut que la restauration soit incorrecte. De plus, une sauvegarde qui utilise 600 <command>SET SESSION AUTHORIZATION</command> nécessite pour la restauration des droits 601 superutilisateur tandis que <command>ALTER OWNER</command> requiert des privilèges 602 moins étendus. 604 603 </para> 605 604 </listitem> … … 611 610 <listitem> 612 611 <para> 613 Spécifie le niveau de compression à utiliser. Zéro signifie sans612 Indique le niveau de compression à utiliser. Zéro signifie sans 614 613 compression. Pour le format d'archive personnalisé, cela signifie la 615 compression des segments individuels des données des tables. La valeur616 par défaut est de compresserà un niveau modéré. Pour le format texte,617 indiquer une valeur différente de zéro fait que le fichier entier est618 compressé, bien qu'il a été envoyé à 614 compression des segments individuels des données des tables. Par 615 défaut, la compression se fait à un niveau modéré. Pour le format texte, 616 indiquer une valeur différente de zéro implique une compression du 617 fichier complet, comme s'il était passé à 619 618 <application>gzip</application> ; mais par défaut, la sortie n'est 620 619 pas compressée. Le format d'archive tar ne supporte pas du tout la … … 638 637 de données est exécuté. Si la valeur commence par une barre oblique (/), 639 638 elle est utilisée comme répertoire pour le socket de domaine Unix. 640 La valeur par défaut est fournie par la variable d'environnement641 <envar>PGHOST</envar>, si elle est initialisée. Dans le cas contraire,642 une connexion sur la socket de domaine Unix est tentée.639 La valeur par défaut est fournie par la variable d'environnement 640 <envar>PGHOST</envar>, si elle est initialisée. Dans le cas contraire, 641 une connexion sur la socket de domaine Unix est tentée. 643 642 </para> 644 643 </listitem> … … 652 651 Le port TCP ou le fichier local de socket de domaine Unix 653 652 sur lequel le serveur écoute les connexions. 654 La valeur par défaut est fournie par la variable d'environnement655 <envar>PGPORT</envar>, si elle est initialisée. Dans le cas contraire,656 il s'agit de la valeur fournie à la compilation.653 La valeur par défaut est fournie par la variable d'environnement 654 <envar>PGPORT</envar>, si elle est initialisée. Dans le cas contraire, 655 il s'agit de la valeur fournie à la compilation. 657 656 </para> 658 657 </listitem> … … 679 678 680 679 <para> 681 Cette option n'est jamais obligatoire car682 <application>pg_dump</application> demande raautomatiquement un680 Cette option n'est jamais nécessaire car 681 <application>pg_dump</application> demande automatiquement un 683 682 mot de passe si le serveur exige une authentification par mot de 684 passe. Néanmoins, <application>pg_dump</application> perd raune685 tentative de connexion pour t rouver que le serveur veutun mot de683 passe. Néanmoins, <application>pg_dump</application> perd une 684 tentative de connexion pour tester si le serveur demande un mot de 686 685 passe. Dans certains cas, il est préférable d'ajouter l'option 687 686 <option>-W</option> pour éviter la tentative de connexion. … … 713 712 <para> 714 713 Cet outil, comme la plupart des autres outils <productname>PostgreSQL</productname>, 715 utilise aussiles variables d'environnement supportées par la bibliothèque714 utilise les variables d'environnement supportées par la bibliothèque 716 715 <application>libpq</application> (voir <xref linkend="libpq-envars"/>). 717 716 </para> … … 726 725 <command>SELECT</command>. Si des problèmes apparaissent à l'exécution de 727 726 <application>pg_dump</application>, <xref linkend="app-psql"/> peut être 728 utilisé pour s'assurer de la possibilitéde sélectionner des informations727 utilisé pour s'assurer qu'il est possible de sélectionner des informations 729 728 dans la base de données. De plus, 730 729 tout paramètre de connexion par défaut et toute variable d'environnement 731 utilisé par la bibliothèque <application>libpq</application> s'applique ront.730 utilisé par la bibliothèque <application>libpq</application> s'appliquent. 732 731 </para> 733 732 </refsect1> … … 738 737 739 738 <para> 740 Si des ajouts locaux à la base <literal>template1</literal> ont été effectués741 dans le groupe de bases de données, il est impératif de s'assurer que la739 Si des ajouts locaux à la base <literal>template1</literal> ont été 740 effectués, il est impératif de s'assurer que la 742 741 sortie de <application>pg_dump</application> est effectivement restaurée 743 742 dans une base vide ; dans le cas contraire, il est fort probable … … 771 770 772 771 <para> 773 Le fichier de sauvegarde engendrépar <application>pg_dump</application> ne772 Le fichier de sauvegarde produit par <application>pg_dump</application> ne 774 773 contient pas les statistiques utilisées par l'optimiseur pour la 775 774 planification des requêtes. Il est donc conseillé, pour assurer des … … 777 776 la restauration d'une sauvegarde. Le fichier de sauvegarde ne contient pas 778 777 non plus de commandes <command>ALTER DATABASE ... SET</command> ; ces 779 paramètres sont sauvegardé es par <xref linkend="app-pg-dumpall"/>, avec les778 paramètres sont sauvegardés par <xref linkend="app-pg-dumpall"/>, avec les 780 779 utilisateurs et les paramètres globaux à l'installation. 781 780 </para> … … 786 785 De ce fait, le résultat de <application>pg_dump</application> peut être chargé dans des 787 786 bases de données <productname>PostgreSQL</productname> de versions supérieures. 788 Ce résultat peut aussi être lu par des serveurs <productname>PostgreSQL</productname>787 Cet outil sait également lire les données sur des serveurs <productname>PostgreSQL</productname> 789 788 plus anciens. Néanmoins, <application>pg_dump</application> ne peut généralement 790 789 pas lire des bases de données plus récentes ou produire une 791 790 sauvegarde qui puisse être chargée par des versions antérieures. Pour cela, une 792 édition manuelle de la sauvegarde peut s e révéler nécessaire.791 édition manuelle de la sauvegarde peut s'avérer nécessaire. 793 792 </para> 794 793 </refsect1> … … 798 797 799 798 <para> 800 Pour sauvegarder une base appelée <literal>ma_base</literal> dans un script799 Sauvegarder une base appelée <literal>ma_base</literal> dans un script 801 800 SQL : 802 801 <screen><prompt>$</prompt> <userinput>pg_dump ma_base > base.sql</userinput> … … 805 804 806 805 <para> 807 Pour charger ce script dans une base nouvellement créée et nommée806 Charger ce script dans une base nouvellement créée et nommée 808 807 <literal>nouvelle_base</literal>: 809 808 … … 813 812 814 813 <para> 815 Pour sauvegarder une base dans un fichier au format personnalisé :814 Sauvegarder une base dans un fichier au format personnalisé : 816 815 817 816 <screen><prompt>$</prompt> <userinput>pg_dump -Fc ma_base > base.dump</userinput> … … 820 819 821 820 <para> 822 Pour charger un fichier d'archive dans une nouvelle base nommée821 Charger un fichier d'archive dans une nouvelle base nommée 823 822 <literal>nouvelle_base</literal> : 824 823 … … 828 827 829 828 <para> 830 Pour sauvegarder la table nommée <literal>mytab</literal> :829 Sauvegarder la table nommée <literal>mytab</literal> : 831 830 832 831 <screen><prompt>$</prompt> <userinput>pg_dump -t ma_table ma_base > base.sql</userinput> … … 835 834 836 835 <para> 837 Pour sauvegarder toutes les tables du schéma <literal>detroit</literal> et836 Sauvegarder toutes les tables du schéma <literal>detroit</literal> et 838 837 dont le nom commence par <literal>emp</literal> sauf la table nommée 839 838 <literal>traces_employes</literal> : … … 844 843 845 844 <para> 846 Pour sauvegarder tous les schémas dont le nom commence avec<literal>est</literal> ou847 <literal>ouest</literal> et termine avec<literal>gsm</literal>, en excluant les schémas845 Sauvegarder tous les schémas dont le nom commence par <literal>est</literal> ou 846 <literal>ouest</literal> et se termine par <literal>gsm</literal>, en excluant les schémas 848 847 dont le nom contient le mot <literal>test</literal> : 849 848 … … 861 860 862 861 <para> 863 Pour sauvegarder tous les objets de la base sauf les tables dont le nom862 Sauvegarder tous les objets de la base sauf les tables dont le nom 864 863 commence par <literal>ts_</literal> : 865 864 … … 870 869 <para> 871 870 Pour indiquer un nom qui comporte des majuscules dans les options 872 <option>-t</option> et assimilées, vous avez besoin d'ajouter des guillemets873 doubles ; sinon le nom sera converti en minuscule(voir<xref871 <option>-t</option> et assimilées, il faut ajouter des guillemets 872 doubles ; sinon le nom est converti en minuscules (voir<xref 874 873 linkend="app-psql-patterns" endterm="app-psql-patterns-title"/>). Les 875 guillemets doubles sont interprétés par le shell , donc vous devez les placer874 guillemets doubles sont interprétés par le shell et doivent dont être placés 876 875 entre guillemets. Du coup, pour sauvegarder une seule table dont le nom 877 comporte des majuscules, vous devez utiliserune commande du style :876 comporte des majuscules, on utilise une commande du style : 878 877 879 878 <screen>

