Миграции в Postgres: 6 правил, которые спасают schema без откатов и сюрпризов

Миграции в Postgres: 6 правил, которые спасают schema без откатов и сюрпризов

Миграция — это не просто SQL-файл, а контракт между кодом, данными и деплоем. Ошибка здесь обычно не в синтаксисе, а в том, что миграция не учитывает порядок, блокировки и обратимость.

— Сначала меняй схему так, чтобы старый код ещё работал: добавь колонку, заполни, потом переключай чтение и только в конце удаляй лишнее.
— Любой тяжёлый backfill делай отдельным шагом, а не вместе с DDL: так проще контролировать нагрузку и откат.
— Не полагайся на «ручную правку в базе»: миграции должны быть единственным источником правды для supabase и postgres.

Проверяй миграцию на пустой базе и на базе с реальными данными. В первом случае видно, хватает ли зависимостей; во втором — всплывают конфликты, дубли, NULL-значения и неожиданные ограничения. Если есть RLS, миграция должна учитывать не только таблицу, но и политики, индексы и функции, которые на неё завязаны.

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