SuperAPI AI 工具集

convex-migrate

数据与分析

查看项目

更新于 10-16 03:06

技能介绍

用途:在已部署的 Convex 应用上变更 schema 或迁移、回填数据,要求在不破坏现有数据、不影响线上应用的前提下完成。

主要能力与工作流:

  1. 先将新字段设为可选,使 deploy 不会因现有行缺少该字段而被拒绝。
  2. 安装 @convex-dev/migrations,并编写一个回填/转换现有行的 migration。
  3. 运行该 migration。
  4. 验证所有行都已符合新结构。
  5. 回填完成后收紧 validator,把字段改为必填。

规则与限制:

  • 绝不能在回填完成前收紧 validator,否则会拒绝现有行并破坏线上应用。
  • 新字段必须经历“可选 → 迁移 → 必填”的顺序。
  • 需在迁移前后分别核对行数。

适用场景:线上 Convex 应用的 schema 演进、字段新增或数据回填。资料未提供具体安装命令、代码示例、版本要求与平台支持范围。