NerdStorage 소개

여러분의 뉴킹릭 제작을 돕기 위해 뉴킹릭 One SDK를 제공합니다. 이 페이지에서는 NerdStorage SDK 구성 요소를 사용하는 방법을 알아봅니다.

앱에서 NerdStorage 사용

NerdStorage를 사용하여 즐겨찾기와 같은 사용자 구성 설정 및 기본 설정이나 기타 작은 데이터 세트를 포함한 간단한 데이터 세트를 저장하고 검색할 수 있습니다. 이 저장 공간은 Nerdpack마다 고유하며 다른 Nerdpack과 공유할 수 없습니다.

NerdStorage는 세 가지 범주로 분류됩니다.

• 사용자 저장소: 특정 사용자에게 첨부되는 데이터입니다. 데이터가 첨부된 사용자로 인증되면 데이터를 읽고 쓸 수 있습니다.
• 계정 저장소: 특정 계정에 연결된 데이터입니다. 인증을 받고 계정에 액세스할 수 있으면 계정 범위의 NerdStorage를 읽고 쓸 수 있습니다. 계정 데이터의 가시성은 마스터 또는 하위 계정 규칙에 의해서도 결정됩니다. 즉, 사용자가 마스터 계정에 대한 액세스 권한이 있으면 모든 하위 계정의 데이터에도 액세스할 수 있습니다.
• 엔터티 저장소: 특정 엔터티에 첨부된 데이터입니다. 해당 엔터티가 보이면 해당 엔터티에 대한 데이터를 읽고 쓸 수 있습니다.

데이터 모델

NerdStorage는 중첩된 핵심 가치 맵으로 상상할 수 있습니다. 데이터는 컬렉션 내부에 중첩된 문서 내부에 있습니다.

{
  "YourNerdpackUuid": {
    "collection-1": {
      "document-1-of-collection-1": "{\"lastNumber\": 42, \"another\": [1]}",
      "document-2-of-collection-1": "\"userToken\""
      // ...
    },
    "another-collection": {
      "fruits": "[\"pear\", \"apple\"]"
      // ...
    }
    // ...
  }
}

각 NerdStorage 레벨에는 서로 다른 속성과 목적이 있습니다.

• 컬렉션: Nerdpack에서 각각의 이름을 지정하여 여러 컬렉션을 만들 수 있습니다. 컬렉션 안에 하나 이상의 문서를 넣을 수 있습니다. 컬렉션을 핵심 가치 저장소로 생각하세요. 여기서 각 문서는 핵심 가치 쌍입니다.
• 문서: 문서는 식별자(documentId)와 이와 연결된 데이터 집합으로 구성됩니다.
• 문서와 관련된 데이터 : NerdStorage는 documentId 과 관련된 모든 종류의 데이터를 허용합니다. 제공되는 쿼리 및 변형 구성 요소는 JSON을 직렬화 및 역직렬화하여 작동합니다.

제한

• Nerdpack은 최대 1,000개의 컬렉션과 10,000개의 문서 및 저장 유형을 보관할 수 있습니다.
• 컬렉션에는 최대 1,500개의 문서와 저장 유형을 보관할 수 있습니다.
• 각 문서의 최대 길이는 직렬화 시 1024KiB입니다.

데이터 접근

NerdStorage에 액세스하려면 NerdGraph 쿼리를 실행하거나 제공된 스토리지 쿼리를 사용할 수 있습니다.

액세스하려는 저장소에 따라 다양한 SDK 구성 요소 세트를 사용할 수 있습니다.

• 사용자 액세스: UserStorageQuery 및 UserStorageMutation
• 계정 액세스: AccountStorageQuery 및 AccountStorageMutation
• 엔터티 액세스: EntityStorageQuery 및 EntityStorageMutation

이러한 각 구성 요소는 예를 들어 React 렌더링 방법의 일부로 또는 명령적으로 선언적으로 작동할 수 있습니다. query 및 mutation 에 대한 정적 메서드를 사용합니다.

NerdStorage 작업을 위한 권한

계정 및 엔터티 저장소 생성, 업데이트, 삭제 등 NerdStorage에서 변경 사항을 유지하려면 변경 사항 유지 권한이 있는 사용자 역할이 있어야 합니다.