用途:在已上线的 Convex 应用上安全地变更 schema 并回填数据,避免破坏现有数据或中断线上服务。
主要能力:通过分阶段流程完成 schema 迁移与数据回填,使用 @convex-dev/migrations 编写并运行迁移脚本,将旧数据转换为满足新校验器(validator)要求的格式。
使用方式:
- 先把新字段设为可选,使部署不会拒绝已有数据行;
- 安装 @convex-dev/migrations,编写回填/转换现有数据行的迁移;
- 运行迁移,验证所有数据行均有效;
- 回填完成后,收紧 validator(将字段设为必填)。
关键规则:
- 在回填完成前绝不要收紧 validator,否则会拒绝现有数据行并导致线上应用出错;
- 新字段应先作为可选添加,迁移后再设为必填;
- 迁移前后都要核对行数。
适用场景:需要在生产环境变更 Convex 数据模型、为已有记录补充或转换字段时使用。
限制:资料未提供具体平台要求、收费标准、命令行示例或版本兼容信息,相关细节暂未提供。