pg_dumpall 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 psql(1) pour restaurer les bases de données. Ce programme fait ceci en appelant pg_dump(1) pour chacune des bases de données appartenant au groupe. pg_dumpall sauvegarde aussi les objets globaux communs à toutes les bases de données. (pg_dump 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, pg_dumpall 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 pg_dump 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 pg_dump.
Comme pg_dumpall 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.
pg_dumpall 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 $HOME/.pgpass dans ce genre de cas.
Les lignes de commandes suivantes sont utilisées pour contrôler le contenu et le format de la sortie.
pg_dumpall 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 pg_dumpall alors échoue, vous ne pourrez pas dire que vous n'aurez pas été prévenu).
Les options de lignes de commandes suivantes contrôlent les paramètres de connection aux bases de données.
Comme pg_dumpall appelle pg_dump en interne, quelques messages de diagnostic feront référence àpg_dump.
Une fois restauré, il serait sage d'exécuter ANALYZE sur chacune des bases de données ainsi l'optimiseur aurait des statistiques utiles. Vous pouvez aussi exécuter vacuumdb -a -z pour analyser toutes les bases de données.
Pour sauvegarder toutes les bases de données :
$ pg_dumpall > db.out
Pour recharger ces mêmes bases de données, utilisez par exemple :
$ psql -f db.out template1(La base de données à laquelle vous vous connectez n'a pas d'importance ici, puisque le fichier de script créé par pg_dumpall contriendra les commandes appropriées pour créer et se connecter aux bases de données sauvegardées.)
pg_dump(1). Vérifiez là pour plus de détails sur de possibles conditions d'erreurs.
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.