INTEGRITY Документация

Cloudflare Workers KV

Создайте глобальное хранилище данных типа ключ-значение с низкой задержкой.

Доступно на планах Free и Paid

Workers KV представляет собой хранилище данных, которое позволяет сохранять и получать данные в глобальном масштабе. С помощью Workers KV вы можете создавать динамичные и производительные API и сайты, которые выдерживают высокие объёмы чтения с низкой задержкой.

Например, Workers KV можно использовать для:

Доступ к пространству имён Workers KV из Cloudflare Workers с использованием Workers Bindings либо из вашего внешнего приложения с помощью REST API:

export default {
	async fetch(request, env, ctx): Promise<Response> {
		// write a key-value pair
		await env.KV.put('KEY', 'VALUE');

		// read a key-value pair
		const value = await env.KV.get('KEY');

		// list all key-value pairs
		const allKeys = await env.KV.list();

		// delete a key-value pair
		await env.KV.delete('KEY');

		// return a Workers response
		return new Response(
			JSON.stringify({
				value: value,
				allKeys: allKeys,
			}),
		);
	},

} satisfies ExportedHandler<{ KV: KVNamespace }>;
{
	"$schema": "node_modules/wrangler/config-schema.json",
	"name": "<ENTER_WORKER_NAME>",
	"main": "src/index.ts",
	"compatibility_date": "2025-02-04",
	"observability": {
		"enabled": true
	},

	"kv_namespaces": [
		{
			"binding": "KV",
			"id": "<YOUR_BINDING_ID>"
		}
	]
}

Ознакомьтесь с полным Справочник API привязки Workers KV.

curl https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/storage/kv/namespaces/$NAMESPACE_ID/values/$KEY_NAME \
		-X PUT \
		-H 'Content-Type: multipart/form-data' \
		-H "X-Auth-Email: $CLOUDFLARE_EMAIL" \
		-H "X-Auth-Key: $CLOUDFLARE_API_KEY" \
		-d '{
			"value": "Some Value"
		}'

curl https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/storage/kv/namespaces/$NAMESPACE_ID/values/$KEY_NAME \
		-H "X-Auth-Email: $CLOUDFLARE_EMAIL" \
		-H "X-Auth-Key: $CLOUDFLARE_API_KEY"
const client = new Cloudflare({
	apiEmail: process.env['CLOUDFLARE_EMAIL'], // This is the default and can be omitted
	apiKey: process.env['CLOUDFLARE_API_KEY'], // This is the default and can be omitted
});

const value = await client.kv.namespaces.values.update('<KV_NAMESPACE_ID>', 'KEY', {
	account_id: '<ACCOUNT_ID>',
	value: 'VALUE',
});

const value = await client.kv.namespaces.values.get('<KV_NAMESPACE_ID>', 'KEY', {
	account_id: '<ACCOUNT_ID>',
});

const value = await client.kv.namespaces.values.delete('<KV_NAMESPACE_ID>', 'KEY', {
	account_id: '<ACCOUNT_ID>',
});

// Automatically fetches more pages as needed.
for await (const namespace of client.kv.namespaces.list({ account_id: '<ACCOUNT_ID>' })) {
	console.log(namespace.id);
}

См. полный Workers KV Справочник REST API и SDK для получения сведений об использовании REST API из внешних приложений: для TypeScript, Python и Go предусмотрены готовые SDK.

Начало работы

Возможности

Хранилище ключ-значение

Узнайте, как Workers KV хранит и извлекает данные.

Wrangler

Интерфейс командной строки Workers, Wrangler, позволяет вам создать, тест, а также deploy ваших проектов Workers.

Bindings

Привязки позволяют Workers взаимодействовать с ресурсами платформы разработчика Cloudflare, включая R2, Durable Objects, а также D1.

Юрисдикции

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


R2

Cloudflare R2 Storage позволяет разработчикам хранить большие объёмы неструктурированных данных без дорогостоящей платы за исходящий трафик, характерной для типичных облачных хранилищ.

Durable Objects

Cloudflare Durable Objects предоставляет разработчикам доступ к масштабируемым вычислениям и постоянному согласованному хранилищу данных.

D1

D1 построена на основе SQLite и является первой реляционной базой данных Cloudflare с поддержкой запросов. Вы можете создать целую базу данных, импортировав данные или определив таблицы, и писать запросы прямо в Worker или через API.


Дополнительные ресурсы

Лимиты

Подробнее об ограничениях KV.

Цены

Подробнее о тарификации KV.

Discord

Задавайте вопросы, делитесь тем, что вы создаёте, и обсуждайте платформу с другими разработчиками.

Twitter

Узнайте об анонсах продуктов, новых руководствах и других новостях Cloudflare Developer Platform.

Содержание

34 страницы, скопированные из документации Cloudflare для kv.

Pages

Workers Binding API

Основные понятия

Примеры

Observability

Платформа

Справочник