用途:为 Convex 数据库填充起始数据或固定数据(fixtures),或导入已有数据集(CSV/JSON)。当用户需要示例数据、种子数据或导入数据时触发。
主要能力:通过 internalMutation 种子函数写入数据,或使用 npx convex import 批量导入,并需与 schema 匹配。
使用方式:
- 固定数据:编写一个 internalMutation 插入示例行,用 npx convex run 执行。
- 批量导入:将数据整理为符合 schema 的结构,使用 npx convex import。
- 让种子操作幂等(先清空再插入,或使用 upsert),确保重复运行安全。
- 校验行数。
规则:必须通过 internalMutation 或 convex import 进行种子操作,并匹配校验器(validators);种子操作必须幂等;切勿向共享部署中写入密钥或个人身份信息(PII)。
限制:资料未提供具体命令参数、支持的数据格式细节、错误处理方式及性能说明。