Editer un article - Informaticien.be

Editer un article

Titre
Mots Clés
Texte	[size=18] [b]Nom[/b] [/size] pg_dumpall - Extrait un groupe de base de données PostgreSQL dans un fichier de script [size=18] [b]Résumé[/b] [/size] [b]pg_dumpall[/b] [ [b][/b][i]option[/i][b][/b]...[b][/b] ] [size=18] [b]Description[/b] [/size] [b]pg_dumpall[/b] est un utilitaire pour écrire (« sauvegarder ») tout un groupe de base de données dans un fichier de script. Le fichier de script contient des commandes SQL qui peuvent être utilisées en entrée dans [b]psql[/b](1) pour restaurer les bases de données. Ce programme fait ceci en appelant [b]pg_dump[/b](1) pour chacune des bases de données appartenant au groupe. [b]pg_dumpall[/b] sauvegarde aussi les objets globaux communs à toutes les bases de données. ([b]pg_dump[/b] ne sauvegarde pas ces objets.) Ceci inclut actuellement les informations sur les utilisateurs et les groupes de la base de données,et les permissions d'accès qui s'appliquent aux bases de données dans leur ensemble. Ainsi, [b]pg_dumpall[/b] est une solution intégrée de soutien pour vos bases de données. Mais il y a une limitation : Il ne peut pas sauvegarder les « objets larges », tout comme [b]pg_dump[/b] ne peut pas le faire aussi dans un fichier de texte. Si vous avez des bases de données contenant des objets larges, elles devraient être sauvegardées en utilisant un des modes de sortie au format non texte de [b]pg_dump[/b]. Comme [b]pg_dumpall[/b] lit les tables de toutes les bases de données vous aurez probablement à vous connecter comme superutilisateur de base de données dans le but de produire une sauvegarde complète. Vous aurez besoin aussi des privilèges superutilisateurs pour exécuter les scripts de sauvegarde dans le but de pouvoir ajouter des utilisateurs et des groupes, et de créer des bases de données. Le script SQL sera écrit sur la sortie standard. Les opérateurs Shell devraient être utilisés pour rediriger la sortie standard dans un fichier. [b]pg_dumpall[/b] a besoin de se connecter plusieurs fois au serveur PostgreSQL et peut vous demander un mot de passe à chaque fois. Il peut être commode d'avoir un fichier [i]$HOME/.pgpass[/i] dans ce genre de cas. [size=18] [b]Options[/b] [/size] Les lignes de commandes suivantes sont utilisées pour contrôler le contenu et le format de la sortie. [table][row][col]    [/col][col][b]-a[/b][/col][/row][/table] [table][row][col]    [/col][col][b]--data-only[/b] Suavegarde les données seulement, pas le schéma (définition de la structure des données).[/col][/row][/table] [table][row][col]    [/col][col][b]-c[/b][/col][/row][/table] [table][row][col]    [/col][col][b]--clean[/b] Inclut les commandes SQL pour nettoyer (drop) les bases de données avant de les recréer.[/col][/row][/table] [table][row][col]    [/col][col][b]-d[/b][/col][/row][/table] [table][row][col]    [/col][col][b]--inserts[/b] Sauvegarde les données comme des commandes d'[b]INSERT[/b] (au lieu d'une commande [b]COPY[/b]). Cela produira une restauration très lente, mais réalisera une sortie plus portable à d'autres gestionnaires de bases de données.[/col][/row][/table] [table][row][col]    [/col][col][b]-D[/b][/col][/row][/table] [table][row][col]    [/col][col][b]--column-inserts[/b][/col][/row][/table] [table][row][col]    [/col][col][b]--attribute-inserts[/b] Sauvegarde les données comme des commandes d'[b]INSERT[/b] avec explicitement les noms de colonnes (INSERT INTO [i]table[/i] ([i]column[/i], ...) VALUES &...). Cela produira une restauration très lente, mais cela est nécessaire pour réarranger l'ordre des colonnes.[/col][/row][/table] [table][row][col]    [/col][col][b]-g[/b][/col][/row][/table] [table][row][col]    [/col][col][b]--globals-only[/b] Ne sauvegarde que les objets globaux (utilisateurs et groupes), pas les bases de données.[/col][/row][/table] [table][row][col]    [/col][col][b]-i[/b][/col][/row][/table] [table][row][col]    [/col][col][b]--ignore-version[/b] Ignore les erreurs de version entre [b]pg_dumpall[/b] et le serveur de base de données. [b]pg_dumpall[/b] peut maintenir des bases de données de versions précédentes de PostgreSQL, mais les très vieilles versions ne sont plus supportées plus longtemps ( actuellement antérieure à la 7.0). utilisez cette option si vous avez besoin de passer outre les vérifications de version (et si [b]pg_dumpall[/b] alors échoue, vous ne pourrez pas dire que vous n'aurez pas été prévenu).[/col][/row][/table] [table][row][col]    [/col][col][b]-o[/b][/col][/row][/table] [table][row][col]    [/col][col][b]--oids[/b] Sauvegarde les identifiants d'objets (OIDs) pour chaque table. Utilisez cette option si votre application référence les colonnes d'OID de n'importe quelle manière (par exemple, dans les contraintes de clés étrangères). Autrement, cette option ne devrait pas être utilisée.[/col][/row][/table] [table][row][col]    [/col][col][b]-s[/b][/col][/row][/table] [table][row][col]    [/col][col][b]--schema-only[/b] Sauvegarde seulement le schéma (definitions des données), pas les données.[/col][/row][/table] [table][row][col]    [/col][col][b]-v[/b][/col][/row][/table] [table][row][col]    [/col][col][b]--verbose[/b] Spécifie le mode parlant. Cela demandera à [b]pg_dumpall[/b] d'afficher des messages de progression sur la sortie d'erreurs standard[/col][/row][/table] [table][row][col]    [/col][col][b]-x[/b][/col][/row][/table] [table][row][col]    [/col][col][b]--no-privileges[/b][/col][/row][/table] [table][row][col]    [/col][col][b]--no-acl[/b] Empêche la sauvegarde les privilèges d'accès (commandes de grant/revoke).[/col][/row][/table] Les options de lignes de commandes suivantes contrôlent les paramètres de connection aux bases de données. [table][row][col]    [/col][col][b]-h[/b] [i]host[/i][b][/b] Spécifie le nom d'hôte de la machine sur laquelle la base de données tourne. Si la valeur commence par un slash, cela est utilisé comme un répertoire pour une connexion à un domaine Unix. La valeur par défaut est prise dans la variable d'environnement [b]PGHOST[/b], si elle est initialisée, sinon une connexion de type domaine Unix est tentée.[/col][/row][/table] [table][row][col]    [/col][col][b]-p[/b] [i]port[/i][b][/b] Spécifie le port TCP ou l'extension de fichier de connection local au domaine Unix sur lequel le serveur écoute pour établir les connexions. La valeur par défaut se trouve dans la variable d'environnement [b]PGPORT[/b], si elle est initialisée, ou dans la variable spécifiée par défaut au moment de la compilation du serveur.[/col][/row][/table] [table][row][col]    [/col][col][b]-U[/b] [i]username[/i][b][/b] Connecte comme l'utilisateur designé.[/col][/row][/table] [table][row][col]    [/col][col][b]-W[/b] Force une invite de commande demandant le mot de passe. Cela peut se produire automatiquement si le serveur est paramètré pour demander des authentifications par mot de passe.[/col][/row][/table] [size=18] [b]Environnement[/b] [/size] [table][row][col]    [/col][col][b]PGHOST[/b][/col][/row][/table] [table][row][col]    [/col][col][b]PGPORT[/b][/col][/row][/table] [table][row][col]    [/col][col][b]PGUSER[/b] Paramètres de connexion par défaut[/col][/row][/table] [size=18] [b]Notes[/b] [/size] Comme [b]pg_dumpall[/b] appelle [b]pg_dump[/b] en interne, quelques messages de diagnostic feront référence à[b]pg_dump[/b]. Une fois restauré, il serait sage d'exécuter [b]ANALYZE[/b] sur chacune des bases de données ainsi l'optimiseur aurait des statistiques utiles. Vous pouvez aussi exécuter [b]vacuumdb[/b] -a -z pour analyser toutes les bases de données. [size=18] [b]Exemples[/b] [/size] Pour sauvegarder toutes les bases de données : .nf $ [b]pg_dumpall[/b] > db.out .fi Pour recharger ces mêmes bases de données, utilisez par exemple : .nf $ [b]psql[/b] -f db.out template1 .fi (La base de données à laquelle vous vous connectez n'a pas d'importance ici, puisque le fichier de script créé par [b]pg_dumpall[/b] contriendra les commandes appropriées pour créer et se connecter aux bases de données sauvegardées.) [size=18] [b]Voir aussi[/b] [/size] [b]pg_dump[/b](1). Vérifiez là pour plus de détails sur de possibles conditions d'erreurs. [size=18] [b]Traduction[/b] [/size] Il est possible que cette traduction soit imparfaite ou périmée. En cas de doute, veuillez vous reporter au document original en langue anglaise fourni avec le programme.
Fichier