Какие знаешь инструменты для миграции базы данных?

Инструменты для миграции базы данных

Миграция БД - это управление изменениями схемы БД со временем. В Java экосистеме есть несколько мощных инструментов для этого, каждый со своими преимуществами и недостатками.

1. Flyway - простота и надёжность

Популярный инструмент для миграции, основанный на SQL скриптах:

<!-- pom.xml -->
<dependency>
    <groupId>org.flywaydb</groupId>
    <artifactId>flyway-core</artifactId>
    <version>10.0.0</version>
</dependency>

# application.properties
spring.flyway.locations=classpath:db/migration
spring.flyway.baseline-on-migrate=true

-- db/migration/V1__Initial_schema.sql
CREATE TABLE users (
    id BIGSERIAL PRIMARY KEY,
    email VARCHAR(255) NOT NULL UNIQUE,
    name VARCHAR(100),
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

CREATE TABLE posts (
    id BIGSERIAL PRIMARY KEY,
    user_id BIGINT NOT NULL,
    title VARCHAR(255),
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    FOREIGN KEY (user_id) REFERENCES users(id) ON DELETE CASCADE
);

-- db/migration/V2__Add_posts_table.sql
ALTER TABLE posts ADD COLUMN updated_at TIMESTAMP;
CREATE INDEX idx_posts_user_id ON posts(user_id);

-- db/migration/V3__Add_status_column.sql
ALTER TABLE users ADD COLUMN status VARCHAR(50) DEFAULT 'ACTIVE';

Особенности Flyway:

• Версионирование миграций (V1__, V2__)
• Undo миграции (U1__) - возврат к предыдущему состоянию
• Callback миграции (перед/после)
• Простота: чистый SQL
• Поддержка всех БД (PostgreSQL, MySQL, Oracle, etc.)

// Программный запуск
public class DatabaseMigration {
    public static void main(String[] args) {
        Flyway flyway = Flyway.configure()
            .dataSource("jdbc:postgresql://localhost/mydb", "user", "password")
            .locations("classpath:db/migration")
            .load();
        
        // Проверить статус
        flyway.info();
        
        // Выполнить миграции
        flyway.migrate();
        
        // Вернуться на предыдущую версию
        flyway.undo();
        
        // Очистить БД (осторожно в production!)
        flyway.clean();
    }
}

2. Liquibase - XML/YAML конфигурация

Более мощный инструмент с поддержкой разных форматов:

<!-- 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.0.xsd">

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

    <changeSet id="2" author="dev">
        <createTable tableName="posts">
            <column name="id" type="BIGINT" autoIncrement="true">
                <constraints primaryKey="true"/>
            </column>
            <column name="user_id" type="BIGINT">
                <constraints nullable="false"
                    foreignKeyName="fk_posts_users"
                    references="users(id)"/>
            </column>
            <column name="title" type="VARCHAR(255)"/>
        </createTable>
    </changeSet>

    <changeSet id="3" author="dev">
        <addColumn tableName="posts">
            <column name="updated_at" type="TIMESTAMP"/>
        </addColumn>
        <createIndex indexName="idx_posts_user" tableName="posts">
            <column name="user_id"/>
        </createIndex>
    </changeSet>

</databaseChangeLog>

# Альтернативно - YAML формат
db:
  changelog-master.yaml

databaseChangeLog:
  - changeSet:
      id: "1"
      author: "dev"
      changes:
        - createTable:
            tableName: users
            columns:
              - column:
                  name: id
                  type: BIGINT
                  autoIncrement: true
                  constraints:
                    primaryKey: true
              - column:
                  name: email
                  type: VARCHAR(255)
                  constraints:
                    nullable: false
                    unique: true

Особенности Liquibase:

• XML, YAML, JSON, SQL форматы
• Более гибкая система управления
• Rollback поддержка
• Контроль очередности миграций
• Генерирование инструкций для разных БД

public class LiquibaseMigration {
    public static void main(String[] args) throws Exception {
        Database database = DatabaseFactory.getInstance()
            .findCorrectDatabaseImplementation(
                new JdbcConnection(getConnection())
            );
        
        Liquibase liquibase = new Liquibase(
            "db/changelog/db.changelog-master.xml",
            new ClassLoaderResourceAccessor(),
            database
        );
        
        // Выполнить все ожидающие миграции
        liquibase.update(new Contexts());
        
        database.close();
    }
}

3. Alembic - для SQLAlchemy (Python, но часто используется)

Если используется SQLAlchemy ORM:

# alembic/versions/001_initial_schema.py
from alembic import op
import sqlalchemy as sa

def upgrade():
    op.create_table(
        'users',
        sa.Column('id', sa.Integer(), nullable=False),
        sa.Column('email', sa.String(length=255), nullable=False),
        sa.Column('name', sa.String(length=100)),
        sa.PrimaryKeyConstraint('id'),
        sa.UniqueConstraint('email')
    )

def downgrade():
    op.drop_table('users')

4. Spring Data JPA - встроенная система

Для Java приложений на Spring Boot:

@Entity
@Table(name = "users")
public class User {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    
    @Column(nullable = false, unique = true)
    private String email;
    
    @Column(length = 100)
    private String name;
    
    @OneToMany(mappedBy = "user", cascade = CascadeType.ALL)
    private List<Post> posts;
}

@Entity
@Table(name = "posts")
public class Post {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    
    @ManyToOne
    @JoinColumn(name = "user_id", nullable = false)
    private User user;
    
    @Column(length = 255)
    private String title;
}

# application.properties
spring.jpa.hibernate.ddl-auto=update  # create, create-drop, update, validate
spring.jpa.show-sql=true
spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.PostgreSQLDialect

Не рекомендуется для production! Используй только для разработки.

5. Goose - SQL миграции (Go, но есть Java порты)

Лёгкий инструмент с простыми SQL файлами:

-- 001_initial_schema.sql
-- +goose Up
CREATE TABLE users (
    id BIGSERIAL PRIMARY KEY,
    email VARCHAR(255) NOT NULL UNIQUE,
    name VARCHAR(100),
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

CREATE TABLE posts (
    id BIGSERIAL PRIMARY KEY,
    user_id BIGINT NOT NULL REFERENCES users(id) ON DELETE CASCADE,
    title VARCHAR(255),
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

-- +goose Down
DROP TABLE posts;
DROP TABLE users;

6. Сравнение инструментов

Инструмент | Формат     | Версионирование | Rollback | Сложность | Best For
---
Flyway     | SQL        | V1__, V2__       | Да       | Простой   | Простые проекты
Liquibase  | XML/YAML   | Гибкая           | Да       | Средняя   | Complex schemas
Hibernate  | Java Entities| Автоматическое  | Нет      | Простая   | Только dev
Goose      | SQL        | Простая          | Да       | Простой   | Lightweight
Alembic    | Python     | Явная            | Да       | Средняя   | SQLAlchemy

7. Best Practices для миграций

public class MigrationBestPractices {
    /*
    1. ОДИН файл миграции - ОДНО изменение
       Хорошо: V1__Create_users.sql, V2__Add_email_index.sql
       Плохо: V1__CreateAllTables.sql
    
    2. Используй понятные имена
       V001__Create_users_table.sql
       V002__Add_phone_to_users.sql
       V003__Create_posts_table.sql
    
    3. Тестируй миграции
       Запусти вверх -> вниз -> вверх
       Проверь что схема остаётся консистентной
    
    4. Не удаляй старые миграции
       История миграций - это история БД
    
    5. Используй транзакции
       BEGIN; ... COMMIT; для атомарности
    
    6. Для production:
       - Используй Flyway или Liquibase
       - Никогда не удаляй миграции
       - Тестируй на staging перед production
       - Имей rollback план
       - Мониторь время выполнения миграций
    
    7. Для development:
       - Можно использовать Hibernate ddl-auto
       - Или пересоздавай БД часто
    */
}

Рекомендация

Для Java приложений рекомендую:

• Flyway - простота и надёжность для большинства случаев
• Liquibase - если нужна гибкость и сложные миграции
• НЕ используй Hibernate ddl-auto в production

Все миграции должны быть:

• Версионированы и в git
• Idempotent (можно запустить несколько раз)
• Быстрыми (< 1 сек для большинства)
• Обратимыми (иметь rollback)