Миграции баз данных в Java: обзор популярных инструментов

Миграции баз данных в Java: зачем это нужно и как работает

Разработка любого серьёзного приложения на Java неразрывно связана с эволюцией схемы базы данных. Добавление новых полей, изменение типов данных, создание индексов — всё это неизбежно в процессе развития проекта. Ручное выполнение SQL-скриптов на разных окружениях (локальная среда разработки, тестовый стенд, продакшн) быстро приводит к хаосу: скрипты теряются, выполняются не в том порядке, а база данных одной команды отличается от базы другой. Решение этой проблемы — миграции баз данных (database migrations).

Миграции позволяют версионировать изменения схемы, автоматически применять их в правильной последовательности и откатывать при необходимости. В мире Java существует два безусловных лидера в этой области: Flyway и Liquibase. Рассмотрим их подробнее.

Flyway: простота и надёжность

Flyway — это лёгкий, простой и мощный инструмент миграции. Его философия: «Миграции — это просто SQL или Java-классы». Основные принципы работы:

• Версионирование: каждый файл миграции имеет уникальный номер версии (например, V1__create_users.sql, V2__add_email.sql).
• Порядок выполнения: Flyway отслеживает применённые миграции в специальной таблице (flyway_schema_history) и применяет только новые.
• Два типа миграций: SQL-скрипты и Java-миграции (для сложной логики).
• Откат: поддерживаются «undo» миграции (в платной версии) или ручное написание скриптов отката.

Пример работы с Flyway

Допустим, вам нужно создать таблицу пользователей. Вы создаёте файл db/migration/V1__create_users.sql:

CREATE TABLE users (
    id BIGINT AUTO_INCREMENT PRIMARY KEY,
    username VARCHAR(50) NOT NULL,
    email VARCHAR(100) NOT NULL,
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

Затем добавляете вторую миграцию V2__add_age.sql:

ALTER TABLE users ADD COLUMN age INT;

Подключение Flyway к Spring Boot приложению происходит через application.properties:

spring.flyway.enabled=true
spring.flyway.locations=classpath:db/migration
spring.datasource.url=jdbc:postgresql://localhost:5432/mydb
spring.datasource.username=user
spring.datasource.password=pass

При запуске приложения Flyway сам проверит таблицу истории и применит все новые миграции. Если миграция уже была выполнена, она будет пропущена.

Liquibase: гибкость и контроль

Liquibase — более гибкий и мощный инструмент, который поддерживает несколько форматов описания изменений: XML, YAML, JSON и SQL. Его ключевая особенность — changesets (наборы изменений).

• Уникальный идентификатор: каждый changeset имеет id и author.
• Автоматическая генерация SQL: Liquibase может генерировать SQL под конкретную СУБД (PostgreSQL, MySQL, Oracle и др.).
• Контексты: можно разделять миграции для разных окружений (dev, test, prod).
• Откат: каждый changeset может иметь инструкцию для отката (rollback).

Пример работы с Liquibase

Пример changeset в формате XML (db/changelog/db.changelog-master.xml):

<?xml version="1.0" encoding="UTF-8"?>
<databaseChangeLog
    xmlns="http://www.liquibase.org/xml/ns/dbchangelog"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://www.liquibase.org/xml/ns/dbchangelog
    http://www.liquibase.org/xml/ns/dbchangelog/dbchangelog-4.9.xsd">

    <changeSet id="1" author="pythonlib">
        <createTable tableName="users">
            <column name="id" type="BIGINT" autoIncrement="true">
                <constraints primaryKey="true" nullable="false"/>
            </column>
            <column name="username" type="VARCHAR(50)">
                <constraints nullable="false"/>
            </column>
            <column name="email" type="VARCHAR(100)">
                <constraints nullable="false"/>
            </column>