← Cloudflare Workers KV / kv / concepts

Пространства имён KV

Пространство имён KV представляет собой базу данных типа «ключ-значение», реплицированную в глобальной сети Cloudflare.

Привязывайте свои пространства имён KV через Wrangler или через панель управления Cloudflare.

Пространства имён можно при необходимости ограничить юрисдикцией, чтобы данные надёжно хранились только в определённом регионе. Эта функция сейчас находится на этапе закрытого бета-тестирования. См. Расположение данных, где это описано подробнее.

Чтобы привязать пространства имен KV к Worker, присвойте массив из указанного ниже объекта kv_namespaces ключ.

• binding string обязательно

  • Имя привязки, используемое для обращения к пространству имён KV.

• id string обязательно

  • ID пространства имен KV.

• preview_id string необязательно

  • Идентификатор пространства имен KV, используемого во время wrangler dev.

Пример:

{
	"kv_namespaces": [
		{
			"binding": "<TEST_NAMESPACE>",
			"id": "<TEST_ID>"
		}
	]
}

[[kv_namespaces]]
binding = "<TEST_NAMESPACE>"
id = "<TEST_ID>"

Чтобы привязать пространство имён к вашему Worker в панели управления Cloudflare:

1. На панели управления Cloudflare перейдите к разделу Workers & Pages страницу.

   Перейдите в Workers & Pages ↗

2. Выберите свой Worker.

3. Выберите Настройки > Bindings.

4. Выберите Add.

5. Выберите KV Namespace.

6. Введите нужное имя переменной (имя привязки).

7. Выберите пространство имен KV, к которому нужно привязать Worker.

8. Выберите Развернуть.