上限

Durable Objects は特殊な種類の Worker です。そのため、Workers プランに応じて Workers の上限 が適用されます。加えて、Durable Objects にはこのページに示す固有の上限があります。

SQLite ストレージ を使う Durable Object クラスには、次の SQL 上限が適用されます。

Durable Objects は、多数の Durable Object に対して水平スケールできます。個々の Object は本質的にシングルスレッドです。

• 個々の Object には、1 秒あたり 1,000 リクエストのソフト上限があります。名前空間あたりの個々のオブジェクト数に上限はありません。
• 小さな値に対する単純な ストレージ get() をそのまま返す場合、大きな JSON 値をシリアライズ / デシリアライズする Durable Object よりも、高いリクエストスループットを出せることがあります。
• 同様に、複数の list() 操作を行う Durable Object は、リクエストスループットの面でより制約を受けやすくなります。

リクエストが多すぎる Durable Object は、いったんキューに入れたあと、呼び出し元に overloaded エラーを返します。

Durable Objects は、システム内の個々のオブジェクト数を制限する必要がないように設計されており、水平にスケールできます。

• 1 つの Durable Object 名前空間 内で、必要な数だけ個別の Durable Object を作成して実行できます。
• Workers Paid プランで SQLite バックエンドの Durable Objects を使う場合、アカウントあたりのストレージ上限はありません。
• SQLite バックエンドの各 Durable Object には、Workers Paid プランで 10 GB のストレージ上限があります。
• 詳細は Durable Object の上限 を参照してください。

Durable Objects は Worker スクリプトであり、他の Workers と同じ 呼び出しあたりの CPU 制限 が適用されます。CPU 時間はアクティブな処理時間です。ネットワークリクエスト、ストレージ呼び出し、その他の一般的な I/O の待ち時間は、CPU 時間や Durable Objects のコンピュート消費には含まれません。

デフォルトでは、Durable Objects の呼び出し（HTTP リクエスト、WebSocket メッセージ、または Alarm）あたりの最大 CPU 時間は 30 秒です。Wrangler 設定の limits.cpu_ms を指定すると、その Durable Object 定義に紐づくすべての Durable Objects で引き上げられます。

{
	// ...rest of your configuration...
	"limits": {
		"cpu_ms": 300000, // 300,000 milliseconds = 5 minutes
	},
	// ...rest of your configuration...
}

[limits]
cpu_ms = 300_000

SQLite バックエンドの Durable Object が ストレージ上限（Workers Paid では 10 GB、Free プランでは 1 GB）に達すると、書き込み操作（INSERT、UPDATE、または put() と sql.exec() ストレージ API の呼び出し）は次のエラーで失敗します。

database or disk is full: SQLITE_FULL

読み取り操作（SELECT クエリ、get()、list() の呼び出し）は引き続き動作し、空き容量を確保するための DELETE 操作も成功します。

このエラーを Durable Object 内で扱うには、ストレージ API が投げる例外を捕捉します。

try {
	this.ctx.storage.sql.exec(
		"INSERT INTO my_table (key, value) VALUES (?, ?)",
		key,
		value,
	);
} catch (e) {
	if (e.message.includes("SQLITE_FULL")) {
		// Storage limit reached — reads and deletes still work
		// Consider deleting old data or returning a meaningful error to the caller
	}
	throw e;
}

ウォールタイム（ウォールクロック時間とも呼ばれます）は、呼び出しの開始から終了までの経過時間の合計です。ネットワークリクエスト、I/O、その他の非同期処理の待ち時間も含みます。CPU 時間 とは異なります。CPU 時間は、CPU がコードを実際に実行している時間だけを測ります。

次の表は、開発者プラットフォーム全体における Worker の呼び出し種別ごとのウォールタイム上限です。