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

第07章：Durable Objects：状態と順番を扱う場所 🧵🏠

Durable Objectsは、状態を持つアプリや、順番が大事な処理で使うCloudflareの仕組みです。
最初は少し難しく見えますが、「状態のある部屋」と考えると分かりやすいです。
Durable Objects Concept

この章では、Durable Objectsを使う場面を整理します 😊

1. Durable Objectsは状態のある部屋 🏠​

通常のWorkerは、リクエストごとに処理を返すserverlessなコードです。
でも、チャットルームのように「今この部屋に誰がいるか」を持ちたいことがあります。

Durable Objectsは、特定の名前やIDに対応する1つのObjectへリクエストを集められます。 Routing Requests to DO

room:abc → Durable Object
room:def → 別のDurable Object

これにより、部屋ごとの状態や順番を扱いやすくなります。

2. 向いている用途 💬​

Durable Objectsが向いている例です。 Suitable Use Cases for DO

  • チャットルーム
  • 共同編集
  • WebSocket接続管理
  • ゲーム部屋
  • リアルタイム投票
  • グローバルな調整
  • 順番が重要な処理

公式storage optionsでも、stateful serverless workloadsやcoordination用途が案内されています。

3. SQLite storage backend 🧾​

Cloudflare公式では、新しいDurable Object namespaceにはSQLite storage backendが推奨されています。
SQLite Storage Backend in DO

Durable Object内でSQL的な保存を扱えるようになり、状態管理の幅が広がっています。

ただし、初心者はまず「DOは状態と順番が必要なとき」と覚えれば十分です。
詳細なStorage APIは、後続のDurable Objects章で深掘りします。

4. 何でもDOに入れない ⚠️​

Durable Objectsは強力ですが、何でも入れる場所ではありません。

向かない例です。 Wrong Uses of DO

  • 単純な設定値
  • 大量の画像ファイル
  • 普通の一覧検索だけしたいデータ
  • 後で処理すればよいジョブ

設定ならKV、画像ならR2、表データならD1、非同期処理ならQueuesが候補です。

5. Durable Objectのbindingイメージ 🧾​

wrangler.jsonc では、Durable Object namespaceをbindingします。 DO Binding Config

{
  "durable_objects": {
    "bindings": [
      {
        "name": "ROOM",
        "class_name": "RoomObject"
      }
    ]
  }
}

コード側では、IDからstubを取得してObjectへリクエストを送るイメージです。

6. 章末チェック ✅​

  • Durable Objectsは状態のある部屋だと分かる
  • チャットや共同編集に向いていると分かる
  • 順番や一貫性が大事な場面で候補になると分かる
  • 新しいnamespaceではSQLite storage backendが推奨されていると分かる
  • 何でもDOに入れるわけではないと分かる

この章で覚える一言はこれです。
Durable Objectsは、状態と順番が大事な“部屋”を作るための仕組みです 🧵🏠 DO Chapter Summary