Как создавать и применять миграции Drizzle?
На этой странице
Миграция — сохранённое изменение структуры базы. В командной работе схема меняется в TypeScript, Drizzle Kit создаёт SQL, разработчик проверяет его и затем применяет к базе.
Вопрос
Как создавать и применять миграции в Drizzle? Чем generate и migrate отличаются от push?
Обычный порядок
Изменить schema.ts
↓
drizzle-kit generate
↓
Проверить созданный SQL
↓
drizzle-kit migrate
↓
Отправить схему и миграцию в GitСоздание первой миграции
npm run db:generate -- --name=initВ папке drizzle/ появятся SQL-файл и служебный снимок схемы.
Применение
npm run db:migrateDrizzle записывает сведения о выполненных миграциях в служебную таблицу и не выполняет их повторно.
Основные команды
| Команда | Назначение |
|---|---|
generate | Создать SQL из изменений TypeScript-схемы |
migrate | Применить ещё не выполненные миграции |
push | Сразу привести базу к схеме без файла миграции |
pull | Прочитать существующую базу и создать схему |
studio | Открыть просмотр данных в браузере |
Когда использовать push
push удобен для быстрого местного прототипа:
npm run db:pushДля командного и рабочего окружения понятнее хранить проверяемую историю generate + migrate.
Всегда читай SQL
Автоматически созданная миграция может:
- удалить столбец;
- потерять данные при смене типа;
- долго блокировать большую таблицу;
- создать обязательный столбец без значения для старых строк;
- переименовать столбец как удаление и создание.
Если добавляется обязательное поле в непустую таблицу, часто безопаснее:
- добавить его необязательным;
- заполнить старые строки;
- добавить
NOT NULLотдельной миграцией.
Миграция и запуск приложения
Не запускай миграции одновременно в каждом экземпляре сервера без продуманной координации. Обычно их выполняет отдельный шаг развёртывания.
Что важно помнить
- Порядок: изменить схему →
drizzle-kit generate→ прочитать SQL →drizzle-kit migrate. - Файлы миграций и снимки коммитятся в Git вместе с изменением схемы.
pushсразу меняет базу без файла миграции — удобно для прототипа, опасно для общей и рабочей базы.- Переименование столбца Drizzle Kit может принять за удаление и создание — сгенерированный SQL обязательно читают.
- Миграции применяют до запуска новой версии приложения, отдельным шагом деплоя.
Мини-шпаргалка
- Схема описывает желаемое состояние.
- Миграция хранит переход между состояниями.
generateсоздаёт SQL,migrateприменяет его.pushудобен для прототипа, но не заменяет историю изменений.- Созданный SQL нужно прочитать до запуска.
Документация
Drizzle: Migrations, drizzle-kit generate, drizzle-kit migrate, drizzle-kit push.