Лимиты
Подробнее об ограничениях KV.
Создайте глобальное хранилище данных типа ключ-значение с низкой задержкой.
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 хранит и извлекает данные.
Привязки позволяют Workers взаимодействовать с ресурсами платформы разработчика Cloudflare, включая R2, Durable Objects, а также D1.
Ограничьте пространство имен KV, чтобы данные надежно хранились только в определенной юрисдикции и это помогало соответствовать требованиям комплаенса. Сейчас функция доступна в закрытой бета версии.
Cloudflare R2 Storage позволяет разработчикам хранить большие объёмы неструктурированных данных без дорогостоящей платы за исходящий трафик, характерной для типичных облачных хранилищ.
Cloudflare Durable Objects предоставляет разработчикам доступ к масштабируемым вычислениям и постоянному согласованному хранилищу данных.
D1 построена на основе SQLite и является первой реляционной базой данных Cloudflare с поддержкой запросов. Вы можете создать целую базу данных, импортировав данные или определив таблицы, и писать запросы прямо в Worker или через API.
Подробнее об ограничениях KV.
Подробнее о тарификации KV.
Задавайте вопросы, делитесь тем, что вы создаёте, и обсуждайте платформу с другими разработчиками.
Узнайте об анонсах продуктов, новых руководствах и других новостях Cloudflare Developer Platform.
34 страницы, скопированные из документации Cloudflare для kv.