Create a KV Namespace

Edge KV는 CDNetworks Edge Application에서 제공하는 전 세계적으로 분산된 키-값 저장소 서비스로, 짧은 지연 시간, 높은 가용성 및 강력한 데이터 일관성이 필요한 시나리오를 위해 설계되었습니다. 사용자에게 더 가까운 에지 PoP에 데이터를 저장할 수 있습니다. Edge KV는 개발자가 데이터를 자주 쓰지 않고 에지 함수가 데이터를 자주 읽는 시나리오에 특히 적합합니다.
예를 들어, 콘솔을 통해 Edge KV에 데이터를 쓴 다음 Edge Cloud Apps 함수에 내장된 런타임 API를 사용하여 클라이언트 요청을 처리하기 위해 고주파수로 데이터를 읽을 수 있습니다. Edge Cloud Apps 함수와 Edge KV를 결합하면 경량 BaaS 서비스, API 게이트웨이 및 기타 서비스와 기능을 빠르게 구축할 수 있습니다.
Edge KV를 사용하기 전에 데이터를 저장할 네임스페이스를 생성해야 합니다.

네임스페이스란?

네임스페이스는 Edge KV 내에서 데이터를 구성하고 격리하는 데 사용되는 논리적 컨테이너입니다. 이름 충돌을 방지하고 데이터 보안을 강화하기 위해 서로 다른 애플리케이션 또는 서비스의 데이터를 별도의 네임스페이스에 저장할 수 있습니다. 각 네임스페이스에는 해당 네임스페이스 내의 데이터를 식별하고 액세스하는 데 사용되는 고유한 이름이 있습니다. 네임스페이스 이름은 전체 CDNetworks Edge Application 플랫폼에서 고유해야 합니다.

네임스페이스 생성

CDNetworks 콘솔을 통해 Edge KV 네임스페이스를 쉽게 생성할 수 있습니다.

1. CDNetworks 콘솔에 로그인하고 에지 애플리케이션 제품을 선택하고 에지 키-값 메뉴를 찾은 다음 네임스페이스 목록을 클릭합니다.
2. 페이지에서 공간 생성 버튼을 클릭하면 네임스페이스 생성 창이 나타납니다.
3. 네임스페이스 생성 페이지에서 다음 정보를 입력해야 합니다.

• 버킷 이름: 네임스페이스에 대한 원하는 이름을 입력합니다(예: my-app-data). 네임스페이스 이름은 전역적으로 고유해야 하며 길이는 4~32자여야 하며 숫자, 소문자 영문자 및 밑줄만 포함할 수 있습니다.
• 공간 별칭: 콘솔에서 쉽게 구분할 수 있도록 네임스페이스에 대한 사용자 친화적인 별칭을 제공합니다. 공간 별칭은 길이가 6~64자일 수 있으며 한자(각각 2자 차지), 숫자, 대소문자 영문자 및 밑줄을 포함할 수 있습니다.
• 모드 유형: 사용 사례에 따라 적절한 모드 유형을 선택하여 데이터를 저장하고 액세스하는 방법을 결정합니다. Edge KV는 전역 모드, 로컬 모드 및 미러 모드의 세 가지 모드를 제공합니다.
• 저장 기간: KV 네임스페이스 내의 키에 대한 최대 저장 기간을 설정합니다. 전역 모드의 기본값은 영구 저장이며 로컬 및 미러 모드의 기본값은 30일입니다. 특정 요구 사항에 따라 적합한 저장 기간을 선택할 수 있습니다. 각 키의 만료 시간은 이 기간을 초과할 수 없습니다.

매개변수 설명

네임스페이스 매개변수에 대한 자세한 내용은 사용 제한 문서를 참조하세요.

4. 확인 버튼을 클릭하여 네임스페이스 생성을 완료합니다.

네임스페이스 보기

네임스페이스를 생성한 후 공간 관리 인터페이스에서 세부 정보를 보고 관리할 수 있습니다.

1. CDNetworks 콘솔에 로그인하고 에지 애플리케이션 제품을 선택하고 에지 키-값 메뉴를 찾은 다음 네임스페이스 목록을 클릭합니다.
2. 관리하려는 네임스페이스를 찾고 오른쪽에 있는 공간 관리 버튼을 클릭합니다.
3. 기본 정보 섹션에서 네임스페이스의 이름, 별칭, 모드 및 설명을 볼 수 있습니다. 여기에서 네임스페이스 별칭을 수정하고 설명을 추가할 수도 있습니다.
4. 공간 속성 섹션에는 저장 기간, 공간 크기, 키 길이 제한 및 값 길이 제한을 포함한 네임스페이스의 속성이 표시됩니다.
5. 공간 콘텐츠 섹션에는 네임스페이스에 저장된 실제 데이터가 표시됩니다. 여기에서 KV 데이터를 추가, 보기 및 삭제할 수 있습니다.

네임스페이스 콘텐츠 추가 및 관리

다음 두 가지 방법으로 Edge KV 네임스페이스에 키-값 쌍을 추가하고 관리할 수 있습니다.

콘솔을 통해

CDNetworks 콘솔을 사용하면 Edge KV 데이터를 직관적으로 추가, 보기 및 삭제할 수 있습니다.

1. 새 키-값 쌍을 추가하려면 공간 콘텐츠 섹션에서 추가 버튼을 클릭합니다. 그러면 키, 값 및 만료 시간을 입력할 수 있는 창이 열립니다.
2. 키-값 추가 창에서 키, 값 및 만료 시간을 입력합니다.

참고
만료 시간은 현재 네임스페이스의 저장 기간 이하여야 합니다. 길이가 플랫폼의 요구 사항을 충족하는 한 모든 키-값 쌍을 업로드할 수 있습니다.

3. 키-값 쌍을 추가하면 공간 콘텐츠 영역에서 볼 수 있습니다. 오른쪽 작업 모음에서 전체 값 다운로드 버튼을 클릭하여 전체 값을 볼 수 있습니다. 키-값 쌍을 삭제하려면 삭제 버튼을 클릭합니다. 삭제를 확인하면 시스템에서 선택한 키 값을 즉시 삭제합니다. 여러 키를 선택하고 일괄 삭제 버튼을 클릭하여 일괄 삭제를 수행할 수도 있습니다.

   참고: 키를 삭제하면 전체 플랫폼에서 즉시 적용되며 영구적입니다. 서비스 및 기능에 영향을 미치지 않도록 중요한 데이터를 백업하고 삭제의 필요성을 신중하게 확인하세요.

Edge Cloud Apps 함수를 통해

Edge Cloud Apps Function Compute에 내장된 런타임 API를 통해 Edge KV를 보다 유연하고 세분화된 방식으로 관리할 수 있습니다. 이를 통해 작업을 자동화하고 다른 서비스와 원활하게 통합할 수 있습니다. 또한 CloudIDE에서 직접 코드를 작성하고 디버깅하여 코드가 예상대로 작동하는지 확인할 수 있습니다.

참고
API를 사용하여 Edge KV 데이터를 관리하기 전에 콘솔에서 네임스페이스를 이미 생성했는지 확인하세요.

자세한 API 사용 지침은 Edge KV 런타임 API 문서를 참조하세요.

예를 들면 다음과 같습니다.

1. 생성자를 호출하고 네임스페이스를 전달하여 Edge KV 인스턴스 객체를 생성합니다.

   const edgeKv = new EdgeKV({ namespace: "your-namespace" });
   

   namespace 는 콘솔에서 생성한 저장 공간의 이름이며 공간 목록에서 확인할 수 있습니다.

2. 인스턴스 객체를 성공적으로 생성한 후 필요에 따라 다음 내장 API를 호출하여 다양한 기능을 구현할 수 있습니다.

   API	기능
   get()	네임스페이스에서 데이터를 검색합니다.
   put()	새 키-값 쌍을 생성하거나 기존 키의 값을 업데이트합니다.
   list()	지정된 기준을 충족하는 네임스페이스의 키를 나열합니다.
   count()	지정된 기준을 충족하는 네임스페이스의 키 수를 계산합니다.
   delete()	지정된 키와 해당 값을 네임스페이스에서 삭제합니다.

네임스페이스 삭제

CDNetworks 콘솔을 통해 더 이상 필요하지 않은 네임스페이스를 삭제할 수 있습니다. 네임스페이스를 삭제하면 해당 네임스페이스 내의 모든 데이터가 영구적으로 제거되며 이 작업은 되돌릴 수 없으며 해당 네임스페이스 내의 값을 사용하는 모든 기능에 영향을 미칩니다.

1. CDNetworks 콘솔에 로그인하고 에지 애플리케이션 제품을 선택하고 에지 키-값 메뉴를 찾은 다음 공간 목록을 클릭합니다.
2. 네임스페이스 목록에서 삭제하려는 네임스페이스를 찾습니다.
3. 네임스페이스 오른쪽에 있는 삭제 버튼을 클릭합니다.
4. 확인 대화 상자가 나타나 네임스페이스 삭제를 확인하라는 메시지가 표시됩니다.
5. 확인 버튼을 클릭하여 네임스페이스를 삭제합니다.

참고 사항

• 데이터 격리 및 보안을 강화하려면 서로 다른 애플리케이션 또는 서비스에 대해 별도의 네임스페이스를 생성하고 쉽게 식별하고 관리할 수 있도록 명확하고 이해하기 쉬운 네임스페이스 이름을 사용하는 것이 좋습니다.
• 실수로 데이터가 손실된 경우 데이터를 빠르게 복구할 수 있도록 Edge KV 데이터를 정기적으로 백업하여 비즈니스 연속성을 보장하세요.