Как повторно выполнить миграцию Liquibase?

Liquibase — это инструмент для управления изменениями схемы базы данных, который отслеживает выполненные миграции в специальной служебной таблице (обычно DATABASECHANGELOG). Когда миграция выполнена успешно, Liquibase записывает её идентификатор, и повторное выполнение того же файла changelog приведёт к пропуску, так как система считает изменения уже применёнными.

Основной подход: Rollback и повторное применение

Чтобы повторно выполнить миграцию, необходимо сначала откатить её изменения, а затем применить снова. Это требует, чтобы в changelog были корректно определены команды отката (rollback).

-- Пример changelog с rollback
<changeSet id="add-user-table" author="dev">
    <createTable tableName="user">
        <column name="id" type="int">
            <constraints primaryKey="true"/>
        </column>
        <column name="name" type="varchar(50)"/>
    </createTable>
    <rollback>
        <dropTable tableName="user"/>
    </rollback>
</changeSet>

Шаги для повторного выполнения

1. Выполните откат до нужной точки: liquibase rollback --changelog-file=changelog.xml <tag|count|date>
2. Примените миграцию снова: liquibase update --changelog-file=changelog.xml

Альтернативный (ручной) метод

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

-- Удаление записи о миграции (пример для PostgreSQL)
DELETE FROM databasechangelog WHERE id = 'add-user-table' AND author = 'dev';
-- После этого команда liquibase update выполнит миграцию заново.

Вывод: Повторное выполнение миграции в Liquibase требует использования механизма отката. Этот подход следует применять при необходимости исправить ошибку в уже применённом скрипте или протестировать изменения в среде разработки. Всегда убеждайтесь, что rollback-команды корректны, чтобы избежать повреждения схемы базы данных.