클라우드 세이브
유저 데이터를 자유로운 JSON 형식으로 저렴하게 저장하고 관리해 보세요.
클라우드 세이브는 저비용 데이터 저장소로, 일반적인 DB와는 동작 방식이 다릅니다.
데이터 보호를 위한 백업과 요청 로그를 제공하지 않고 기존 데이터와 비교 없이 항상 덮어씁니다.
따라서 중요한 데이터를 저장할 때는 아래 방식으로 구성해 주세요. 데이터 유실 위험을 낮추면서 비용 효율은 그대로 유지할 수 있습니다.
메인 컬렉션과 백업 컬렉션을 분리하세요
평소 저장/로드에 사용하는 메인 컬렉션과 별개로, 백업 전용 컬렉션을 하나 더 생성합니다.
컬렉션은 최대 20개까지 생성할 수 있으므로, 백업 컬렉션 1개를 미리 확보해 두시는 것을 권장합니다.주요 시점에만 백업 컬렉션에 기록하세요
매 저장마다 백업할 필요는 없습니다. 스테이지 클리어, 결제 완료, 재화 대량 획득/소모 등
되돌아갈 기준이 되는 시점에만 백업 컬렉션에 함께 저장하세요.
백업 호출 횟수를 줄일 수 있어, 추가 비용을 최소화하면서 복구 지점을 확보할 수 있습니다.빈 데이터·초기 상태 데이터는 백업 컬렉션에 저장하지 마세요
클라이언트에서 업로드 직전에 데이터를 검사하여, 빈 데이터({})이거나 신규 유저 기본값(초기화 상태)인 경우에는
백업 컬렉션 업로드를 건너뛰도록 처리하세요.
이 처리가 없으면 정상 백업이 초기 데이터로 덮어쓰여 복구 지점을 잃게 됩니다.로드에 실패하면 원인을 구분한 뒤 처리하세요
메인 컬렉션 다운로드가 실패했을 때 곧바로 신규 유저로 판단하면,
직후 저장에서 기존 데이터가 초기값으로 덮어쓰일 수 있습니다. 아래와 같이 구분해 주세요.- 네트워크 오류·서버 오류로 실패한 경우: 신규 유저로 처리하지 마세요. 저장을 보류하고 재시도해 주세요.
- 정상 응답이지만 데이터가 없는 경우: 백업 컬렉션을 먼저 조회하고, 백업에도 데이터가 없을 때만 신규 유저로 처리해 주세요.
- 자동 백업과 데이터 버전 관리가 제공되지 않으므로, 복구가 필요한 데이터는 위 방식으로 백업 컬렉션을 구성해 주세요.
- 서버 요청에 대한 상세 로그가 저장되지 않습니다. 에러 상황 추적이 필요한 경우 클라이언트 측에서 로그를 관리해 주세요.
- 실시간 동기화, 데이터 이력 추적, 서버 측 검증이 필요한 정보는 데이터베이스 또는 게임 정보 이용을 권장합니다.
- 클라이언트 구현 방법과 예시 코드는 클라우드 세이브 SDK 문서를 참고해 주세요.
컬렉션 생성하기
컬렉션은 유저 데이터를 그룹화하여 관리할 수 있는 기능입니다.
- 컬렉션은 최대 20개까지 생성 가능합니다.
- 백업 용도의 컬렉션을 별도로 생성해 두면, 주요 시점의 데이터를 복구 지점으로 남겨둘 수 있습니다.
컬렉션 목록
컬렉션 목록에서 생성된 컬렉션 이름을 확인할 수 있습니다.
- 컬렉션을 삭제할 경우 컬렉션에 있는 모든 데이터가 삭제되며 다시 복구할 수 없습니다.
- 컬렉션 목록은 알파벳 순서로 정렬됩니다.
유저 데이터 생성하기
원하는 컬렉션에서 유저 UUID와 JSON 형식의 데이터를 입력하여 유저 데이터를 생성할 수 있습니다.
- ⚠️ 이미 생성된 유저 UUID로 재생성할 경우 기존 데이터가 새로 입력된 데이터로 덮어씌워집니다. 기존 데이터가 손실될 수 있으니 주의해 주세요. 백업 컬렉션을 함께 운영하면 주요 시점의 데이터를 복구 지점으로 확보할 수 있습니다.
- 유저데이터는 두 가지 모드로 생성 및 관리할 수 있습니다: 기본 편집 모드, 직접 작성 모드
- 일반적인 응답 시간은 평균 800ms이지만 처리량이 많은 경우, 2초 이상 응답 지연이 발생할 수 있습니다.
기본 편집 모드
- 트리형 구조에 따라 JSON 데이터를 입력 및 수정할 수 있습니다.
- 형식 문제, 오입력 등으로 인한 오류 가능성이 낮으므로 기본 편집 모드의 사용을 권장합니다.
직접 작성 모드
- 자유롭게 데이터를 입력 및 수정할 수 있습니다.
- 잘못된 데이터 형식은 유저 정보에 오류를 발생시킬 수 있으므로 입력 시 유의해 주세요.
유저 데이터 목록
- 목록에서 생성된 유저 데이터의 유저 UUID와 마지막 수정 시각을 확인할 수 있습니다.
- 삭제된 유저 데이터는 복구가 불가능합니다.
- 목록에서 수정 및 삭제 작업이 가능합니다.
- 유저 데이터 목록은 알파벳 순서로 정렬됩니다.
