Formations — 1 037 leçons en français

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. update modifie la base à l'aveugle, create-drop l'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.

Lire l'explication détaillée et faire le quiz →

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.