用途:在已上线的 Convex 应用上修改 schema 或迁移数据,避免因校验器变化导致既有数据失效、线上应用中断。
主要能力:提供一套分阶段迁移流程,配合 @convex-dev/migrations 编写回填(backfill)任务,将旧数据转换为满足新 schema 的形式,并在确认全部记录合法后再收紧校验器。
使用方式(资料给出的工作流):
- 先新增可选字段,使部署不会拒绝既有行。
- 安装 @convex-dev/migrations,并编写一个回填/转换既有行的迁移。
- 运行迁移,验证所有行均合法。
- 回填完成后,再收紧校验器(把字段改为必填)。
规则与限制:
- 回填完成前绝不收紧校验器,否则会拒绝既有行并破坏线上应用。
- 新字段先设为可选,迁移后再改为必填。
- 迁移前后需核对行数。
适用场景:需要对已部署的 Convex 应用做 schema 演进或数据回填的开发者。资源未提供具体安装命令、API 细节、定价或价格信息。