用途:在已上线运行的 Convex 应用上安全地修改 schema 并回填数据,避免因校验器变更导致现有数据被拒绝、线上应用中断。适用于需要变更线上表结构、为旧行补充新字段或转换数据、并在迁移完成后收紧字段校验的场景。
主要能力与流程:先将要新增的字段设为可选,使部署不会因现有行缺少该字段而被拒绝;然后安装 @convex-dev/migrations,编写迁移以回填或转换已有行;运行迁移并验证所有行均有效;确认回填完成后,再把校验器收紧(将字段设为必填)。
关键规则:回填完成前绝不要收紧校验器,否则会拒绝现有行并破坏线上应用;新增字段必须先可选、迁移后再设为必填;迁移前后要核对行数。
使用方式:按上述四步顺序执行,安装与代码内容需依据该技能页面提供的命令与示例。
限制与缺失信息:资料未提供具体的命令写法、完整代码示例、配置参数、性能或回滚细节,使用前需查阅来源页面确认。