Accueil › Node.js › Les migrations
Les migrations
ORM et migrationsintermediaire
Une migration est un fichier versionné, appliqué une fois, dans l'ordre. Trois propriétés, et chacune a une conséquence pratique.
Le fichier
-- migrations/20260312140322_ajout_telephone/migration.sql
ALTER TABLE "clients" ADD COLUMN "telephone" text;
CREATE INDEX "clients_telephone_idx" ON "clients" ("telephone");
Il est dans le dépôt, relu en revue de code, et versionné avec le code qui en dépend. Une base ne se met pas à jour « à la main en se connectant » : elle se met à jour par un fichier qu'on peut lire six mois plus tard.
Une seule fois, dans l'ordre
SELECT migration_name, finished_at FROM _prisma_migrations ORDER BY finished_at;
La base retient ce qui est déjà passé. L'outil soustrait, et applique le reste
par ordre de nom — d'où l'horodatage en préfixe. C'est ce qui rend
migrate deploy sûr à relancer autant de fois qu'on veut.
La règle qui n'a pas d'exception
Une migration appliquée quelque part ne se modifie plus. Jamais.
Corriger le fichier ne le rejouera nulle part où il est déjà passé, et le jouera corrigé partout ailleurs. Les environnements cessent de se ressembler, et rien ne les réconciliera. C'est pour cela que les outils enregistrent une empreinte du contenu et refusent d'avancer quand elle a changé.
Une erreur dans une migration appliquée se corrige par une migration suivante.
« Comment on revient ? »
Cette question se pose pendant l'incident, à deux heures du matin, jamais avant. Donc la réponse s'écrit avant — même quand l'outil ne génère pas le retour.
-- Aller
ALTER TABLE commandes ADD COLUMN devise text NOT NULL DEFAULT 'EUR';
-- Retour, à écrire en commentaire si l'outil ne le fait pas
-- ALTER TABLE commandes DROP COLUMN devise;
Une migration qui supprime une colonne n'est pas réversible : les données sont parties. Savoir le dire avant de la déployer change la décision.
Les termes à connaître
- Migration
Un fichier versionné, appliqué une seule fois, dans un ordre fixé. C'est la seule façon de faire évoluer une base dont on ne peut pas perdre le contenu.
- Table de journal
La table où la base garde la liste des migrations déjà appliquées. C'est elle qui rend l'opération idempotente, et c'est la première chose à consulter en cas de doute.
- Empreinte
La somme de contrôle du contenu d'une migration, enregistrée au moment de l'application. Si le fichier change ensuite, l'outil le détecte et refuse d'avancer.
- Migration manquante
Une migration enregistrée comme appliquée dont le fichier a disparu ou changé. L'historique et les fichiers ne décrivent plus la même base, et aucun outil ne peut deviner laquelle est juste.
- Réversibilité
Savoir dire comment on revient. La question se pose toujours pendant l'incident, jamais avant — donc la réponse s'écrit avant.
- Base ombre
Une base jetable où l'outil rejoue tout l'historique pour calculer la différence avec le schéma. Elle n'existe qu'en développement.
- Migration de données
Une migration qui déplace ou remplit des valeurs, pas seulement des colonnes. Elle doit traiter les lignes par lots, parce qu'un seul
UPDATEsur dix millions de lignes tient un verrou pendant des minutes.
Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.