restaurer postgres depuis un dump — répéter, pas prier
restaurer une base postgres depuis un dump : lire le manifeste, restaurer vers une base scratch (pg_restore -j4 --no-owner), compter les tables, puis basculer.
Deux fichiers sont posés dans le dossier de sauvegarde en ce moment même. L'un date du 9 octobre : 1,767,542 octets, nommé .sql.gz — SQL brut, emballé en gzip, du genre que zcat ouvre sur n'importe quelle machine jamais construite. L'autre est arrivé à 00:00:00 aujourd'hui : 17,941,124 octets, nommé .dump.zst. Le nom dit zstd. Le fichier n'est pas un fichier zstd. L'écart entre ce que promet un nom de fichier et ce que sont les octets, c'est toute la raison d'être de l'exercice de restauration — et le fossile d'octobre reste sur disque exprès, en souvenir de l'époque où personne ne demandait quel format la sauvegarde avait vraiment.
Pour restaurer un dump postgres : lisez le manifeste avec
pg_restore --list your.dump, puispg_restore -j4 --no-owner -d scratch_db your.dump, comptez les tables, et ne basculez que lorsque les comptes concordent. Le manifeste vous donne le format, la compression et le nombre de tables attendues — avant que quoi que ce soit ne soit restauré. La base scratch est le modèle de sécurité : la base en production ne voit jamais un octet tant que le contrôle du compte n'a pas passé.
Dernier test 2026-11-17 · PostgreSQL 18 · le dossier public plus la lecture du manifeste de ce matin sur le dump nocturne en production. Pas de VM, pas de banc — les reçus, c'est la file de sauvegarde permanente, lus là où elle tourne.
Comment restaurer une base postgres depuis un dump ?
Tout l'exercice tient en trois commandes et un compte : lire le manifeste, restaurer vers scratch, faire concorder le nombre de tables — puis basculer. Rien d'autre ne touche une base en production. Les étapes ci-dessous sont la recette répétée du dossier ; l'étape 1 a été refaite ce matin sur le dump frais, et les reçus sont collés sans retouche.
Étape 1 — la lecture du manifeste. C'est le reçu qui décide de tout le reste :
$ pg_restore --list nightly.dump.zst | tail -9
;
; Archive created at 2026-11-17 00:00:00 UTC
; dbname: mrsn
; TOC Entries: 128
; Compression: zstd
; Dump Version: 1.16-0
; Format: CUSTOM
; Integer: 4 bytes
; Offset: 8 bytes
vérif : collé depuis la lecture de ce matin — exit 0, stderr vide, grep -c 'TABLE DATA' dit 20. Cinq secondes, zéro écriture, et vous savez désormais le format (CUSTOM), la compression (zstd, pliée dans les membres de l'archive), l'heure de création (00:00:00 — le timer est arrivé à la seconde près) et le nombre de tables à exiger plus tard.
Étape 2 — restaurer vers une base scratch. Jamais celle de production :
$ createdb restore_drill
$ pg_restore -j4 --no-owner -d restore_drill nightly.dump.zst
$ psql -d restore_drill -Atc "select count(*) from pg_tables where schemaname='public'"
19
vérif : la recette répétée du dossier — cette forme a servi pour de vrai lors de la bascule qui a retiré la voie du SQL brut (2026-10-10, réessayée le 10-04). -j4 parallélise le chargement ; --no-owner évite que la restauration meure sur des rôles absents de la machine qui restaure ; la base scratch est tout le modèle de sécurité.
Comment prouver que la restauration a vraiment marché ?
Le contrôle du compte : le nombre de TABLE DATA du manifeste et le nombre de tables de la base restaurée doivent concorder avant toute bascule. Le manifeste de ce matin dit 20 ; le schéma public dit 19. La vingtième n'est pas une table manquante — c'est la comptabilité des migrations qui vit dans son propre schéma (drizzle.__drizzle_migrations sur une base gérée par drizzle). Comptez la bonne chose : le manifeste compte tous les schémas, votre application compte public. Un compte qui concorde avec un écart d'un schéma connu, c'est un passage ; un compte en déficit sans explication, c'est une restauration partielle — et une restauration partielle qui bascule, c'est ainsi qu'on programme une panne.
« Une sauvegarde que vous n'avez jamais restaurée est une rumeur avec un horodatage. »
La rotation garde 14 dumps nocturnes — quatorze chances par mois de découvrir une archive pourrie la seule nuit où vous en avez besoin. L'exercice coûte dix minutes et une base scratch ; la rumeur coûte la panne.
Pourquoi pg_restore refuse-t-il votre fichier dump ?
Parce que le suffixe est un déguisement. Le dump de ce matin s'appelle .zst, et le zstd de la machine elle-même le refuse :
$ zstd -l nightly.dump.zst
File "nightly.dump.zst" not compressed by zstd
vérif : collé, sans retouche, depuis la lecture de ce matin. Les octets sont une archive au format CUSTOM dont les membres portent la compression zstd — pg_restore l'ouvre nativement, zcat imprime du confetti binaire, et pipeter ce confetti dans psql produit des erreurs de grammaire qui ressemblent trait pour trait à un dump cassé. Le dump allait bien. C'est l'outil qui se trompait.
Trois formes de fichiers, trois lecteurs — voilà toute la table :
| suffixe que vous verrez | ce que sont les octets | le seul lecteur | ce que fait zcat |
|---|---|---|---|
.sql | texte SQL brut | psql -f | l'imprime, inutilement |
.sql.gz | SQL brut gzippé | zcat | psql | marche — l'honnête |
.dump, .dump.zst, n'importe quel nom | archive CUSTOM, membres zstd à l'intérieur | pg_restore | confetti, puis chaos |
vérif : la ligne .sql.gz est le fossile d'octobre, toujours posé à côté du dump du jour — le dernier artefact de l'ère du SQL brut, gardé exprès.
Deux pièges de plus, tous deux gravés dans le dossier à la manière forte : un binaire pg_restore compilé sans zstd (pré-16) échoue sur des archives qu'il devrait lire — la compression vit dans l'archive, donc le lecteur a besoin du codec ; prenez le pg_restore d'une image postgres 16+. Et les erreurs de propriété (role "x" does not exist) meurent sur --no-owner — n'ajoutez --role= que si vous devez remapper.
La feuille de commandes complète, y compris la forme docker
# 1. the manifest — before anything
pg_restore --list /path/to/nightly.dump.zst
# 2. scratch restore
createdb restore_drill
pg_restore -j4 --no-owner -d restore_drill /path/to/nightly.dump.zst
# 3. count-gate, both sides
psql -d restore_drill -Atc "select schemaname, count(*) from pg_tables group by 1 order by 1"
# in a compose setup, the same drill runs through the container:
docker exec -it your-db pg_restore --list /backups/latest.dump
docker exec -it your-db pg_restore -j4 --no-owner -d restore_drill /backups/latest.dumpLe dump nocturne lui-même est un travail de timer — le même timer dont les habitudes de réveil ont été mesurées dans "systemd timer accuracysec — the drift nobody measured" (2026-11-14). Le tampon de création 00:00:00 dans le manifeste ci-dessus, c'est ce timer arrivant exactement à son marqueur ; l'exercice, c'est ce qui se passe quand le marqueur mérite la confiance.
REÇUS DU DOSSIER PUBLIC · PostgreSQL 18 · manifeste lu le 2026-11-17 sur le vrai dump nocturne · pas de VM, pas de banc
Une lecture avant la restauration — le manifeste. Un compte après — les tables. Les deux concordent, ou rien ne bascule.