跳转到内容
搜索文档

删除键值对

最后更新 查看 MarkdownAgent 设置

要删除键值对,请在已绑定到 Worker 代码的任何 KV 命名空间KV 绑定(binding) 上调用 delete() 方法:

env.NAMESPACE.delete(key);
self.env.NAMESPACE.delete(key)

示例

从 Worker 内部删除键值对的示例:

export default {
  async fetch(request, env, ctx) {
    try {
      await env.NAMESPACE.delete("first-key");

      return new Response("Successful delete", {
        status: 200
      });
    }
    catch (e)
    {
      return new Response(e.message, {status: 500});
    }
  },
};
from workers import WorkerEntrypoint, Response

class Default(WorkerEntrypoint):
    async def fetch(self, request):
        try:
            await self.env.NAMESPACE.delete("first-key")

            return Response("Successful delete", status=200)
        except Exception as e:
            return Response(str(e), status=500)

参考

KV 提供以下方法用于删除:

delete() 方法

要删除键值对,请在已绑定到 Worker 代码的任何 KV 命名空间的 KV 绑定(binding) 上调用 delete() 方法:

env.NAMESPACE.delete(key);
await self.env.NAMESPACE.delete(key)

参数

  • key: string
    • 与值关联的键。

响应

  • response: Promise<void>
    • 如果删除成功则解析的 Promise

此方法返回一个 promise,你应 await 它以验证删除成功。对不存在的键调用 delete() 会作为成功删除返回。

调用 delete() 方法将从 KV 命名空间中删除键和值。与任何操作一样,键从 Cloudflare 全球网络中的各个点删除可能需要一些时间。

指南

批量删除数据

使用 Wrangler 或通过 REST API 一次删除多个键值对。

批量 REST API 一次最多可接受 10,000 个 KV 对。使用 KV 绑定(binding) 不支持批量写入。

其他访问 KV 的方法

你也可以使用 Wrangler 从命令行删除键值对,或使用 REST API

这篇文档对您有帮助吗?