用途:在已部署的 Convex 应用上变更 schema 或迁移、回填数据,要求在不破坏现有数据、不影响线上应用的前提下完成。
主要能力与工作流:
- 先将新字段设为可选,使 deploy 不会因现有行缺少该字段而被拒绝。
- 安装 @convex-dev/migrations,并编写一个回填/转换现有行的 migration。
- 运行该 migration。
- 验证所有行都已符合新结构。
- 回填完成后收紧 validator,把字段改为必填。
规则与限制:
- 绝不能在回填完成前收紧 validator,否则会拒绝现有行并破坏线上应用。
- 新字段必须经历“可选 → 迁移 → 必填”的顺序。
- 需在迁移前后分别核对行数。
适用场景:线上 Convex 应用的 schema 演进、字段新增或数据回填。资料未提供具体安装命令、代码示例、版本要求与平台支持范围。