Accueil › Déploiement & mise en production › Migrer un schéma sans couper le service
Migrer un schéma sans couper le service
La base de données en productionintermediaire
Trois règles, et elles suffisent à éviter l'essentiel des incidents de base.
1. Des migrations versionnées, jamais ddl-auto=update.
spring.jpa.hibernate.ddl-auto=validate
spring.flyway.enabled=true
src/main/resources/db/migration/
V1__schema_initial.sql
V2__ajout_table_panier.sql
V3__index_commande_client.sql
validate vérifie que le schéma correspond aux entités et refuse de démarrer sinon. C'est exactement le comportement voulu : échouer au démarrage plutôt qu'à la première requête.
2. Une migration appliquée ne se modifie jamais. L'outil garde une empreinte de chaque script. Changer un fichier déjà passé fait échouer le démarrage des bases concernées, pendant qu'une base neuve reçoit la version corrigée. On corrige par une nouvelle migration.
3. Expansif d'abord, destructif ensuite. Pendant un déploiement progressif, l'ancienne et la nouvelle version du code tournent en même temps. Tout ce que l'ancienne attend doit rester.
-- ✅ Déploiement 1 : on ajoute, rien ne casse
ALTER TABLE client ADD COLUMN courriel VARCHAR(255);
-- ⛔ Pas tout de suite : l'ancien code lit encore « email »
ALTER TABLE client DROP COLUMN email;
Les termes à connaître
- Migration versionnée
Script SQL numéroté, joué une seule fois et jamais modifié après coup. Flyway et Liquibase tiennent une table de suivi qui enregistre ce qui a été appliqué, quand, et avec quelle empreinte.
- Migration expansive
Changement qui n'enlève rien : ajouter une colonne nullable, un index, une table. L'ancien code continue de fonctionner — c'est ce qui rend le déploiement progressif possible.
- Migration destructive
Changement qui retire ou renomme : supprimer une colonne, la renommer, resserrer une contrainte. Casse immédiatement tout code qui ne l'attend pas.
- Expand / contract
Méthode en trois déploiements : on ajoute (expand), on migre le code, puis on retire (contract). C'est la seule façon de renommer une colonne sans interruption de service.
- ddl-auto
Propriété Hibernate pilotant la synchronisation du schéma. En production :
validate— il vérifie et refuse de démarrer en cas d'écart.updatemodifie la base à l'aveugle,create-dropl'efface.- Verrou de migration
Verrou posé par l'outil pour qu'une seule instance applique les migrations quand plusieurs démarrent en même temps. Sans lui, deux exemplaires jouent le même script simultanément.
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.