跳转到内容
搜索文档

KV 命名空间

最后更新 查看 MarkdownAgent 设置

KV 命名空间是复制到 Cloudflare 全球网络的键值数据库。

通过 Wrangler 或 Cloudflare 仪表板绑定 KV 命名空间。

通过 Wrangler 绑定 KV 命名空间

要将 KV 命名空间绑定到 Worker,请将以下对象数组分配给 kv_namespaces 键。

  • binding stringrequired

    • 用于引用 KV 命名空间的绑定(binding)名称。
  • id stringrequired

    • KV 命名空间的 ID。
  • preview_id stringoptional

    • wrangler dev 期间使用的 KV 命名空间 ID。

示例:

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

通过仪表板绑定 KV 命名空间

要在 Cloudflare 仪表板中将命名空间绑定到 Worker:

  1. 在 Cloudflare 仪表板中,前往 Workers & Pages 页面。

    Go to Workers & Pages ↗
  2. 选择你的 Worker

  3. 选择 Settings(设置) > Bindings(绑定)

  4. 选择 Add(添加)

  5. 选择 KV Namespace(KV 命名空间)

  6. 输入所需的变量名(绑定(binding)的名称)。

  7. 选择要绑定 Worker 的 KV 命名空间。

  8. 选择 Deploy(部署)

这篇文档对您有帮助吗?