数据库迁移指南
Flyway 版本化管理——迁移格式、执行命令、CI/CD 集成
Litopia 使用 Flyway 管理数据库迁移(版本化 + 追踪)。所有迁移文件位于 supabase/ 目录。
迁移格式
V1.0.x__action_object.sql
- 示例:
V1.0.15__create_update_profile_with_validation.sql - SQL 文件不使用中文(注释也用英文)
- Cron 表达式必须使用 UTC 时区
- 一个迁移文件 = 一个逻辑变更
常用命令
| 命令 | 说明 |
|---|---|
npm run db:migrate | 执行所有未执行的迁移 |
npm run db:info | 查看迁移状态 |
npm run db:validate | 验证迁移文件完整性和一致性 |