- dbname
Spécifie le nom de la base à sauvegarder.
- -a, --data-only
Sauvegarde seulement les données, pas le schéma (définitions de
données).
Cette option n'est significative que pour le format texte. Pour les
autres formats, vous devez spécifier l'option quand vous appelez
pg_restore.
- -b, --blobs
Inclut les objets longs dans la sauvegarde.
- -c, --clean
Commandes de sortie pour nettoyer (drop)
les objets de la base avant de les créer.
Cette option n'est significative que pour le format texte. Pour les
autres formats, vous devez spécifier l'option quand vous appelez
pg_restore.
- -C, --create
Débute avec une commande pour créer la base elle-même et
reconnecter la base créée.
(Avec un script de cette forme, peut importe la base à laquelle
vous vous connectez avant de lancer le script).
Cette option n'est significative que pour le format texte. Pour les
autres formats, vous devez spécifier l'option quand vous appelez
pg_restore.
- -d, --inserts
Sauvegarde les données comme commandes INSERT
(d'avantage que comme COPY). Ce qui rendra la restauration
très lente, mais permet aux archives d'être portables sur d'autres SGBDR.
- -D, --column-inserts, --attribute-inserts
Sauvegarde les données comme commandes INSERT avec
les noms de colonnes explicites
(INSERT INTO
table
(column, ...) VALUES
...). Ce qui rendra la restauration très lente,
mais c'est nécessaire si vous voulez modifier l'ordonnancement
des colonnes.
- -f file, --file=file
Envoie la sortie vers le fichier spécifié. Si ceci est omis, la
sortie standard est utilisée.
- -F format, --format=format
Sélectionne le format de sortie.
Le format peut être un des suivants :
- p
Fichier script SQL texte en sortie (par défaut).
- t
Sort une archive tar adéquate pour les entrées
dans pg_restore. Utiliser ce format d'archive
permet de réordonnancer et/ou l'exclusion d'éléments du schéma
au moment où la base est restaurée. Il est aussi possible de limiter
les données à recharger à la restauration.
- c
Sort une archive adéquate pour l'entrée dans
pg_restore. C'est le fomat le plus souple
en ce qu'il permet le réordonnancement des données chargées aussi bien
que des éléments du schéma. Ce format est aussi compressé par défaut.
- -i, --ignore-version
Ignore le défaut d'appariement entre pg_dump
et le serveur de la base. Chaque version de pg_dump
est prévue pour fonctionner avec la version correspondante
du serveur de base. Utilisez cette option si vous voulez outrepasser la
vérification de version (et si
pg_dump échoue sans vous prévenir).
- -n, --no-quotes
Supprime les guillemets autour des identifiants sauf absolue nécessité.
Ceci peut causer des difficultés au chargement des données
sauvegardées s'il y a des mots-clé réservés utilisés comme identifiants.
C'est le comportement par défaut de
pg_dump avant la version version 6.4.
- -N, --quotes
Inclut les guillemets autour des identifiants.
Comportement par défaut.
- -o, --oids
Sauvegarde les identifiants objet (OID) pour chaque
table. Utilisez cette option si votre application référence les
colonnes OID de cette façon (ex., dans une contrainte de clé étrangère).
Sinon, cette option ne sera pas utilisée.
- -O, --no-owner
N'envoit pas de commandes pour vérifier le propriétaire
de l'objet sur la base. Typiquement,
pg_dump sort des instructions
(psql-specific) \connect
pour placer le propriétaire des éléments du schéma. Voir aussi
-R et -X
use-set-session-authorization. Notez que
-O n'empêche pas toutes les reconnexions à la
base, seuls ceux qui sont exclusivement utilisés pour les
ajustements de propriété.
Cette option n'est significative que pour le format texte. Pour les
autres formats, vous devez spécifier l'option quand vous appelez
pg_restore.
- -d, --inserts
Sauvegarde les données comme commandes INSERT
(d'avantage que comme COPY). Ce qui rendra la restauration
très lente, mais permet aux archives d'être portables sur d'autres SGBDR.
- -D, --column-inserts, --attribute-inserts
Sauvegarde les données comme commandes INSERT avec
les noms de colonnes explicites
(INSERT INTO
table
(column, ...) VALUES
...). Ce qui rendra la restauration très lente,
mais c'est nécessaire si vous voulez modifier l'ordonnancement
des colonnes.
- -f file, --file=file
Envoie la sortie vers le fichier spécifié. Si ceci est omis, la
sortie standard est utilisée.
- -F format, --format=format
Sélectionne le format de sortie.
Le format peut être un des suivants :
- p
Fichier script SQL texte en sortie (par défaut).
- t
Sort une archive tar adéquate pour les entrées
dans pg_restore. Utiliser ce format d'archive
permet de réordonnancer et/ou l'exclusion d'éléments du schéma
au moment où la base est restaurée. Il est aussi possible de limiter
les données à recharger à la restauration.
- c
Sort une archive adéquate pour l'entrée dans
pg_restore. C'est le fomat le plus souple
en ce qu'il permet le réordonnancement des données chargées aussi bien
que des éléments du schéma. Ce format est aussi compressé par défaut.
- -i, --ignore-version
Ignore le défaut d'appariement entre pg_dump
et le serveur de la base. Chaque version de pg_dump
est prévue pour fonctionner avec la version correspondante
du serveur de base. Utilisez cette option si vous voulez outrepasser la
vérification de version (et si
pg_dump échoue sans vous prévenir).
- -n, --no-quotes
Supprime les guillemets autour des identifiants sauf absolue nécessité.
Ceci peut causer des difficultés au chargement des données
sauvegardées s'il y a des mots-clé réservés utilisés comme identifiants.
C'est le comportement par défaut de
pg_dump avant la version version 6.4.
- -N, --quotes
Inclut les guillemets autour des identifiants.
Comportement par défaut.
- -o, --oids
Sauvegarde les identifiants objet (OID) pour chaque
table. Utilisez cette option si votre application référence les
colonnes OID de cette façon (ex., dans une contrainte de clé étrangère).
Sinon, cette option ne sera pas utilisée.
- -O, --no-owner
Ne place pas de commandes de sortie pour vérifier
le propiétaire de l'objet sur la base. Typiquement,
pg_dump sort les instructions
(psql-specific) \connect
pour placer le propriétaire des éléments du schéma. Voir aussi
-R et -X
use-set-session-authorization. Notez que
-O n'évite pas toutes les reconnexions à la
base, seules celles qui sont exclusivement utilisées pour des
ajustemments de propriété.
Cette option n'est significative que pour le format texte. Pour les
autres formats, vous devez spécifier l'option quand vous appelez
pg_restore.
- -R, --no-reconnect
Interdit à pg_dump
de produire un script qui nécessiterait des reconnexions à la
base en cours de restauration. Un script de restauration moyen doit
habituellement se reconnecter plusieurs fois à différents
utilisateurs pour placer les droits d'origine aux objets. Cette option
est un instrument un peu émoussé car il fait que
pg_dump perd son information sur les droits de
propriété, sauf si vous utilisez l'option -X
use-set-session-authorization.
Une raison possible pour laquelle les reconnexions pendant la
restauration ne soient pas désirées est que l'accès à la base nécessite
des interactions manuelles (ex., les mots-de-passe).
Cette option n'est significative que pour le format texte. Pour les
autres formats, vous devez spécifier l'option quand vous appelez
pg_restore.
- -s, --schema-only
Sauvegarde seulement le schéma (définitions de données), pas
les données.
- -S username, --superuser=username
Les scripts ou les archives créées par pg_dump
doivent avoir les droits du superutilisateur dans certains cas, comme
lors de la désactivation des déclencheurs ou le placement des
droits des éléments d schéma.
Cette option spécifie le nom d'utilisateur à utiliser pour ces
cas là.
- -t table, --table=table
Sauvegarde les données pour la table seulement.
- -v, --verbose
Spécifie le mode verbeux.
- -x, --no-privileges, --no-acl
Empêche la sauvegarde des droits d'accès (commandes grant/revoke).
- -X use-set-session-authorization, --use-set-session-authorization
Normalement, si un script (mode texte) généré par
pg_dump doit modifier l'utilisateur courant de
la base (ex., pour placer des droits corrects), il utilise la commande
psql(1) \connect.
Cette commande ouvre une nouvelle connexion, qui peut nécessiter des
interactions manuelles (ex., les mots-de-passe). Si vous utilisez
l'option -X use-set-session-authorization,
pg_dump produira les commandes SET SESSION AUTHORIZATION à la place. Ceci a le même effet, mais nécessite que
l'utilisateur qui restaure la base depuis le script généré soit le
superutilisateur de la base.
Cette option outrepasse l'option -R.
SET SESSION AUTHORIZATION est une commande SQL standard, bien que
\connect fonctionne seulement dans
psql(1), cette option accroît la
portabilité théorique du script produit.
Cette option n'est significative que pour le format texte. Pour les
autres formats, vous devez spécifier l'option quand vous appelez
pg_restore.
- -Z 0..9, --compress=0..9
Spécifie le niveau de compression à utiliser dans les formats
d'archive qui supportent la compression.
