SuperAPI AI 工具集

prisma-next-migrations

通用与其它

查看项目

更新于 10-16 07:20

技能介绍

用途:在 Prisma Next 中把契约变更落到数据库。用户改完数据契约后,由本技能规划迁移;若涉及数据转换,再编辑 migration.ts 并自emit。支持 Postgres 与 Mongo,目标由 prisma-next.config.ts 决定,迁移命令不接受 --target,需用对应目标的配置。

两条路径:db update 为快速路径,读取已emit契约、与实时库比对并应用,可 --dry-run,不写迁移目录,不处理需要数据转换的操作,仅用于无共享历史的本地开发库。migration plan 为正式路径,写入 migrations/app/<YYYYMMDDTHHMM>_<snake_slug>/ 下的迁移包,含 migration.json、ops.json、migration.ts;路径中的 app 为消费方应用的契约空间 id。

migration.ts 由框架渲染,不要从头手写,也不要改渲染出的 import 行。需要数据转换时,planner 会留下 placeholder("<slot>") 哨兵,emit 时抛出 PN-MIG-2001;用户把 () => placeholder(...) 替换为真实查询闭包(Postgres)或填充 dataTransform({ check, run })(Mongo),再运行 node migrations/app/<dir>/migration.ts 自emit,这是更新迁移包的唯一支持方式。migration plan 结果中的 pendingPlaceholders 为 true 表示占位符未填。

关键恢复码:MIGRATION.HASH_MISMATCH 表示编辑后未自emit;PN-MIG-2005 表示 dataTransform 契约引用不一致;PN-RUN-3001 数据库未签名,可先 db init;PN-RUN-3002 标记与契约哈希不符,可 db sign。Postgres 迁移在事务中执行,失败回滚;Mongo 的 DDL 不包在多文档事务中,需靠 schema 校验后推进 marker。

限制:不负责部署前审查迁移或管理 refs,那属于 prisma-next-migration-review;也不用于编辑契约。db update 与正式迁移的取舍依共享环境与生产需求而定。