PostgreSQL 022 – Commande COPY : export et import…

TL;DR

pg_dump, pg_dumpall et pg_restore réalisent des sauvegardes logiques à des granularités différentes. Cet épisode cherche à produire une sauvegarde restaurable avec rôles, propriétaires et extensions maîtrisés. La vidéo est intégrée dans l’article et les références ont été actualisées pour éviter de présenter une pratique historique comme une recommandation actuelle.

La vidéo de référence

Vidéo: https://www.youtube.com/watch?v=5jOYLikIIeU

Playlist complète: https://www.youtube.com/playlist?list=PLn6POgpklwWonHjoGXXSIXJWYzPSy2FeJ

Cet article correspond à l’épisode 22 sur 34. Le chapitre GitLab associé est 21-pg_dump. Les fichiers utiles détectés sont: 21-pg_dump/slides.md.

Définition simple : Commande COPY : export et import personnalisés

pg_dump, pg_dumpall et pg_restore réalisent des sauvegardes logiques à des granularités différentes.

Pour raisonner correctement, séparez toujours la configuration déclarée, l’état réellement appliqué et la preuve observée. Une commande terminée sans erreur ne prouve pas à elle seule la disponibilité, la sécurité, la persistance ou la capacité de restauration.

Quel problème cet épisode résout-il ?

Le besoin concret consiste à produire une sauvegarde restaurable avec rôles, propriétaires et extensions maîtrisés. Le sujet doit être replacé dans son contexte: taille de l’environnement, version, niveau de criticité, dépendances et compétences de l’équipe.

Une bonne validation part d’un exemple minimal, observe les objets créés, provoque un changement contrôlé puis vérifie le résultat avec un outil indépendant de la commande de création.

Points clés du support Xavki

• important mais cela reste une image
• complémentaire à l’archive log
• pas de méthode unique => à adapter à sa situation
• ne copie pas les users et autres spécifiques à l’instance
• deux outils (complémentaires) :
• pgdump : personnalisation au maximum
• pgdumpall : backup intégral de l’instance (y compris users…)

Ces éléments viennent du dépôt lorsqu’un chapitre correspondant existe. Ils servent de point de départ; la documentation officielle citée plus bas précise le comportement des versions actuelles.

Mise à jour par rapport à la vidéo

Une sauvegarde n’est validée qu’après un test de restauration. pg_dump ne remplace pas une sauvegarde physique ou PITR.

Avant d’utiliser une commande en production, vérifiez la version installée, les notes de migration et les paramètres devenus obsolètes. Les exemples de formation restent utiles pour comprendre le modèle, mais une option ou une architecture peut avoir évolué.

Commandes et éléments pratiques

psql xavier > dumps_xavier.sql
psql -f dump_xavier.sql -d xavier
psql xavier | gzip -c > dump.xavier.sql.gz
pg_dump -Fc xavier -f dump_xavier_fc.dmp
pg_dump -Fc xavier --datas-only -f dump_xavier_fc.dmp
psql --schemas-only -f dump_xavier.sql -d xavier

Les commandes extraites peuvent contenir des valeurs de lab. Adaptez chemins, adresses, credentials, versions et noms de ressources. Ne placez jamais un secret réel dans un dépôt, une variable affichée ou un state non protégé.

Méthode de diagnostic

1. Noter la version exacte et la configuration effective.
2. Vérifier le service, le processus ou l’objet cible avant le client applicatif.
3. Lire les logs au moment précis du test.
4. Contrôler réseau, permissions, stockage et dépendances séparément.
5. Produire une preuve positive, puis tester un cas d’échec contrôlé.
6. Documenter la procédure de retour arrière ou de restauration.

Cette méthode évite les diagnostics circulaires où le même outil crée et valide sa propre configuration. Pour une plateforme distribuée, contrôlez aussi quorum, réplication, latence, capacité et comportement pendant une perte partielle.

Pièges fréquents

• copier une commande ancienne sans vérifier la version actuelle;
• considérer le succès d’une commande comme une preuve de résilience;
• mélanger lab, développement et exigences de production;
• ignorer les données persistantes, secrets ou états intermédiaires;
• ajouter de la haute disponibilité sans tester le split brain ou la restauration;
• optimiser avant d’avoir défini une métrique et un objectif.

Bonnes pratiques

• versionner les fichiers de configuration et conserver un historique lisible;
• épingler les versions importantes et suivre les notes de publication;
• séparer accès administrateur et accès applicatif;
• appliquer le moindre privilège;
• sauvegarder les données et tester les restaurations;
• superviser la plateforme avec des signaux indépendants;
• automatiser uniquement après avoir compris le chemin manuel minimal.

Mini-lab conseillé

Reproduisez le scénario avec des noms dédiés au lab. Capturez l’état initial, appliquez une modification unique et comparez l’état final. Supprimez ou arrêtez ensuite une dépendance pour observer le comportement dégradé, puis restaurez le service avec la procédure documentée.

Références externes

• postgresql.org/docs/18/backup.html
• postgresql.org/docs/18/app-pgdump.html
• postgresql.org/docs/18/app-pg-dumpall.html
• postgresql.org/docs/18/app-pgrestore.html

Ces références sont volontairement limitées à des sources officielles ou primaires. Elles complètent la vidéo et le dépôt sans multiplier les liens génériques.

Liens Xavki

• Vidéo de cet épisode
• Playlist PostgreSQL
• Dépôt GitLab tutorials-postgresql

Continuer la série

• Épisode précédent: PostgreSQL 021 – Logs : configuration, DDL, formats…
• Épisode suivant: PostgreSQL 023 – Sauvegardes : pg_dump

FAQ

Cet article remplace-t-il la documentation officielle ?

Non. Il fournit un chemin pédagogique en français, relie la vidéo au support Xavki et signale les évolutions importantes. La référence comportementale reste la documentation de la version réellement installée.

Puis-je reprendre directement les commandes en production ?

Non sans adaptation. Vérifiez versions, chemins, permissions, réseau, secrets, capacité et stratégie de retour arrière. Commencez par un environnement de test représentatif.

Comment savoir si le lab est réellement réussi ?

Définissez une preuve avant le test: état attendu, requête, métrique, log, donnée persistante ou comportement lors d’une panne. Vérifiez ensuite cette preuve avec un outil indépendant.

Pourquoi conserver plusieurs liens externes ?

La vidéo explique la progression, le dépôt fournit les artefacts et les références externes documentent la version actuelle. Cette triangulation améliore la fiabilité pour le lecteur, les moteurs de recherche et les systèmes de recherche assistée par LLM.

Conclusion

L’épisode 22/34, Commande COPY : export et import personnalisés, apporte une étape précise au parcours PostgreSQL. Retenez surtout le modèle mental, la preuve attendue et les limites de version. Une pratique devient fiable lorsqu’elle est reproductible, observable et restaurable.