← Cloudflare Durable Objects / durable-objects / platform

Лимиты

Durable Objects являются особым видом Worker, поэтому Лимиты Workers действуют в соответствии с вашим тарифным планом Workers. Кроме того, у Durable Objects есть отдельные ограничения, перечисленные на этой странице.

Для классов Durable Object с Хранилище SQLite действуют следующие ограничения SQL:

Durable Objects могут масштабироваться горизонтально за счёт множества Durable Objects. При этом каждый отдельный объект по своей природе однопоточен.

• Для отдельного объекта установлено мягкое ограничение в 1000 запросов в секунду. Количество отдельных объектов в пределах одного пространства имён не ограничено.
• Простой хранилище get() над небольшим значением, которое напрямую возвращает ответ, может обеспечить более высокую пропускную способность запросов по сравнению с Durable Object, который, например, сериализует и (или) десериализует большие JSON-значения.
• Аналогично, Durable Object, который выполняет несколько list() операции могут быть более ограничены по пропускной способности запросов.

Durable Object, получающий слишком много запросов, после попытки поставить их в очередь вернёт перегружен ошибку вызывающей стороне.

Durable Objects спроектированы так, что количество отдельных объектов в системе не ограничено и может масштабироваться горизонтально.

• Вы можете создавать и запускать сколько угодно отдельных Durable Objects в рамках заданного пространство имён.
• На плане Workers Paid ограничений на объём хранилища на аккаунт для Durable Objects на основе SQLite нет.
• Каждый Durable Object с хранилищем SQLite имеет ограничение хранилища в 10 GB на тарифе Workers Paid.
• См. Лимиты Durable Object, где это описано подробнее.

Durable Objects являются скриптами Worker и обладают теми же лимиты CPU на один вызов как и любые другие Workers. Обратите внимание, что процессорное время означает время активной обработки: оно не включает время ожидания сетевых запросов, обращений к хранилищу и прочего ввода-вывода, которое не учитывается в процессорном времени и потреблении вычислительных ресурсов Durable Objects.

По умолчанию максимальное время CPU на один вызов Durable Object (HTTP запрос, сообщение WebSocket или будильник) составляет 30 секунд, но его можно увеличить для всех Durable Objects, связанных с определением Durable Object, задав limits.cpu_ms в конфигурации Wrangler:

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

[limits]
cpu_ms = 300_000

Когда Durable Object на основе SQLite достигает своего максимальный лимит хранилища (10 ГБ на Workers Paid или 1 ГБ на плане Free), операции записи (например, INSERT, UPDATE, или вызовов put() и sql.exec() storage API) завершатся ошибкой следующего вида:

database or disk is full: SQLITE_FULL

Операции чтения (например, SELECT запросов, get(), а также list() вызовы) продолжат работать, а DELETE операции также будут выполняться успешно, чтобы вы могли удалять данные и освобождать место.

Чтобы обработать эту ошибку в своём Durable Object, перехватите исключение, которое выбрасывает 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;
}

Астрономическое время (также называемое wall-clock time) обозначает общее время, прошедшее от начала до конца вызова, включая время ожидания сетевых запросов, операций ввода-вывода и других асинхронных операций. Это отличается от Процессорное время, который измеряет только время, которое CPU активно тратит на выполнение вашего кода.

В следующей таблице приведены ограничения по фактическому времени выполнения для разных типов вызовов Worker на платформе для разработчиков: