データベース シード ジェネレータ

データベースに現実的でドメインに適したサンプルデータを投入するシードスクリプトを生成します。スキーマを読み込んで、すぐに実行可能なシードファイルを出力します。

ワークフロー

1. スキーマを探す

プロジェクト内のスキーマ定義をスキャンします:

ソース	ロケーションパターン
Drizzle スキーマ	src/db/schema.ts, src/schema/*.ts, db/schema.ts
D1 マイグレーション	drizzle/*.sql, migrations/*.sql
Raw SQL	schema.sql, db/*.sql
Prisma	prisma/schema.prisma

すべてのスキーマファイルを読み込みます。次の項目の全体像を構築します:

• テーブルとそのカラム
• データ型と制約 (NOT NULL, UNIQUE, DEFAULT)
• 外部キーの関係性 (どのテーブルがどのテーブルを参照しているか)
• JSON フィールドが TEXT として保存されているもの (D1/SQLite では一般的)

2. シード パラメータを決定する

ユーザーに質問します:

パラメータ	オプション	デフォルト
目的	dev、demo、testing	dev
ボリューム	small (5-10 行/テーブル)、medium (20-50)、large (100+)	small
ドメイン コンテキスト	"e-commerce store"、"SaaS app"、"blog" など	スキーマから推測
出力形式	TypeScript (Drizzle)、raw SQL、または両方	プロジェクトの ORM に合わせる

目的はデータ品質に影響します:

• dev: 多様なデータ、いくつかのエッジケース (空のフィールド、長い文字列、Unicode)
• demo: スクリーンショットやプレゼンテーションで見栄えの良いデータ
• testing: 境界条件、重複、特殊文字をカバーするシステマティックなデータ

3. 挿入順序を計画する

外部キーから依存性グラフを構築します。親テーブルを子テーブルの前に挿入します。

ブログスキーマの例:

1. users        (依存関係なし)
2. categories   (依存関係なし)
3. posts        (users、categories に依存)
4. comments     (users、posts に依存)
5. tags         (依存関係なし)
6. post_tags    (posts、tags に依存)

循環依存: テーブル A が B を参照し、B が A を参照している場合、nullable 外部キーを使用して、2 パスで挿入します (NULL で挿入してから UPDATE)。

4. リアルなデータを生成する

"test123"、"foo@bar.com"、"Lorem ipsum" のような汎用プレースホルダーを使用しないでください。ドメインに合致するデータを生成してください。

データ生成パターン (外部ライブラリは不要)

名前: ハードコードされた一般的な名前のリストを使用します。性別と文化的背景を混ぜます。

const firstNames = ['Sarah', 'James', 'Priya', 'Mohammed', 'Emma', 'Wei', 'Carlos', 'Aisha'];
const lastNames = ['Chen', 'Smith', 'Patel', 'Garcia', 'Kim', 'O\'Brien', 'Nguyen', 'Wilson'];

メール: 名前から導出します — sarah.chen@example.com。example.com ドメインを使用します (RFC 2606 予約)。

日付: 現実的な範囲内で生成します。D1/SQLite には ISO 8601 形式を使用します。

const randomDate = (daysBack: number) => {
  const d = new Date();
  d.setDate(d.getDate() - Math.floor(Math.random() * daysBack));
  return d.toISOString();
};

ID: UUID には crypto.randomUUID() を使用するか、スキーマが自動増加を使用する場合は連続整数を使用します。

決定論的シード: 再現可能なデータの場合、シードされた PRNG を使用します:

function seededRandom(seed: number) {
  return () => {
    seed = (seed * 16807) % 2147483647;
    return (seed - 1) / 2147483646;
  };
}
const rand = seededRandom(42); // 同じシード = 毎回同じデータ

価格/金額: 現実的な範囲を使用します。$1-$10 の範囲の場合 (rand() * 900 + 100).toFixed(2)。

説明/コンテンツ: コンテンツタイプごとに 3-5 個の現実的なバリエーションを書いて、それらをサイクルします。AI のような文章は生成しないでください — 実際のユーザーデータのように書きます。

5. 出力形式

TypeScript (Drizzle ORM)

// scripts/seed.ts
import { drizzle } from 'drizzle-orm/d1';
import * as schema from '../src/db/schema';

export async function seed(db: ReturnType<typeof drizzle>) {
  console.log('Seeding database...');

  // 既存データをクリア (逆依存順)
  await db.delete(schema.comments);
  await db.delete(schema.posts);
  await db.delete(schema.users);

  // ユーザーを挿入
  const users = [
    { id: crypto.randomUUID(), name: 'Sarah Chen', email: 'sarah@example.com', ... },
    // ...
  ];

  // D1 バッチ制限: INSERT ごとに 10 行
  for (let i = 0; i < users.length; i += 10) {
    await db.insert(schema.users).values(users.slice(i, i + 10));
  }

  // ポストを挿入 (ユーザーを参照)
  const posts = [
    { id: crypto.randomUUID(), userId: users[0].id, title: '...', ... },
    // ...
  ];

  for (let i = 0; i < posts.length; i += 10) {
    await db.insert(schema.posts).values(posts.slice(i, i + 10));
  }

  console.log(`Seeded: ${users.length} users, ${posts.length} posts`);
}

実行: npx tsx scripts/seed.ts

Cloudflare Workers の場合、シード エンドポイントを追加します (本番前に削除):

app.post('/api/seed', async (c) => {
  const db = drizzle(c.env.DB);
  await seed(db);
  return c.json({ ok: true });
});

Raw SQL (D1)

-- seed.sql
-- 実行: npx wrangler d1 execute DB_NAME --local --file=./scripts/seed.sql

-- 既存データをクリア (逆順)
DELETE FROM comments;
DELETE FROM posts;
DELETE FROM users;

-- ユーザー
INSERT INTO users (id, name, email, created_at) VALUES
  ('uuid-1', 'Sarah Chen', 'sarah@example.com', '2025-01-15T10:30:00Z'),
  ('uuid-2', 'James Wilson', 'james@example.com', '2025-02-01T14:22:00Z');

-- ポスト (D1 の場合最大 10 行/INSERT)
INSERT INTO posts (id, user_id, title, body, created_at) VALUES
  ('post-1', 'uuid-1', 'Getting Started', 'Welcome to...', '2025-03-01T09:00:00Z');

6. 冪等性

シードスクリプトは何度でも安全に再実行できる必要があります:

// オプション A: 削除後挿入 (シンプル、データ損失)
await db.delete(schema.users);
await db.insert(schema.users).values(seedUsers);

// オプション B: Upsert (非シードデータを保持)
for (const user of seedUsers) {
  await db.insert(schema.users)
    .values(user)
    .onConflictDoUpdate({ target: schema.users.id, set: user });
}

開発/テストにはオプション A をデフォルトとし、デモ (ユーザーが独自のデータを追加している可能性) にはオプション B を使用します。

D1 固有の落とし穴

落とし穴	ソリューション
INSERT ごとに約 10 行が上限	10 行ずつバッチで挿入
ネイティブ BOOLEAN がない	INTEGER (0/1) を使用
ネイティブ DATETIME がない	TEXT と ISO 8601 文字列を使用
JSON が TEXT として保存される	挿入前に JSON.stringify() を実行
外部キーは常に強制される	親テーブルを最初に挿入
100 バインドパラメータ制限	バッチサイズ × カラム数 < 100 に保つ

品質ルール

1. ドメインに合わせる — e-commerce シードには、"Product 1" ではなく、実在のような名前と価格の製品が含まれます
2. データを変える — すべてのユーザーを "John Smith" にしたり、すべての価格を "$9.99" にしたりしないでください
3. エッジケースを含める (テストシード用) — 空の文字列、非常に長いテキスト、特殊文字、最大値
4. 実際の ID を参照する — 外部キーは実際に挿入された親行を指す必要があります
5. シードされたものを出力する — ユーザーが機能したことを知るように、常にカウントをログに出力します
6. 実行コマンドをドキュメント化する — ファイルの最上部のコメントに入れます