← Cloudflare Workers KV / kv / reference

Часто задаваемые вопросы

Часто задаваемые вопросы о Workers KV.

Общее

Можно ли использовать Workers KV без Workers?

Да, вы можете использовать Workers KV вне Workers с помощью REST API либо связанный с ним SDK Cloudflare для REST API. Важно учитывать ограничения REST API которые применяются.

На что важно обратить внимание при выборе способа доступа к KV?

При выборе способа доступа к Workers KV учитывайте следующее:

Производительность: доступ к Workers KV через Workers Binding API обычно работает быстрее, чем REST API, поскольку это позволяет избежать издержек HTTP запросов.
Ограничения скорости: учитывайте, что для каждого способа доступа действуют разные ограничения по частоте запросов. REST API имеет более низкий лимит скорости записи по сравнению с Workers Binding API. См. Какой лимит запросов у Workers KV?

Почему я не вижу обновлённое значение пары ключ-значение сразу?

Workers KV активно кэширует данные по всей сети Cloudflare. Поэтому вы можете получить кэшированное значение в течение TTL кэша продолжительность.

Workers KV обеспечивает согласованность в конечном счёте или строгую согласованность?

Workers KV обеспечивает согласованность в конечном счёте.

Workers KV хранит данные в центральных хранилищах и реплицирует их во все дата-центры Cloudflare с помощью гибридного подхода push/pull. Это означает, что в конкретном дата-центре предыдущее значение пары «ключ-значение» может отображаться в течение TTL кэша. Это означает, что Workers KV обеспечивает согласованность в конечном счёте.

См. Как работает KV.

Если Worker выполняет массовый запрос к Workers KV, засчитывается ли каждый отдельный ключ в Лимит субзапросов Worker (1000)?

Нет. Массовый запрос к Workers KV, независимо от количества ключей в запросе, засчитывается как одна операция. Например, можно выполнить 500 массовых запросов KV и 500 запросов R2, получив в сумме 1000 операций.

Какой лимит запросов у Workers KV?

Ограничение скорости Workers KV зависит от способа доступа к нему.

Операции с Workers KV через REST API подчиняются тем же ограничения REST API. Это ограничение действует для всех запросов Cloudflare REST API.

При записи в Workers KV через Workers Binding API, ограничение частоты записи составляет 1 запись в секунду на ключ, без ограничений при использовании разных ключей KV.

Цены

При записи через Workers KV REST API, как оплачивается запись?

Каждая пара «ключ-значение» в PUT запрос считается одной операцией записи, точно так же, как и каждый вызов PUT в Workers API считается записью. Запись 5,000 ключей через REST API обходится по стоимости так же, как выполнение 5,000 PUT вызовов в Worker.

Учитываются ли запросы, которые я отправляю из панели управления или wrangler (CLI), как платное использование?

Да, любые операции через панель управления Cloudflare или wrangler, включая обновление (запись) ключей, удаление ключей и получение списка ключей в пространстве имён, учитываются как платное использование Workers KV.

Взимает ли Workers KV плату за передачу данных / исходящий трафик?

Нет.

Тарифицируется ли истечение срока действия ключа как операция удаления?

Нет. Истечение срока действия ключей не является тарифицируемой операцией.