---
title: ZEPETO.Multiplay.DataStorage
slug: world-sdk-guide-kr/zepetomultiplaydatastorage
docTags: 
createdAt: 2026-09-04T04:50:34.198Z
---

| 형식                                      | 설명                                                                                      |
| --------------------------------------- | --------------------------------------------------------------------------------------- |
| [DataStorageError](./#datastorageerror) | 데이터 스토리지 관련 요청이 실패한 원인을 나타내는 오류 코드입니다.                                                  |
| [DataStorage](./#datastorage)           | 데이터를 저장, 조회, 삭제하는 메서드를 제공하는 데이터 스토리지 추상화입니다. 이 인터페이스는 단일 및 다중 데이터 조작을 위한 비동기 작업을 정의합니다. |

## DataStorageError

`enum`

데이터 스토리지 관련 요청이 실패한 원인을 나타내는 오류 코드입니다.

| 이름                      | 값   | 설명                                        |
| ----------------------- | --- | ----------------------------------------- |
| Unknown                 | -1  | 오류: 알 수 없는 오류입니다.                         |
| NetworkError            | 0   | 오류: 연결 끊김이나 불안정한 연결 등 네트워크 문제와 관련된 오류입니다. |
| KeyConstraintViolated   | 103 | 오류: 키 오류입니다.                              |
| ValueConstraintViolated | 104 | 오류: 값 오류입니다.                              |

## DataStorage

`interface`

데이터를 저장, 조회, 삭제하는 메서드를 제공하는 데이터 스토리지 추상화입니다.
이 인터페이스는 단일 및 다중 데이터 조작을 위한 비동기 작업을 정의합니다.

### 메서드

### set

`set(key: string, value: T) → Promise<boolean>`

지정한 키로 값을 저장합니다. `DataStorageError`를 발생시킵니다.

| 매개변수  | 형식       | 설명            |
| ----- | -------- | ------------- |
| key   | `string` | 저장에 사용할 키입니다. |
| value | `T`      | 저장할 데이터입니다.   |

**반환값:** `Promise<boolean>` — 작업 완료 시 이행되는 `Promise`이며, 성공(`true`) 또는 실패(`false`)를 나타냅니다.

### get

`get(key: string) → Promise<T>`

키로 값을 조회합니다. `DataStorageError`를 발생시킵니다.

| 매개변수 | 형식       | 설명        |
| ---- | -------- | --------- |
| key  | `string` | 검색할 키입니다. |

**반환값:** `Promise<T>` — 작업 완료 시 `T` 형식의 값과 함께 이행되는 `Promise`입니다.

### remove

`remove(key: string) → Promise<boolean>`

지정한 키의 값을 삭제합니다. `DataStorageError`를 발생시킵니다.

| 매개변수 | 형식       | 설명        |
| ---- | -------- | --------- |
| key  | `string` | 검색할 키입니다. |

**반환값:** `Promise<boolean>` — 작업 완료 시 이행되는 `Promise`이며, 성공(`true`) 또는 실패(`false`)를 나타냅니다.

### mget

`mget(keys: string[]) → Promise<{ [key: string]: T }>`

여러 키로 값을 조회합니다. `DataStorageError`를 발생시킵니다.

| 매개변수 | 형식         | 설명            |
| ---- | ---------- | ------------- |
| keys | `string[]` | 검색할 키의 배열입니다. |

**반환값:** `Promise<{ [key: string]: T }>` — 작업 완료 시 키-값 객체와 함께 이행되는 `Promise`입니다.

### mset

`mset(keyValueSet: { key: string; value: T }[]) → Promise<boolean>`

지정한 여러 키로 값을 저장합니다. `DataStorageError`를 발생시킵니다.

| 매개변수        | 형식                            | 설명                 |
| ----------- | ----------------------------- | ------------------ |
| keyValueSet | `{ key: string; value: T }[]` | 저장할 키-값 객체의 배열입니다. |

**반환값:** `Promise<boolean>` — 작업 완료 시 이행되는 `Promise`이며, 성공(`true`) 또는 실패(`false`)를 나타냅니다.