Cloud Save 쿼리
Understand indexes and query types for both numerical and text data stored in player and game data.
읽는 시간 1분최근 업데이트: 4달 전
Cloud Save를 사용하여 플레이어 데이터와 게임 데이터에 저장된 숫자 데이터와 텍스트 데이터를 모두 쿼리할 수 있습니다. 쿼리는 길드나 클랜 시스템 생성, 매치메이킹 추가, 경제 시스템 또는 경매장 구현, 멀티플레이어 개발 환경에서 NPC나 아이템의 데이터 반환 등 다양한 목적으로 활용할 수 있습니다.
인덱스 생성
Cloud Save에서 데이터를 쿼리하려면 먼저 데이터를 인덱싱해야 합니다. Unity Dashboard, Unity CLI, 또는 관리자 REST API를 사용하여 인덱스를 생성하고 관리할 수 있습니다. 각 Cloud Save 키의 인덱스를 구성하거나 여러 키를 특정 순서로 결합하여 복합 인덱스를 구성할 수 있습니다. Cloud Save는 각 키에 대해 인덱스가 오름차순이나 내림차순으로 정렬되는지를 지정하는 부울 값을 표시합니다. 인덱스를 사용하는 데 추가 비용은 발생하지 않습니다.쿼리 유형
Cloud Save에서 지원되는 쿼리 유형은 다음과 같습니다.- - 다음과 동일함
EQ - - 다음과 동일하지 않음
NE - - 다음보다 적음
LT - - 다음보다 적거나 다음과 동일함
LE - - 다음보다 큼
GT - - 다음보다 크거나 다음과 동일함
GE
무작위 샘플링
Cloud Save는 전체 정렬된 결과 세트를 페이지별로 반환하는 기본 동작 대신, 쿼리에 대해 무작위 샘플 결과를 반환할 수 있는 기능을 제공합니다. 이 기능을 사용하려면 쿼리를 수행할 때sampleSize제한 사항
쿼리 제한 사항
클라이언트나 서버에서 쿼리할 수 있는 데이터는 인덱싱된 키의 액세스 클래스에 의해 정의됩니다.- Unity용 Cloud Save SDK를 사용하면, 게임 클라이언트는 공개 액세스 클래스에서 플레이어 데이터를 쿼리하거나 기본 액세스 클래스에 저장된 게임 데이터를 쿼리할 수 있습니다.
- Cloud Code용 Cloud Save SDK, CLI 또는 관리자 REST API를 사용하면 어떤 액세스 클래스(예: 기본, 공개, 비공개, 보호)에서든 인덱싱된 키를 쿼리할 수 있습니다.
인덱스 제한 사항
- 인덱싱할 수 있는 값의 최대 크기는 128바이트입니다. 128바이트보다 큰 값은 인덱싱되지 않으며, 128바이트보다 큰 값을 인덱싱된 키에 쓰려고 시도하면 인덱스가 실패합니다(데이터는 여전히 Cloud Save에 저장되지만 인덱싱되지 않음).
- 모든 인덱스와 모든 액세스 클래스, 플레이어 상태, 게임 상태에서 인덱싱할 수 있는 키를 최대 20개까지 정의할 수 있습니다. 즉, 단일 인덱스 키로 최대 20개의 인덱스나 20개의 키가 포함된 단일 인덱스가 있을 수 있고, 전체 인덱스 키 개수가 제한을 초과하지 않으면 그 사이에 어떠한 조합이라도 있을 수 있음을 의미합니다.
중요
중요: 인덱스를 생성한 후에 저장한 데이터만 쿼리할 수 있습니다. 인덱스를 생성하기 전에 저장한 데이터는 쿼리 응답에 포함되지 않습니다.