Accueil › SQL & bases de données › Flyway, Liquibase : versionner le schéma
Flyway, Liquibase : versionner le schéma
Migrations de schémaavance
Le schéma est du code : il se versionne, se relit et se déploie comme le reste.
src/main/resources/db/migration/
V1__schema_initial.sql
V2__ajout_table_paiement.sql
V3__index_commande_client.sql
R__vue_commande_detail.sql ← répétable : rejouée quand son contenu change
-- V3__index_commande_client.sql
CREATE INDEX CONCURRENTLY IF NOT EXISTS commande_client_id_idx
ON commande (client_id);
Flyway applique les migrations manquantes dans l'ordre, une seule fois, et enregistre leur empreinte dans flyway_schema_history.
La règle d'or : une migration livrée est immuable. Modifier un script déjà appliqué fait échouer le démarrage (Migration checksum mismatch). Pour corriger, on ajoute une migration.
Le corollaire : ddl-auto: update est proscrit. Hibernate modifierait le schéma au démarrage, sans revue, sans historique, sans jamais rien supprimer. En production :
spring.jpa.hibernate.ddl-auto=validate
spring.flyway.enabled=true
validate vérifie au démarrage que les entités correspondent au schéma : une divergence est détectée immédiatement, plutôt qu'à la première requête.
Les termes à connaître
- Migration
Un script qui fait passer le schéma d'une version à la suivante. Versionné avec le code, appliqué dans l'ordre, une seule fois par environnement.
- Flyway
Outil de migration par fichiers SQL nommés
V1__description.sql. Simple, transparent : ce qui est écrit est ce qui est exécuté.- Liquibase
Outil par changesets décrits en XML, YAML ou SQL. Plus verbeux, mais il gère nativement le
rollbacket l'abstraction multi-SGBD.- Table d'historique
flyway_schema_historyoudatabasechangelog: la table où l'outil enregistre les migrations appliquées, avec leur somme de contrôle.- Somme de contrôle (*checksum*)
L'empreinte d'un script déjà appliqué. La modifier fait échouer le démarrage : une migration livrée est immuable, on en ajoute une nouvelle pour corriger.
- Migration répétable
Un script
R__nom.sqlrejoué à chaque changement de son contenu. Idéal pour les vues, fonctions et triggers, qu'on redéfinit plutôt qu'on ne modifie.
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.