KV 네임스페이스

KV 네임스페이스의 개념과 Wrangler 또는 Cloudflare 대시보드를 통해 Worker에 바인딩하는 방법을 알아봐요. 관할권(jurisdiction) 제한과 바인딩 설정의 각 항목도 함께 살펴봐요.

출처: 문서

본문

KV 네임스페이스는 Cloudflare의 글로벌 네트워크에 복제되는 키-값 데이터베이스예요.

KV 네임스페이스는 Wrangler 또는 Cloudflare 대시보드를 통해 바인딩해요.

KV 네임스페이스 ID는 공개이며 계정에 바인딩돼요.

관할권 (Jurisdictions)

네임스페이스는 선택적으로 특정 리전 내에서만 데이터를 지속 저장하도록 관할권으로 제한할 수 있어요. 자세한 내용은 데이터 위치를 참조하세요.

Wrangler로 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>"

대시보드를 통해 KV 네임스페이스 바인딩하기

Cloudflare 대시보드에서 네임스페이스를 Worker에 바인딩하려면:

1. Cloudflare 대시보드에서 Workers & Pages 페이지로 이동해요. Workers & Pages로 이동 ↗
2. Worker 를 선택해요.
3. Settings > Bindings 를 선택해요.
4. Add 를 선택해요.
5. KV Namespace 를 선택해요.
6. 원하는 변수 이름 (바인딩의 이름) 을 입력해요.
7. Worker를 바인딩하려는 KV 네임스페이스를 선택해요.
8. Deploy 를 선택해요.

더 알아보기 (Learn more)

바인딩이 Worker 코드에서 어떻게 사용되는지는 KV 바인딩 문서를 참고하세요. KV의 내부 동작 원리는 KV 작동 방식 문서에서 확인할 수 있어요.