← Cloudflare Durable Objects / durable-objects / platform

Limity

Durable Objects jsou zvláštní typ Workeru, takže Workers Limits se uplatňují podle vašeho plánu Workers. Durable Objects navíc mají specifické limity uvedené na této stránce.

U tříd Durable Object s Úložiště SQLite platí tato omezení SQL:

Durable Objects lze škálovat horizontálně napříč velkým množstvím Durable Objects. Každý jednotlivý objekt je ze své podstaty jednovláknový.

• Jednotlivý objekt má měkký limit 1,000 požadavků za sekundu. Počet jednotlivých objektů v rámci namespace není omezen.
• Jednoduchý úložiště get() na malé hodnotě, která rovnou vrátí odpověď, může dosáhnout vyšší propustnosti požadavků než Durable Object, který (například) serializuje nebo deserializuje velké JSON hodnoty.
• Podobně platí, že Durable Object, který provádí více list() operace mohou mít omezenější propustnost požadavků.

Durable Object, který obdrží příliš mnoho požadavků, se je nejprve pokusí zařadit do fronty a poté vrátí přetížený chybu volajícímu.

Durable Objects jsou navržené tak, že počet jednotlivých objektů v systému nemusí být omezený a lze je škálovat horizontálně.

• Můžete vytvořit a spouštět tolik samostatných Durable Objects, kolik chcete, v rámci daného namespace.
• Při použití Durable Objects s úložištěm SQLite na plánu Workers Paid neplatí pro úložiště na účet žádné limity.
• Každý Durable Object s úložištěm SQLite má v plánu Workers Paid limit úložiště 10 GB.
• Viz Limity Durable Object s dalšími informacemi.

Durable Objects jsou skripty Workeru a mají stejné limity CPU na jedno volání stejně jako kterýkoli jiný Worker. Upozorňujeme, že čas CPU je aktivní čas zpracování: nezapočítává se do něj čas čekání na síťové požadavky, volání úložiště ani jiné obecné vstupně výstupní operace, takže se nepočítají do vašeho času CPU ani do spotřeby výpočetního výkonu Durable Objects.

Ve výchozím nastavení je maximální doba CPU na jedno volání Durable Object (HTTP požadavek, zpráva WebSocket nebo Alarm) nastavena na 30 sekund, ale lze ji zvýšit pro všechny Durable Objects patřící k dané definici Durable Object nastavením limits.cpu_ms ve vaší konfiguraci Wrangler:

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

[limits]
cpu_ms = 300_000

Když Durable Object s úložištěm SQLite dosáhne svého maximální limit úložiště (10 GB v plánu Workers Paid nebo 1 GB v plánu Free), operace zápisu (například INSERT, UPDATE, nebo volání do put() a sql.exec() storage API) selžou s následující chybou:

database or disk is full: SQLITE_FULL

Operace čtení (například SELECT dotazů, get(), a list() volání) budou nadále fungovat a DELETE operace se také podaří, takže můžete data odstranit a uvolnit místo.

Chcete-li tuto chybu ve svém Durable Object ošetřit, zachyťte výjimku vyvolanou storage 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;
}

Reálný čas (anglicky též "wall-clock time") představuje celkovou dobu od začátku do konce vyvolání, včetně času stráveného čekáním na síťové požadavky, I/O operace a další asynchronní operace. Liší se od Čas CPU, které měří pouze čas, který CPU stráví aktivním prováděním vašeho kódu.

Následující tabulka shrnuje limity reálného času pro různé typy vyvolání Workeru v rámci vývojářské platformy: