convex-seed について
convex-seedは、Convexのテーブルにデータを投入・インポートするスキルです。テストデータの準備や一括取り込みを行う開発者向けで、internalMutationまたはnpx convex importを使い、スキーマに沿った再実行可能な処理を行います。
主な機能
- 01internalMutationでサンプル行を挿入
- 02npx convex importで一括インポート
- 03スキーマに合うデータ形状
- 04再実行可能な冪等処理
- 05行数の確認
活用シーン
- 01開発やテスト用のサンプルデータを用意
- 02スキーマに合わせたデータを一括インポート
- 03データ投入処理を安全に再実行
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ get-convex/ agent-skills --skill convex-seedインストール後、Claude Code で/convex-seedを入力して読み込まれたか確認します。
詳細
データのシード/インポート
スキーマに合わせて、internalMutation のシード関数(再実行可能)または npx convex import を使ってテーブルにデータを投入します。
ワークフロー
- フィクスチャの場合:サンプル行を挿入する internalMutation を記述し、
npx convex runで実行します。 - 一括インポートの場合:データをスキーマに合わせて整形し、
npx convex importを使います。 - シード処理を冪等にします(削除してから挿入するか、upsert を使う)。これにより、安全に再実行できます。
- 行数を確認します。
ルール
- バリデーターに合わせて、internalMutation または convex import でシードデータを投入します。
- シード処理を冪等にします。
- 共有デプロイメントに秘密情報や個人情報をシードしないでください。
コメント
Markdown 対応