SuperAPI AI 工具集

migrate

数据与分析

查看项目

更新于 10-24 16:40

技能介绍

用途

该技能面向已部署上线的 Convex 应用,帮助开发者在不破坏现有数据的前提下变更数据库 schema,并通过回填使旧数据满足新结构。触发场景包括在线上应用修改 schema、回填数据等。

主要能力

  • 分阶段变更 schema:先部署兼容旧数据的结构,再逐步收紧。
  • 基于 @convex-dev/migrations 编写并执行回填迁移,补齐或转换已有行。
  • 在迁移完成后验证数据有效性,再收紧校验器。

使用方式

资料给出的步骤如下:

  1. 先将新字段设为可选,避免部署时因已有行不符合要求被拒绝。
  2. 安装 @convex-dev/migrations,编写一个回填/转换现有行的迁移。
  3. 运行迁移,并验证所有行均有效。
  4. 回填完成后,收紧校验器(将字段设为必填)。

资料同时列出规则:回填完成前绝不收紧校验器,否则会拒绝现有行并导致线上应用故障;新字段先设为可选,迁移后再设为必填;迁移前后核对行数。

适用场景

适用于 Convex 线上应用的 schema 演进与历史数据回填,尤其是新增必填字段、修改字段结构等需要平滑过渡的变更。

限制

资料未提供具体的安装命令、代码示例、迁移 API 细节、运行环境要求、收费信息及支持平台,相关内容暂未提供。