Durable Objects, Workers - New Durable Object namespaces must use the SQLite storage backend

概要

もしアカウントに既存の key-value (KV) バックエンドの Durable Object 名前空間がない場合、新しい KV バックエンドの名前空間を作成することはできません。新しい Durable Object 名前空間は SQLite ストレージバックエンドを使用する必要があります。SQLite バックエンドは 2024 年の一般提供開始以降、すべての新しい Durable Objects に推奨されています ↗。

対応方法

新しいクラスを作成するには、new_sqlite_classes マイグレーションを使用します。設定例:

wrangler.jsonc

{
  "$schema": "./node_modules/wrangler/config-schema.json",
  "migrations": [
    {
      "tag": "v1",
      "new_sqlite_classes": ["MyDurableObject"]
    }
  ]
}

wrangler.toml

[[migrations]]
tag = "v1"
new_sqlite_classes = [ "MyDurableObject" ]

SQLite バックエンドの利点

• SQLite-backed Durable Objects は key-value バックエンドと機能上の互換性があります（key-value ストレージ API を含む）。
• さらに、リレーショナルな SQL クエリをサポートし、過去 30 日間の任意の時点にオブジェクトのストレージを復元できるポイントインタイムリカバリが利用可能です。

エラー例

影響を受けるアカウントで new_classes マイグレーションを使って新しい key-value バックエンドの名前空間を作成しようとすると、デプロイは以下のエラーで失敗します:

Creating new key-value backed Durable Object namespaces is no longer supported on this account. Please create a namespace using a `new_sqlite_classes` migration instead.

注意事項

• この変更は、既に key-value ストレージバックエンドを使用している名前空間を持たないアカウントにのみ影響します。既に少なくとも 1 つの key-value バックエンドの名前空間を持つアカウントは、現時点では新しい KV 名前空間を作成できます。
• Workers Free プランは最初から SQLite-backed Durable Objects のみをサポートしています。
• この変更は、既存の key-value バックエンドのオブジェクトに対する将来の移行パスに先立つ、Durable Objects の単一ストレージバックエンドを SQLite に統一するための一環です。

参考

• Durable Objects migrations