Как устроены миграции в Liquibase?

Liquibase — это библиотека с открытым исходным кодом для отслеживания, управления и применения изменений схемы базы данных. Она решает проблему "дрейфа схемы" между окружениями, обеспечивая, чтобы структура базы данных в разработке, тестировании и продакшене была согласованной и контролируемой.

Ключевые компоненты

• Changelog (Журнал изменений): Главный файл, который ссылается на все отдельные изменения. Он может быть в форматах XML, YAML, JSON или SQL.
• Changeset (Набор изменений): Атомарная единица изменения внутри changelog. Каждый changeset имеет уникальный идентификатор (id) и автора (author), что вместе образует уникальный ключ.
• Служебные таблицы: Liquibase создает и использует таблицы DATABASECHANGELOG и DATABASECHANGELOGLOCK для отслеживания примененных changeset'ов и предотвращения параллельного выполнения.

Как это работает

При запуске Liquibase читает ваш master changelog, проверяет, какие changeset'ы еще не применены (сверяясь с таблицей DATABASECHANGELOG), и выполняет их в порядке объявления. Каждое изменение (добавление таблицы, колонки, индекса) описывается декларативно или с помощью SQL.

Пример changeset в формате YAML

databaseChangeLog:
  - changeSet:
      id: 1
      author: dev
      changes:
        - createTable:
            tableName: users
            columns:
              - column:
                  name: id
                  type: int
                  constraints:
                    primaryKey: true
                    nullable: false
              - column:
                  name: username
                  type: varchar(50)
                  constraints:
                    nullable: false
  - changeSet:
      id: 2
      author: dev
      changes:
        - addColumn:
            tableName: users
            columns:
              - column:
                  name: email
                  type: varchar(100)

Откат изменений (Rollback)

Одна из мощных возможностей Liquibase — поддержка отката. Для каждого changeset можно определить операцию rollback. Это может быть автоматически сгенерированная команда (например, для createTable — dropTable) или явно указанный SQL. Это позволяет откатить базу к предыдущему состоянию, что критично для отладки или отмены ошибочных релизов.

Где применяется

Liquibase интегрируется в процесс CI/CD. Миграции применяются автоматически при развертывании приложения, часто как часть шага сборки или запуска контейнера. Это стандартный подход в Java-экосистеме (часто с Spring Boot), но инструмент поддерживает множество СУБД (PostgreSQL, MySQL, Oracle и др.).

Вывод: Liquibase стоит применять в любом проекте, где база данных эволюционирует со временем, особенно в командной разработке и при наличии нескольких окружений. Он обеспечивает предсказуемость, версионность и возможность отката изменений схемы БД, что значительно снижает риски при развертывании.