用途 convex-seed 用于向 Convex 数据库填充或导入数据,适用于初始化示例数据、准备测试夹具或批量导入既有数据的场景。
主要能力
- 通过 internalMutation 种子函数填充表,适合写入示例行数据(fixtures)。
- 通过 npx convex import 进行批量导入。
- 两种方式都要求数据与 schema 匹配。
使用方式
- 对于夹具数据:编写一个 internalMutation,用于插入样本行,然后使用 npx convex run 运行它。
- 对于批量导入:将数据整理为符合 schema 的形状,然后使用 npx convex import。
- 让种子操作具备幂等性(清除后再插入,或使用 upsert),以保证重复运行的安全性。
- 核对行数。
适用场景
- 需要在 Convex 部署中初始化或重建数据集。
- 需要在开发或测试环境准备可重复生成的样本数据。
- 需要将外部数据批量导入 Convex 表。
限制与规则
- 必须通过 internalMutation 或 convex import 进行种子写入,并匹配校验器(validators)。
- 必须使种子操作幂等。
- 绝不向共享部署中写入密钥(secrets)或个人身份信息(PII)。
其他事实(如具体版本、依赖、费用、价格、支持平台等)在提供资料中暂未提供。