跨 ORM 数据库迁移
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/rmyndharis-antigravity-skills-database-migration。
技能介绍
你在解决什么问题
换 ORM、改表结构、跨库搬数据时,最怕的是线上挂了却回滚不了、改列名导致全表锁、或一次迁移塞进太多 breaking change。不同框架的 migration API 不一,但底层都要面对:schema 怎么演进、旧数据怎么映射、发布窗口里怎么尽量不停机。
技能如何帮你落地
技能按 ORM 迁移(Sequelize / TypeORM / Prisma)、Schema 变换、数据迁移、回滚策略、零停机发布 几条线组织,并指向内置参考与模板:
- Schema:带默认值的加列、零停机重命名列、改列类型等常见模式
- 数据:复杂字段映射、批量搬移时的脚本与校验思路
- 回滚:基于事务的迁移、检查点式 rollback,强调每个
up()配好down() - 零停机:蓝绿部署等与 schema 分步变更的配合
- 跨库:例如 PostgreSQL 到 MySQL 的迁移注意事项
工作流程上要求先澄清目标、约束与输入,再按最佳实践执行并可验证;附带 schema-migration-template.sql、data-migration-script.py、测试脚本等资源路径,便于对照落地。
边界与常见坑
任务与数据库迁移无关时不要启用本技能。资料中强调的坑包括:未在预发验证 rollback、大改表却没有停机策略、忽略 NULL 与索引/外键性能、一次迁移数据量过大。迁移前备份、拆成小步、尽量事务化与幂等,是贯穿始终的前提。
使用场景
- 团队从 Sequelize 迁到 Prisma,需要可回滚的 schema 与数据双轨迁移方案
- 生产表要改列类型且不能长时间锁表,需要分步 schema 与蓝绿发布配合
- 预发验证 migration 的 down() 是否在脏数据与部分失败时仍能安全执行
- 业务库从 PostgreSQL 迁到 MySQL,需处理类型差异与外键、索引重建顺序
适合人员
- 负责线上发版的后端工程师,要在小窗口内完成表结构变更并保留 rollback
- 平台/DevOps 同学,需要把 migration 纳入蓝绿或分批发布流水线的 DBA 协作方
- ORM 选型切换时的技术负责人,要评估 Sequelize/TypeORM/Prisma 迁移脚本与数据映射成本
- 维护多环境数据库的工程师,需在 staging 先跑通 up/down 再推生产