Editer un article - Informaticien.be

Editer un article

Titre
Mots Clés
Texte	[size=18] [b]Nom[/b] [/size] pg_dump - Extrait une base de données PostgreSQL dans un fichier de script ou dans un autre fichier d'archive [size=18] [b]Résumé[/b] [/size] [b]pg_dump[/b] [ [b][/b][i]option[/i][b][/b]...[b][/b] ] [ [b][/b][i]nom[/i] de base de données[b][/b] ] [size=18] [b]Description[/b] [/size] [b]pg_dump[/b] est un utilitaire de sauvegarde d'une base de données PostgreSQL. Il réalise une sauvegarde cohérente même si la base de données est utilisée en même temps. [b]pg_dump[/b] ne bloque pas les autres utilisateurs d'accéder à la base de données, que ce soit en lecture ou en écriture. Les sauvegardes peuvent être générées dans un format de fichier de script ou d'archive. Les fichiers de scripts sont en format texte plein et contiennent les commandes SQL requises pour reconstruire la base de données dans l'état où elle était au moment de la sauvegarde. Pour restaurer à partir des scripts, utilisez la commande [b]psql[/b](1). Ils peuvent être utilisés pour reconstruire la base de données même sur d'autres machines et d'autres architectures, avec quelques modifications sur d'autres gestionnaires de base de données SQL. Les fichiers alternatifs de format archive sont censés être utilisés avec [b]pg_restore[/b](1) pour reconstruire la base de données, et ils permettent aussi à [b]pg_restore[/b] d'être sélectif sur ce qui est restauré, ou même de réordonner les éléments avant leur restauration. Les fichiers archives sont aussi tout désignés pour être portables entre architectures. Lorsqu'il est utilisé avec un fichier au format archive et combiné avec [b]pg_restore[/b], [b]pg_dump[/b] fournit une archive et un mécanisme de transfert flexible. [b]pg_dump[/b] peut être utilisé pour faire une sauvegarde entière de la base de données, alors [b]pg_restore[/b] peut être utilisé pour examiner l'archive et/ou sélectionner quelles parties de la base de données sont à restaurer. Le format de fichier de sortie le plus flexible est le format « personnalisé » ([b]-Fc[/b]). Il tient compte du choix et du réarrangement de tous les éléments, et est compressé par défaut. Le format [b]tar[/b] ([b]-Ft[/b]) n'est pas compressé et il n'est pas possible de réordonner les données lors du chargement, mais sinon il est tout à fait flexible ; de plus, il peut être manipulé avec d'autres outils comme [b]tar[/b]. En exécutant [b]pg_dump[/b], il faudrait examiner la sortie pour des avertissements eventuels (imprimé sur la sortie standard), spécialement à la lumière les limitations citées ci-dessous. [size=18] [b]Options[/b] [/size] Les lignes de commandes suivantes sont utilisées pour contôler le format de sortie. [table][row][col]    [/col][col][b][/b][i]nom[/i] de base de données[b][/b] Spécifie le nom de la base de données à sauvegarder. Si ce n'est pas spécifié, la variable d'environnement [b]PGDATABASE[/b] est utilisée. Si ce n'est pas initialisé, le nom d'utilisateur spécifié par la connexion est utilisé.[/col][/row][/table] [table][row][col]    [/col][col][b]-a[/b][/col][/row][/table] [table][row][col]    [/col][col][b]--data-only[/b] Sauvegarde seulement les données, pas le schéma (définition des données). Cette option n'est significative que pour le format texte simple. Pour les autres formats, vous devriez spécifier l'option quand vous appelez [b]pg_restore[/b].[/col][/row][/table] [table][row][col]    [/col][col][b]-b[/b][/col][/row][/table] [table][row][col]    [/col][col][b]--blobs[/b] Inclut les grands objets dans la sauvegarde.[/col][/row][/table] [table][row][col]    [/col][col][b]-c[/b][/col][/row][/table] [table][row][col]    [/col][col][b]--clean[/b] Commande de sortie pour nettoyer (drop) la base de données des objets avant de les récréer (commandes de recréation). Cette option n'est significative que pour le format texte simple. Pour les autres formats, vous devriez spécifier l'option quand vous appelez [b]pg_restore[/b].[/col][/row][/table] [table][row][col]    [/col][col][b]-C[/b][/col][/row][/table] [table][row][col]    [/col][col][b]--create[/b] Commence la sortie avec une commande pour créer la base de données elle-même et se reconnecte à cette même base ainsi créée. (Avec un script de cette forme, la base de données à laquelle vous êtes connecté n'a aucune importance.) Cette option n'est significative que pour le format texte simple. Pour les autes formats, vous devriez spécifier l'option quand vous appelez [b]pg_restore[/b].[/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 sous la forme de commandes [b]INSERT[/b] (au lieu de commande [b]COPY[/b]). Cela produira une restauration très lente, mais créera les archives plus portables sur d'autres systèmes de gestion de base de données SQL.[/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 [b]INSERT[/b] avec des noms de colonnes explicites (INSERT INTO [i]table[/i] ([i]column[/i], ...) VALUES &...). Cela produira une restauration très lente, mais cela est nécessaire si vous désirez réarranger l'ordre des colonnes.[/col][/row][/table] [table][row][col]    [/col][col][b]-f[/b] [i]file[/i][b][/b][/col][/row][/table] [table][row][col]    [/col][col][b]--file=[/b][i]file[/i][b][/b] Envoie la sortie dans le fichier spécifié. Si cela est omis, la sortie standard est utilisée.[/col][/row][/table] [table][row][col]    [/col][col][b]-F[/b] [i]format[/i][b][/b][/col][/row][/table] [table][row][col]    [/col][col][b]--format=[/b][i]format[/i][b][/b] Sélectionne le format de la sortie. [i]format[/i] peut être l'une des options suivantes :[table][row][col]    [/col][col][/col][/row][/table] [table][row][col]    [/col][col][b]p[/b] Sort un fichier de script SQL en texte simple (option par défaut)[/col][/row][/table] [table][row][col]    [/col][col][b]t[/b] Sort une archive [b]tar[/b] appropriée pour une entrée dans [b]pg_restore[/b]. Utiliser ce format d'archive permet les réarrangements et/ou l'exclusion d'éléments du schéma au moment de la restauration de la base de données. Il est aussi possible de limiter quelles sont les données à recharger au moment de la restauration.[/col][/row][/table] [table][row][col]    [/col][col][b]c[/b] Sort une archive personnalisée appropriée pour une entrée dans [b]pg_restore[/b]. C'est le format le plus flexible dans lequel vous pouvez aussi bien réordonner le chargement des données que les éléments du schéma. Ce format est aussi compressé par défaut.[/col][/row][/table][/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_dump[/b] et le serveur de base de données. [b]pg_dump[/b] peut manipuler des bases de données de version antérieure de PostgreSQL, mais les très anciennes versions ne sont plus compatibles (antérieure à la version 7.0). Utilisez cette option si vous avez besoin d'ignorer la vérification de version (et si [b]pg_dump[/b] échoue alors, vous ne pourrez pas dire que vous n'aurez pas été prévenu).[/col][/row][/table] [table][row][col]    [/col][col][b]-n[/b] [i]namespace[/i][b][/b][/col][/row][/table] [table][row][col]    [/col][col][b]--schema=[/b][i]schema[/i][b][/b] Sauvegarde le contenu du [i]schema[/i] seulement. Si cette option n'est pas spécifiée, tous les schémas non système de la base de données cible seront sauvegardés. [table][row][col]    [/col][col] [b]Note :[/b] Dans ce mode, [b]pg_dump[/b] ne fait aucune tentative pour sauvegarder n'importe quels objets de la base de données qui dépendraient d'autres objets précédent du schéma séléctionné. C'est pourquoi, il n'y a aucune garantie que le résultat de la sauvegarde du schéma simple peut être rechargé avec succès par lui-même dans une base de données vide. [/col][/row][/table] [/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 toutes les tables. Utilisez cette option si votre application référencie d'une certaine façon les colonnes d'OID. (Par exemple, dans une contrainte de clé étrangère). Autrement, cette option ne devrait pas être utlisée.[/col][/row][/table] [table][row][col]    [/col][col][b]-O[/b][/col][/row][/table] [table][row][col]    [/col][col][b]--no-owner[/b] Ne sort pas les commandes en initialisant le propriétaire des objets pour qu'il soit identique à la base de données originale. Par défaut, [b]pg_dump[/b] vous présente une déclaration [b]SET[/b] SESSION AUTHORIZATION pour initialiser le propriétaire des éléments du schéma en train d'être créé. Ces déclarations échoueront, sauf si le script est démarré par un superutilisateur (ou par le même utilisateur qui est propriétaire des objets dans le script). Pour faire un script qui peut être restauré par n'importe quel utilisateur, mais donnera aux objets la propriété de l'utilisateur en train de restaurer, , spécifiez [b]-O[/b]. Cette option n'est significative que pour le format texte simple. Pour les autres formats, vous devriez spécifier l'option quand vous appelez [b]pg_restore[/b].[/col][/row][/table] [table][row][col]    [/col][col][b]-R[/b][/col][/row][/table] [table][row][col]    [/col][col][b]--no-reconnect[/b] Cette option est désuette, mais reste acceptée pour une question de compatibilité avec les versions antérieures.[/col][/row][/table] [table][row][col]    [/col][col][b]-s[/b][/col][/row][/table] [table][row][col]    [/col][col][b]--schema-only[/b] Ne sauvegarde que le schéma (la définition des données), pas les données.[/col][/row][/table] [table][row][col]    [/col][col][b]-S[/b] [i]username[/i][b][/b][/col][/row][/table] [table][row][col]    [/col][col][b]--superuser=[/b][i]username[/i][b][/b] Spécifie le nom du superutilisateur à utiliser lorsque l'on désactive les mécanismes d'autentification. Cela est approprié si [b]--disable-triggers[/b] est utilisé. (D'habitude, il est meilleur de l'omettre, et au lieu de cela démarrer le script résultant comme superutilisateur.)[/col][/row][/table] [table][row][col]    [/col][col][b]-t[/b] [i]table[/i][b][/b][/col][/row][/table] [table][row][col]    [/col][col][b]--table=[/b][i]table[/i][b][/b] Sauvegarde les données d'une [i]table[/i] seulement. Il est possible de faire plusieurs tables avec le même nom si plusieurs tables ont le même nom mais appartiennent à différents schémas ; si vous êtes dans ce cas, toutes les tables correspondantes seront sauvegerdées. Spécifiez à la fois [b]--schema[/b] et [b]--table[/b] pour ne sélectionner juste qu'une seule table. [table][row][col]    [/col][col] [b]Note:[/b] Dans ce mode, [b]pg_dump[/b] ne fait aucune tentative pour sauvegarder n'importe quels objets de la base de données qui dépendraient d'autres objets précédant du schéma sélectionné. C'est pourquoi il n'a aucune garantie que le résultat de la sauvegarde du schéma simple peut être rechargé avec succès par lui-même dans une base de données vide. [/col][/row][/table] [/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_dump[/b] d'afficher des messages de progression sur la sortie d'erreur 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 le privilège de droit de sauvegarde (commandes de grant/revoke).[/col][/row][/table] [table][row][col]    [/col][col][b]-X[/b] use-set-session-authorization[/col][/row][/table] [table][row][col]    [/col][col][b]--use-set-session-authorization[/b] Cette option est désuette mais reste acceptée pour des raisons de compatibilité ascendante. [b]Pg_dump[/b] se comporte maintenant toujours par défaut dans ce mode. [/col][/row][/table] [table][row][col]    [/col][col][b]-X[/b] disable-triggers[/col][/row][/table] [table][row][col]    [/col][col][b]--disable-triggers[/b] Cette option n'est approprié que lors de création de sauvegarde contenant uniquement des données. Il charge [b]pg_dump[/b] d'inclure des commandes pour désactiver temporairement les déclenchements sur les tables cibles, tant que les données sont rechargées. Utilisez ceci si vous avez une vérification d'intégrité référentielle ou d'autres déclenchements que vous ne voulez pas invoquer sur les tables durant le rechargement des données. Actuellement, les commandes émises pour [b]--disable-triggers[/b] doivent être passées comme étant un superutilisisateur. Donc, vous devriez aussi spécifier un nom de superutilisateur avec [b]-S[/b], ou être de préférence prudent de commencer le script résultant comme superutilisateur. Cette option n'est significative que pour le format texte simple. Pour les autres formats, vous devriez spécifier l'option quand vous appellez [b]pg_restore[/b].[/col][/row][/table] [table][row][col]    [/col][col][b]-Z[/b] [i]0..9[/i][b][/b][/col][/row][/table] [table][row][col]    [/col][col][b]--compress=[/b][i]0..9[/i][b][/b] Spécifie un niveau de compression à utiliser dans les formats d'archives qui gèrent la compression. (Actuellement seules les archives au format personnalisé supportent la compression.) [/col][/row][/table] Les options de lignes de commandes suivantes contrôlent les paramètres de connexion aux bases de données. [table][row][col]    [/col][col][b]-h[/b] [i]host[/i][b][/b][/col][/row][/table] [table][row][col]    [/col][col][b]--host=[/b][i]host[/i][b][/b] Spécifie le nom d'hébergement de la machine sur laquelle le serveur tourne. Si la valeur commence par un slash, le paramètre est utilisé comme un répertoire pour une connection à un répertoire de 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 à un répertoire de domaine Unix est tentée.[/col][/row][/table] [table][row][col]    [/col][col][b]-p[/b] [i]port[/i][b][/b][/col][/row][/table] [table][row][col]    [/col][col][b]--port=[/b][i]port[/i][b][/b] Spécifie le port TCP ou l'extension de fichier local pour la connexion au domaine Unix sur lequel le serveur écoute les tentatives de connexions. Par défaut la variable d'environnement est [b]PGPORT[/b] , si elle est inutilisée, ou la variable utilisée lors de la compilation du serveur.[/col][/row][/table] [table][row][col]    [/col][col][b]-U[/b] [i]username[/i][b][/b] Connecte sous le nom donné.[/col][/row][/table] [table][row][col]    [/col][col][b]-W[/b] Force la demande de mot de passe. Cela devrait arriver automatiquement si le serveur demande des authentifications par mot de passe. [/col][/row][/table] [size=18] [b]Environnement[/b] [/size] [table][row][col]    [/col][col][b]PGDATABASE[/b][/col][/row][/table] [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 par defaut de connexion. [/col][/row][/table] [size=18] [b]Diagnostiques[/b] [/size] [b]pg_dump[/b] exécute en interne des déclarations en [b]SELECT[/b]. Si vous avez des problèmes à exécuter [b]pg_dump[/b], soyez sûr d'avoir les droits de sélection d'informations sur la base de données utilisée, par exemple, [b]psql[/b](1). [size=18] [b]Notes[/b] [/size] Si votre groupe de base de données a des compléments locaux à la base de données template1, faites attention de bien restaurer dans une base de données vraiment vide avec [b]pg_dump[/b] ; autrement vous aurez probablement des erreurs dues à des duplications de définitions des objets ajoutés. Pour faire une base de données vide sans additions locales, copiez depuis template0 pas de template1, Par exemple : .nf CREATE DATABASE foo WITH TEMPLATE template0; .fi [b]pg_dump[/b] a quelques petites limitations: [table][row][col]    [/col][col](bu Lors du déchargement d'une seule table ou lors d'une création d'archive comme texte plein, [b]pg_dump[/b] ne manipule pas les objets larges. Les objets larges doivent être déchargés avec la base de données entière en utilisant une des archives au format non texte.[/col][/row][/table] [table][row][col]    [/col][col](bu Lorsqu'une sauvegarde des données seulement est utilisée et que l'option [b]--disable-triggers[/b] est utilisée, [b]pg_dump[/b] émet des commandes pour désactiver les déclenchements sur les tables utilisées avant d'insérer les données et les commandes pour réactiver les déclenchements après que les données soient insérées. Si la restauration est arrêtée au milieu, le catalogue système peut être laissé dans un mauvais état.[/col][/row][/table] Les membres d'une archive de type tar sont limités à une taille inférieure à 8 GB. (Ceci est inhérent à la limitation d'un fichier au format tar.) C'est pourquoi ce format ne peut pas être utilisé si une représentation textuelle d'une table excède cette taille. La taille totale d'une archive tar et n'importe quels autres formats de sortie ne sont pas limités, exeption faite du système d'exploitation. Une fois terminé, il serait sage d'exécuter [b]ANALYZE[/b] sur chacune des tables restaurées, ainsi l'optimiseur aura des statistiques utiles. [size=18] [b]Exemples[/b] [/size] Pour sauvegarder une base de données : .nf $ [b]pg_dump[/b] mydb > db.out .fi Pour recharger cette même base de données : .nf $ [b]psql[/b] -d database -f db.out .fi Pour sauvegarder une base de données appellée mydb qui contient des objets larges dans un fichier [i]tar[/i] : .nf $ [b]pg_dump[/b] -Ft -b mydb > db.tar .fi Pour recharger cette même base de données (avec des objets larges) dans une base de données existante appellée newdb : .nf $ [b]pg_restore[/b] -d newdb db.tar .fi [size=18] [b]Historique[/b] [/size] L'utilitaire [b]pg_dump[/b] est apparu la première fois dans [b]Postgres95[/b] release 0.02. Les formats de sortie non texte plein ont été introduits depuis PostgreSQL release 7.1. [size=18] [b]Voir aussi[/b] [/size] [b]pg_dumpall[/b](1), [b]pg_restore[/b](1), [b]psql[/b](1) [size=18] [b]Traduction[/b] [/size] Christophe Labarthe, 2003. [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