Skip to main content
CloudflareとはWeb/Cloud管理画面開発環境Worker入門ローカル/デバッグ静的公開TypeScriptAPIReact連携独自ドメインCDN/キャッシュ守る基本保存先KVD1R2/ImagesDurable ObjectsQueuesCron/Workflows運用/LogsWorkers AIAI応用総仕上げ

第01章：D1はCloudflare上のSQLデータベース 🧾☁️

D1は、Cloudflareで表形式のデータを扱うためのserverless SQL databaseです。
SQLが初めてだと少し難しく見えますが、最初は「表にデータを入れて、必要な行を取り出す」と考えれば大丈夫です 😊

cloudflare_d1_ts_study_001_d1_concept

1. D1は表データの置き場 📊​

D1は、行と列を持つデータを扱うのに向いています。

例です。

  • Todo
  • メモ
  • ユーザー
  • 投稿
  • 注文
  • AI要約履歴

KVがキーで値を取り出す辞書なら、D1は表を作ってデータを整理する場所です。

cloudflare_d1_ts_study_001_kv_vs_d1

2. SQLiteのSQL semanticsを使う 🧠​

Cloudflare公式では、D1はSQLiteのSQL semanticsを持つmanaged serverless databaseとして案内されています。
つまり、SQLite系のSQLでテーブル作成やデータ操作ができます。

cloudflare_d1_ts_study_001_sqlite_semantics

最初に覚えるSQLは多くありません。

  • CREATE TABLE
  • INSERT
  • SELECT
  • UPDATE
  • DELETE

この5つだけでも、かなりアプリらしいデータ操作ができます。

3. Workersからbindingで使う 🌉​

D1はCloudflare Workersからbinding経由で使います。

React画面
  ↓ fetch
Workers API
  ↓ env.DB
D1

Reactから直接D1へ触るのではなく、Worker APIを通します。
これにより、入力チェックや認証、ログ、Rate Limitingも入れやすくなります。

cloudflare_d1_ts_study_001_api_flow

4. D1が向いているもの・向かないもの ⚖️​

向いているものです。

  • 一覧表示したいデータ
  • 条件で検索したいデータ
  • 更新や削除が必要なアプリデータ
  • 履歴データ

向かないものです。

  • 画像やPDFの本体
  • 軽い設定値だけ
  • リアルタイムチャットの状態
  • 後で処理するジョブ

画像ならR2、軽い設定ならKV、状態ならDurable Objects、後処理ならQueuesも候補です。

cloudflare_d1_ts_study_001_use_cases

5. 章末チェック ✅​

  • D1は表形式データの保存先だと分かる
  • SQLite系のSQLを使うと分かる
  • Workersからbindingで使うと分かる
  • KV/R2/DO/Queuesとの大まかな違いが分かる
  • CRUDの入口としてD1を見られる

この章で覚える一言はこれです。
D1は、Cloudflareアプリに表データとSQLの本格感を足す保存先です 🧾