Formations — 1 037 leçons en français

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 rollback et l'abstraction multi-SGBD.

Table d'historique

flyway_schema_history ou databasechangelog : 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.sql rejoué à chaque changement de son contenu. Idéal pour les vues, fonctions et triggers, qu'on redéfinit plutôt qu'on ne modifie.

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.