Limity
Přečtěte si o limitech KV.
Vytvořte globální úložiště dat typu klíč-hodnota s nízkou latencí.
Workers KV je úložiště dat, které umožňuje globálně ukládat a načítat data. S Workers KV můžete vytvářet dynamická a výkonná API a weby, jež zvládají vysoký objem čtení s nízkou latencí.
Workers KV můžete využít například pro:
Přístup k vašemu Workers KV namespace z Cloudflare Workers pomocí Workers Bindings nebo z vaší externí aplikace pomocí 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>"
}
]
}Podívejte se na celý Referenční dokumentace API vazby 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);
}Podívejte se na úplný Workers KV Referenční dokumentace REST API a SDK kde najdete podrobnosti o používání REST API z externích aplikací, včetně předpřipravených SDK pro externí aplikace v TypeScriptu, Pythonu nebo Go.
Přečtěte si, jak Workers KV ukládá a načítá data.
Vazby (bindings) umožňují Workers pracovat se zdroji na vývojářské platformě Cloudflare, včetně R2, Durable Objects, a D1.
Omezte KV namespace tak, aby ukládal data trvale pouze v rámci konkrétní jurisdikce, a splňte tak požadavky na soulad s předpisy. Aktuálně dostupné v neveřejné beta verzi.
Cloudflare R2 Storage umožňuje vývojářům ukládat velké objemy nestrukturovaných dat bez nákladných poplatků za odchozí přenos dat (egress), které jsou typické pro běžné cloudové úložné služby.
Cloudflare Durable Objects umožňuje vývojářům přístup ke škálovatelnému výpočetnímu výkonu a trvalému konzistentnímu úložišti.
D1 je první relační databáze Cloudflare s podporou dotazů, postavená na SQLite. Celou databázi můžete vytvořit importem dat nebo definicí tabulek a psaním dotazů přímo ve Workeru nebo přes API.
Přečtěte si o limitech KV.
Přečtěte si o cenách KV.
Ptejte se, pochlubte se tím, co vytváříte, a diskutujte o platformě s ostatními vývojáři.
Přečtěte si o novinkách týkajících se produktů, nových výukových materiálech a o tom, co je nového na platformě Cloudflare Developer Platform.
34 stránek zrcadlených z dokumentace Cloudflare pro kv.