SuperAPI AI 工具集

convex-migrate

数据与分析

查看项目

更新于 10-16 07:20

技能介绍

用途:在已上线的 Convex 应用上安全地变更 schema 并回填数据,避免破坏现有数据或中断线上服务。

主要能力:通过分阶段流程完成 schema 迁移与数据回填,使用 @convex-dev/migrations 编写并运行迁移脚本,将旧数据转换为满足新校验器(validator)要求的格式。

使用方式:

  1. 先把新字段设为可选,使部署不会拒绝已有数据行;
  2. 安装 @convex-dev/migrations,编写回填/转换现有数据行的迁移;
  3. 运行迁移,验证所有数据行均有效;
  4. 回填完成后,收紧 validator(将字段设为必填)。

关键规则:

  • 在回填完成前绝不要收紧 validator,否则会拒绝现有数据行并导致线上应用出错;
  • 新字段应先作为可选添加,迁移后再设为必填;
  • 迁移前后都要核对行数。

适用场景:需要在生产环境变更 Convex 数据模型、为已有记录补充或转换字段时使用。

限制:资料未提供具体平台要求、收费标准、命令行示例或版本兼容信息,相关细节暂未提供。