Перейти к содержимому
Учи.Онлайн Выбрать школу
Статья

Миграции БД: Liquibase, Flyway и Alembic — как менять схему без потерь и ручных скриптов

Миграция базы данных — это файл с изменением схемы, который хранится в репозитории рядом с кодом и применяется к базе автоматически. Разработчик описывает шаг: создать таблицу, добавить столбец, построить индекс. Инструмент при запуске сверяет файлы со служебной таблицей истории в самой базе, выполняет недостающие шаги по порядку и записывает, что уже сделано. В Java-проектах для этого берут Flyway или Liquibase, в Python — Alembic. Освоить нужно формат изменений, работу таблицы истории, откат и приёмы, которые позволяют менять большие таблицы без остановки сервиса.

Автор: редакция Учи.ОнлайнОтветственный редактор: Дмитрий Игнатьев
Содержание
Иллюстрация к статье: Миграции БД: Liquibase, Flyway и Alembic — как менять схему без потерь и ручных скриптов

Новички часто считают миграцию разовым скриптом: запустил на сервере, и забыл. На деле применённый файл становится частью истории, и его больше нельзя трогать. Если поправить уже выполненную миграцию, инструмент заметит, что контрольная сумма файла не совпадает с записанной в базе, и откажется работать дальше. Ошибку исправляют новой миграцией, а не правкой старой.

Какую задачу решают миграции и кому они нужны

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

Ими пользуются бэкенд-разработчики, DevOps-инженеры, встраивающие миграции в конвейер CI/CD, и администраторы баз, которые проверяют изменения перед выпуском. Аналитику с отчётами по готовой базе и автору одноразового прототипа инструмент обычно не нужен: базу проще пересоздать.

Flyway и Liquibase: два способа описать изменения

Flyway устроен проще. Каждое изменение — SQL-файл с номером версии в имени: V1__create_orders.sql, V2__add_status.sql. Номер задаёт порядок, после двух подчёркиваний идёт описание; повторяемые миграции с префиксом R__, например для представлений, перевыполняются при изменении файла. По документации Flyway таблица истории flyway_schema_history хранит контрольные суммы миграций и отметку, успешно ли они прошли. При расхождении сумм используют команду repair, но она переписывает историю, и запускать её стоит, только понимая, почему файл изменился.

Liquibase описывает изменения иначе. Главный файл называется changelog, внутри него лежат changeset — атомарные изменения с идентификатором и автором. Писать их можно в XML, YAML, JSON или в формате SQL со служебными комментариями. Вместо голого SQL часто берут типы изменений — createTable, addColumn, createIndex, — и Liquibase сам переводит их в SQL под конкретную СУБД. Применённые changeset с контрольными суммами записываются в таблицу DATABASECHANGELOG.

В Python-проектах ту же роль играет Alembic. Ревизия там — файл Python с функциями upgrade() и downgrade() и ссылкой на предыдущую ревизию. Автогенерация разобрана в нашей статье о SQLAlchemy, а принципы общие: применённое не правим, откат пишем сразу, схему меняем по шагам.

Учебный пример: новый столбец в большой таблице без простоя

Ситуация учебная. В таблице customers миллионы строк, телефон лежит в столбце phone в произвольном виде. Нужен обязательный столбец phone_e164 в едином формате. Если одной миграцией создать столбец, заполнить его и удалить старый, работающая версия приложения сломается: она читает phone, а запросы во время заполнения ждут блокировку.

Причина в блокировках. В документации PostgreSQL 18 по ALTER TABLE сказано, что команда берёт блокировку ACCESS EXCLUSIVE, если для конкретной подкоманды не указано иное, — пока она держится, таблицу не читают и не пишут. Поэтому изменение раскладывают на шаги по схеме «расширить — сжать» (expand-contract), где тяжёлая блокировка держится как можно меньше. Порядок выбран так, чтобы в любой момент старая и новая версии приложения работали с одной и той же базой.

  1. Миграция V7: добавить phone_e164 без ограничений. По той же документации добавление столбца без значения по умолчанию или с неизменяемым значением не переписывает таблицу, и команда проходит быстро.
  2. Выпустить версию приложения, которая пишет телефон в оба столбца.
  3. Заполнить старые строки пачками отдельным заданием, а не одной транзакцией на всю таблицу.
  4. Миграция V8: добавить CHECK (phone_e164 IS NOT NULL) NOT VALID, затем VALIDATE CONSTRAINT. Проверка берёт лишь SHARE UPDATE EXCLUSIVE и не мешает чтению и записи, а SET NOT NULL после неё пропускает полный просмотр таблицы.
  5. Перевести приложение на чтение нового столбца, а в следующем выпуске миграцией V9 удалить phone.

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

Откат: что инструмент сделает сам, а что придётся написать

Расчёт на автоматический откат в Liquibase оправдан лишь отчасти. В руководстве Liquibase по собственным откатам прямо сказано: не все типы изменений поддерживают автоматический откат. Для dropTable, insert и всех changeset в формате SQL обратной операции нет, сгенерировать откат Liquibase не может, и его описывают внутри changeset вручную. Команда, которая пишет миграции на голом SQL, без этих блоков остаётся без отката совсем.

У Flyway обратные миграции оформляются отдельными файлами с префиксом U, например U1.1__My_description.sql. В описании этой настройки раздел помечен как функция Flyway Teams, то есть платной редакции. В бесплатной версии ошибку исправляют движением вперёд: новой миграцией, которая возвращает схему в нужное состояние.

Любой откат возвращает структуру, но не данные. Если миграция удалила столбец, откат создаст его пустым. Поэтому разрушительные шаги откладывают на конец цикла «расширить — сжать», а перед ними делают резервную копию.

Таблица блокировки и параллельный запуск

Если приложение запускается в нескольких экземплярах, каждый может начать миграции одновременно. Liquibase защищается таблицей DATABASECHANGELOGLOCK: по документации она гарантирует, что одновременно работает только один экземпляр. Если процесс завершился некорректно, например контейнер убили посреди миграции, строка блокировки остаётся занятой. Следующий запуск будет ждать — по умолчанию пять минут, — а потом упадёт. Команда liquibase release-locks снимает блокировку, но только после проверки, что другой экземпляр не работает. Поэтому в CI/CD миграции применяют отдельным шагом конвейера до выкладки, а не при старте каждого экземпляра.

С чего начать и в каком порядке осваивать

Последовательность построена от простого к рискованному: сначала нужно увидеть, как инструмент ведёт историю, потом научиться ошибаться безопасно и только затем трогать большие таблицы. Для практики хватит PostgreSQL в Docker и консольной версии Flyway или Liquibase.

  1. Повторите DDL: CREATE TABLE, ALTER TABLE, ограничения, индексы.
  2. Подключите Flyway к пустой базе, напишите три версии и посмотрите содержимое flyway_schema_history.
  3. Измените уже применённый файл и прочитайте ошибку проверки — так правило «не трогать применённое» запоминается лучше всего.
  4. Перепишите те же изменения changeset в Liquibase, добавьте откат и выполните цепочку «применить — откатить — применить».
  5. Встройте миграции в конвейер CI: при каждом изменении поднимайте чистую базу и применяйте всю историю с нуля.
  6. Отработайте схему «расширить — сжать» на таблице с миллионом сгенерированных строк.

С наставником миграции удобнее изучать внутри серверной разработки. На онлайн-курсе «Java-разработчик» от Skillbox Liquibase входит в финальный уровень «Базы данных и Spring» вместе с SQL, PostgreSQL и JDBC, а итоговый проект — сервис бронирования билетов, где схема меняется по ходу работы.

Открыть курс «Java-разработчик»

Упражнения и типичные ошибки

Проверить себя можно простым вопросом: поднимется ли база с нуля из репозитория на чистой машине одной командой. Если для этого нужен ручной скрипт или дамп с чужого ноутбука, миграции ведутся не полностью.

Упражнения: добавьте в двух ветках Git миграции с одинаковым номером и слейте ветки; выполните rollback для changeset на голом SQL без отката; запустите два процесса Liquibase и убейте первый посреди работы.

Частые ошибки — правка применённой миграции, перенос гигабайтов данных в той же миграции, что меняет схему, удаление старого столбца в одном выпуске с появлением нового и проверка только на пустой базе.

Где учиться работе с миграциями

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

Тем, кто смотрит на миграции со стороны сопровождения базы, может подойти программа переподготовки «Администратор баз данных» в КИДПО. Это 400 академических часов в самостоятельном темпе, диплом о переподготовке вносят в ФИС ФРДО, нужно среднее профессиональное или высшее образование. Миграции названы в результатах обучения, но отдельного модуля в учебном плане нет — основная часть посвящена установке СУБД, резервному копированию и мониторингу, так что инструменты уточните у школы.

Открыть курс «Администратор баз данных»

Разработчику важнее проект, где схема растёт вместе с функциями: тогда ошибки с версиями и откатом случаются на учебном коде, а не на рабочей базе.

На онлайн-курсе «Java-разработчик» Яндекс Практикума десять месяцев, серверный блок включает Spring Boot, SQL и Docker. В проекте Filmorate хранение сначала устроено в памяти, затем приложение подключают к базе данных и пишут интеграционные тесты — удобный момент, чтобы самому завести Flyway или Liquibase. Инструмент миграций в описании программы не назван, это тоже стоит уточнить у школы.

Как навык влияет на доход

Отдельной оплаты «за Liquibase» нет: миграции стоят в требованиях к бэкенд-разработчику и разработчику баз данных рядом с SQL и PostgreSQL. Умение менять схему без простоя открывает задачи, которые доверяют опытным: выпуск изменений в нагруженную базу, перенос данных, конвейер с проверкой миграций.

Ориентир — исследование «Хабр Карьеры» за первое полугодие 2026 года (21 июля 2026 года): 45 226 зарплат, анонимно указанных в калькуляторе, то есть фактические зарплаты, а не предложения в вакансиях. Медиана разработчиков баз данных — 264 000 ₽ в месяц в Москве, 261 000 ₽ в Петербурге и 177 000 ₽ в регионах, на 13 % ниже, чем во втором полугодии 2025 года. Разбивки по грейдам нет, до или после налога — не сказано, так что для оценки первой зарплаты цифры не годятся.

Сравнить онлайн-школы поможет рейтинг онлайн-школ по SQL и базам данных. Он узкий, но в октябре 2026 года в нём одна школа, так что программы по бэкенду придётся сравнивать и самостоятельно.

Начните с Flyway, трёх версий схемы и намеренно испорченной контрольной суммы. Если после этого вы можете объяснить, почему нельзя править применённый файл и в каком порядке заменить столбец без простоя, курс стоит выбирать ради проекта и проверки кода, а не ради основ.