KV 名前空間

KV 名前空間は、Cloudflare のグローバルネットワークに複製されるキーバリューデータベースです。

Wrangler または Cloudflare ダッシュボードで、KV 名前空間をバインドします。

名前空間は任意で管轄区域に制限し、特定の地域内にだけデータを永続保存できます。この機能は現在プライベートベータです。詳細は データの保存場所 を参照してください。

KV 名前空間を Worker にバインドするには、次のオブジェクトの配列を kv_namespaces キーに割り当てます。

• binding string 必須

  • KV 名前空間を参照するときに使うバインディング名です。

• id string 必須

  • KV 名前空間の ID です。

• preview_id string 任意

  • wrangler dev の実行中に使う KV 名前空間の ID です。

例:

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

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

Cloudflare ダッシュボードで名前空間を Worker にバインドする手順は次のとおりです。

1. Cloudflare ダッシュボードで、Workers & Pages ページを開きます。

   Workers & Pages を開く ↗

2. Worker を選択します。

3. Settings > Bindings を選択します。

4. Add を選択します。

5. KV Namespace を選択します。

6. 使いたい変数名（バインディング名）を入力します。

7. Worker にバインドする KV 名前空間を選択します。

8. Deploy を選択します。