키-값 쌍 삭제하기

Workers KV에서 키-값 쌍을 삭제하는 delete() 메서드 사용법을 알아봐요. Worker 코드에 바인딩한 KV 네임스페이스에서 간단히 호출해 데이터를 제거하고, 벌크 삭제와 REST API 사용법까지 함께 살펴봐요.

출처: 문서

본문

키-값 쌍을 삭제하려면 Worker 코드에 바인딩한 아무 KV 네임스페이스에서 KV 바인딩의 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()

delete() 메서드

키-값 쌍을 삭제하려면 Worker 코드에 바인딩한 아무 KV 네임스페이스에서 KV 바인딩의 delete() 메서드를 호출하면 돼요:

env.NAMESPACE.delete(key);

await self.env.NAMESPACE.delete(key)

매개변수 (Parameters)

• key: string
  • 값과 연관시킬 키예요.

응답 (Response)

• response: Promise<void>
  • 삭제가 성공하면 resolve되는 Promise 예요.

이 메서드는 성공적인 삭제를 확인하기 위해 await 해야 하는 promise를 반환해요. 존재하지 않는 키에 delete() 를 호출해도 성공적인 삭제로 반환돼요.

delete() 메서드를 호출하면 키와 값을 KV 네임스페이스에서 제거해요. 다른 모든 작업과 마찬가지로, 키가 Cloudflare 글로벌 네트워크의 다양한 지점에서 삭제되는 데는 약간의 시간이 걸릴 수 있어요.

가이드

데이터 대량 삭제하기

Wrangler 또는 REST API를 통해 한 번에 여러 개의 키-값 쌍을 삭제할 수 있어요.

벌크 REST API는 한 번에 최대 10,000개의 KV 쌍을 받을 수 있어요. 벌크 쓰기는 KV 바인딩을 사용해서는 지원되지 않아요.

KV에 접근하는 다른 방법

또한 명령줄에서 Wrangler로 키-값 쌍을 삭제하거나 REST API로 삭제할 수도 있어요.

더 알아보기 (Learn more)

키-값 쌍의 쓰기와 읽기에 대한 자세한 내용은 쓰기 및 읽기 문서를 참고하세요. 벌크 작업의 상세 규격은 KV API 참조 문서에서 확인할 수 있어요.