INTEGRITY Dokumentace

Cloudflare Workers KV

Vytvořte globální úložiště dat typu klíč-hodnota s nízkou latencí.

Dostupné v plánu Free a v placených plánech

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.

Začínáme

Funkce

Úložiště klíč-hodnota

Přečtěte si, jak Workers KV ukládá a načítá data.

Wrangler

Rozhraní příkazové řádky pro Workers, Wrangler, vám umožňuje vytvořit, test, a deploy vaše projekty Workers.

Bindings

Vazby (bindings) umožňují Workers pracovat se zdroji na vývojářské platformě Cloudflare, včetně R2, Durable Objects, a D1.

Jurisdikce

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.


R2

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.

Durable Objects

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

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.


Další zdroje

Limity

Přečtěte si o limitech KV.

Ceny

Přečtěte si o cenách KV.

Discord

Ptejte se, pochlubte se tím, co vytváříte, a diskutujte o platformě s ostatními vývojáři.

Twitter

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.

Obsah

34 stránek zrcadlených z dokumentace Cloudflare pro kv.

Pages

Workers Binding API

Klíčové koncepty

Příklady

Observabilita

Platforma

Referenční informace