D1 Drizzle スキーマ

Cloudflare D1 向けの正しい Drizzle ORM スキーマを生成します。D1 は SQLite ベースですが、標準的な SQLite パターンを使用すると微妙なバグが発生する重要な違いがあります。このスキルは D1 の制約に正しく対応したスキーマを生成します。

D1 の重要な違い

機能	標準 SQLite	D1
外部キー	デフォルトは OFF	常に ON (無効化不可)
Boolean 型	なし	なし — integer({ mode: 'boolean' }) を使用
Datetime 型	なし	なし — integer({ mode: 'timestamp' }) を使用
最大バインドパラメータ	~999	100 (一括挿入に影響)
JSON サポート	拡張機能	常に利用可能 (json_extract, ->, ->>)
並行処理	マルチライター	シングルスレッド (一度に 1 つのクエリ)

ワークフロー

ステップ 1: データモデルを記述

要件を集めます: どのようなテーブル、どのようなリレーションシップ、インデックスが必要か。既存の説明から作成する場合は、スキーマを直接推論します。

ステップ 2: Drizzle スキーマを生成

D1 に対応したカラムパターンを使用してスキーマファイルを作成します:

import { sqliteTable, text, integer, real, index, uniqueIndex } from 'drizzle-orm/sqlite-core'

export const users = sqliteTable('users', {
  // UUID 主キー (D1 では推奨)
  id: text('id').primaryKey().$defaultFn(() => crypto.randomUUID()),

  // テキストフィールド
  name: text('name').notNull(),
  email: text('email').notNull(),

  // Enum (TEXT として保存、スキーマレベルで検証)
  role: text('role', { enum: ['admin', 'editor', 'viewer'] }).notNull().default('viewer'),

  // Boolean (D1 に BOOL がない — INTEGER 0/1 として保存)
  emailVerified: integer('email_verified', { mode: 'boolean' }).notNull().default(false),

  // Timestamp (D1 に DATETIME がない — unix 秒として保存)
  createdAt: integer('created_at', { mode: 'timestamp' }).notNull().$defaultFn(() => new Date()),
  updatedAt: integer('updated_at', { mode: 'timestamp' }).notNull().$defaultFn(() => new Date()),

  // 型付き JSON (TEXT として保存、Drizzle が自動シリアライズ)
  preferences: text('preferences', { mode: 'json' }).$type<UserPreferences>(),

  // 外部キー (D1 では常に強制)
  organisationId: text('organisation_id').references(() => organisations.id, { onDelete: 'cascade' }),
}, (table) => ({
  emailIdx: uniqueIndex('users_email_idx').on(table.email),
  orgIdx: index('users_org_idx').on(table.organisationId),
}))

完全な型リファレンスについては references/column-patterns.md を参照してください。

ステップ 3: リレーションを追加

Drizzle リレーションはクエリビルダーのヘルパーです (FK 制約とは別):

import { relations } from 'drizzle-orm'

export const usersRelations = relations(users, ({ one, many }) => ({
  organisation: one(organisations, {
    fields: [users.organisationId],
    references: [organisations.id],
  }),
  posts: many(posts),
}))

ステップ 4: 型をエクスポート

export type User = typeof users.$inferSelect
export type NewUser = typeof users.$inferInsert

ステップ 5: Drizzle 設定をセットアップ

assets/drizzle-config-template.ts を drizzle.config.ts にコピーし、スキーマパスを更新します。

ステップ 6: マイグレーションスクリプトを追加

package.json に追加:

{
  "db:generate": "drizzle-kit generate",
  "db:migrate:local": "wrangler d1 migrations apply DB --local",
  "db:migrate:remote": "wrangler d1 migrations apply DB --remote"
}

テストする前に、ローカルとリモートの両方で実行してください。

ステップ 7: DATABASE_SCHEMA.md を生成

今後のセッションのためにスキーマを記録します:

• テーブル、カラム、型、制約
• リレーションシップと外部キー
• インデックスとその目的
• マイグレーションワークフロー

一括挿入パターン

D1 はバインドパラメータを 100 に制限します。バッチサイズを計算します:

const BATCH_SIZE = Math.floor(100 / COLUMNS_PER_ROW)
for (let i = 0; i < rows.length; i += BATCH_SIZE) {
  await db.insert(table).values(rows.slice(i, i + BATCH_SIZE))
}

D1 ランタイム使用方法

import { drizzle } from 'drizzle-orm/d1'
import * as schema from './schema'

// Worker fetch ハンドラー内:
const db = drizzle(env.DB, { schema })

// クエリパターン
const all = await db.select().from(schema.users).all()           // Array<User>
const one = await db.select().from(schema.users).where(eq(schema.users.id, id)).get()  // User | undefined
const count = await db.select({ count: sql`count(*)` }).from(schema.users).get()

リファレンスファイル

対象	参照
D1 vs SQLite、JSON クエリ、制限	references/d1-specifics.md
Drizzle + D1 のカラム型パターン	references/column-patterns.md

アセット

ファイル	目的
assets/drizzle-config-template.ts	D1 向けスターター drizzle.config.ts
assets/schema-template.ts	すべての一般的な D1 パターンを含むスキーマの例