用途:为 Convex 数据库准备起始数据或示例数据(fixture),或把已有数据集导入表中。
主要能力:
- fixture 数据:编写 internalMutation 种子函数插入示例行,并用 npx convex run 执行。
- 批量导入:将数据整理为与 schema 一致的结构,使用 npx convex import 导入。
使用方式(按资料步骤):
- 若为 fixture,编写 internalMutation 插入示例行,使用 npx convex run 运行。
- 若为批量导入,按 schema 整形数据后使用 npx convex import。
- 使种子逻辑幂等(clear-then-insert 或 upsert),确保重复运行安全。
- 核对行数。
规则与限制:
- 通过 internalMutation 或 convex import 写入,并匹配 validators。
- 种子操作必须幂等。
- 不得向共享部署写入密钥或 PII。
适用场景:需要示例/起始数据、重复运行的本地或开发环境种子、以及 CSV/JSON 已有数据集的导入。具体命令参数、支持的数据格式细节与版本要求暂未提供。