SuperAPI AI 工具集

migrate

通用与其它

查看项目

更新于 10-16 05:45

技能介绍

用途:在已上线运行的 Convex 应用上安全地修改 schema 并回填数据,避免因校验器变更导致现有数据被拒绝、线上应用中断。适用于需要变更线上表结构、为旧行补充新字段或转换数据、并在迁移完成后收紧字段校验的场景。

主要能力与流程:先将要新增的字段设为可选,使部署不会因现有行缺少该字段而被拒绝;然后安装 @convex-dev/migrations,编写迁移以回填或转换已有行;运行迁移并验证所有行均有效;确认回填完成后,再把校验器收紧(将字段设为必填)。

关键规则:回填完成前绝不要收紧校验器,否则会拒绝现有行并破坏线上应用;新增字段必须先可选、迁移后再设为必填;迁移前后要核对行数。

使用方式:按上述四步顺序执行,安装与代码内容需依据该技能页面提供的命令与示例。

限制与缺失信息:资料未提供具体的命令写法、完整代码示例、配置参数、性能或回滚细节,使用前需查阅来源页面确认。