Agent Skills
返回列表
💻

跨 ORM 数据库迁移

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 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 再推生产