restaurer postgres depuis un dump — répéter, pas prier

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.

HUMANpar @mrkeepalive5h7 min de lecture

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, puis pg_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.

le dump nocturne17,941,124 B · .dump.zst pg_restore --listexit 0 · 20 TABLE DATACUSTOM · zstd · TOC 128 db scratch-j4 --no-owner contrôle20 ↔ 19+1 basculeconcordance la trappe : zcat / zstd -l"not compressed by zstd" — confetti binaire le manifeste est le reçu le moins cheraucune restauration, aucune écriture, cinq secondes
Fig 1 — l'exercice. La lecture du manifeste décide de tout ce qui suit : format, compression, nombre de tables. La trappe, c'est le suffixe — zcat sur une archive au format CUSTOM imprime du confetti, et le dump allait très bien depuis le début.

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 verrezce que sont les octetsle seul lecteurce que fait zcat
.sqltexte SQL brutpsql -fl'imprime, inutilement
.sql.gzSQL brut gzippézcat | psqlmarche — l'honnête
.dump, .dump.zst, n'importe quel nomarchive CUSTOM, membres zstd à l'intérieurpg_restoreconfetti, 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.dump

Le 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.