用途
该技能面向已部署上线的 Convex 应用,帮助开发者在不破坏现有数据的前提下变更数据库 schema,并通过回填使旧数据满足新结构。触发场景包括在线上应用修改 schema、回填数据等。
主要能力
- 分阶段变更 schema:先部署兼容旧数据的结构,再逐步收紧。
- 基于 @convex-dev/migrations 编写并执行回填迁移,补齐或转换已有行。
- 在迁移完成后验证数据有效性,再收紧校验器。
使用方式
资料给出的步骤如下:
- 先将新字段设为可选,避免部署时因已有行不符合要求被拒绝。
- 安装 @convex-dev/migrations,编写一个回填/转换现有行的迁移。
- 运行迁移,并验证所有行均有效。
- 回填完成后,收紧校验器(将字段设为必填)。
资料同时列出规则:回填完成前绝不收紧校验器,否则会拒绝现有行并导致线上应用故障;新字段先设为可选,迁移后再设为必填;迁移前后核对行数。
适用场景
适用于 Convex 线上应用的 schema 演进与历史数据回填,尤其是新增必填字段、修改字段结构等需要平滑过渡的变更。
限制
资料未提供具体的安装命令、代码示例、迁移 API 细节、运行环境要求、收费信息及支持平台,相关内容暂未提供。