SuperAPI AI 工具集

convex-seed

数据与分析

查看项目

更新于 10-16 16:04

技能介绍

用途 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)。

其他事实(如具体版本、依赖、费用、价格、支持平台等)在提供资料中暂未提供。