

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 형식 시스템(응답 매핑)
<a name="aws-appsync-resolver-mapping-template-reference-dynamodb-typed-values-responses"></a>

DynamoDB로부터 응답을 수신하면 AWS AppSync는 자동으로 응답을 GraphQL 및 JSON 기본 유형으로 변환합니다. DynamoDB의 각 속성은 디코딩되어 응답 매핑 컨텍스트에서 반환됩니다.

예를 들어 DynamoDB에서 다음을 반환한 경우:

```
{
    "id" : { "S" : "1234" },
    "name" : { "S" : "Nadia" },
    "age" : { "N" : 25 }
}
```

그런 다음 AWS AppSync DynamoDB 해석기는 이를 GraphQL 및 JSON 유형으로 다음과 같이 변환합니다.

```
{
    "id" : "1234",
    "name" : "Nadia",
    "age" : 25
}
```

이 섹션에서는 AWS AppSync가 다음 DynamoDB 스칼라, 문서 및 세트 유형을 변환하는 방법을 설명합니다.

**String 형식 `S` **  
단일 문자열 값. DynamoDB String 값은 문자열로 반환됩니다.  
예를 들어 DynamoDB에서 다음 DynamoDB String 값을 반환한 경우:  

```
{ "S" : "some string" }
```
AWS AppSync는 이를 문자열로 변환합니다.  

```
"some string"
```

**String set 형식 `SS` **  
문자열 값 집합. DynamoDB String Set 값은 문자열 목록으로 반환됩니다.  
예를 들어 DynamoDB에서 다음 DynamoDB String Set 값을 반환한 경우:  

```
{ "SS" : [ "first value", "second value", ... ] }
```
AWS AppSync는 이를 문자열 목록으로 변환합니다.  

```
[ "+1 555 123 4567", "+1 555 234 5678" ]
```

**Number 형식 `N` **  
단일 숫자 값. DynamoDB Number 값은 숫자로 반환됩니다.  
예를 들어 DynamoDB에서 다음 DynamoDB Number 값을 반환한 경우:  

```
{ "N" : 1234 }
```
AWS AppSync는 이를 숫자로 변환합니다.  

```
1234
```

**Number set 형식 `NS` **  
숫자 값 집합. DynamoDB Number Set 값은 숫자 목록으로 반환됩니다.  
예를 들어 DynamoDB에서 다음 DynamoDB Number Set 값을 반환한 경우:  

```
{ "NS" : [ 67.8, 12.2, 70 ] }
```
AWS AppSync는 이를 숫자 목록으로 변환합니다.  

```
[ 67.8, 12.2, 70 ]
```

**Binary 형식 `B` **  
이진 값. DynamoDB Binary 값은 base64로 표시된 값이 포함된 문자열로 반환됩니다.  
예를 들어 DynamoDB에서 다음 DynamoDB Binary 값을 반환한 경우:  

```
{ "B" : "SGVsbG8sIFdvcmxkIQo=" }
```
AWS AppSync는 값을 base64로 표현한 문자열로 변환합니다.  

```
"SGVsbG8sIFdvcmxkIQo="
```
이진 데이터는 [RFC 4648](https://tools.ietf.org/html/rfc4648) 및 [RFC 2045](https://tools.ietf.org/html/rfc2045)에 지정된 base64 인코딩 체계로 인코딩됩니다.

**Binary set 형식 `BS` **  
이진 값 집합. DynamoDB Binary Set 값은 base64로 표시된 값이 포함된 문자열 목록으로 반환됩니다.  
예를 들어 DynamoDB에서 다음 DynamoDB Binary Set 값을 반환한 경우:  

```
{ "BS" : [ "SGVsbG8sIFdvcmxkIQo=", "SG93IGFyZSB5b3U/Cg==" ... ] }
```
AWS AppSync는 값을 base64로 표현한 문자열 목록으로 변환합니다.  

```
[ "SGVsbG8sIFdvcmxkIQo=", "SG93IGFyZSB5b3U/Cg==" ... ]
```
이진 데이터는 [RFC 4648](https://tools.ietf.org/html/rfc4648) 및 [RFC 2045](https://tools.ietf.org/html/rfc2045)에 지정된 base64 인코딩 체계로 인코딩됩니다.

**Boolean 형식 `BOOL` **  
부울 값. DynamoDB Boolean 값은 부울로 반환됩니다.  
예를 들어 DynamoDB에서 다음 DynamoDB Boolean 값을 반환한 경우:  

```
{ "BOOL" : true }
```
AWS AppSync는 이를 부울로 변환합니다.  

```
true
```

**List 형식 `L` **  
기타 지원되는 DynamoDB 값 목록입니다. DynamoDB List 값은 값 목록으로 반환되며, 여기서 각 내부 값 역시 변환됩니다.  
예를 들어 DynamoDB에서 다음 DynamoDB List 값을 반환한 경우:  

```
{ "L" : [
      { "S"  : "A string value" },
      { "N"  : 1 },
      { "SS" : [ "Another string value", "Even more string values!" ] }
   ]
}
```
AWS AppSync는 변환된 값 목록으로 변환합니다.  

```
[ "A string value", 1, [ "Another string value", "Even more string values!" ] ]
```

**Map 형식 `M` **  
지원되는 기타 모든 DynamoDB 값의 키/값 모음입니다. DynamoDB Map 값은 JSON 객체로 반환되며, 여기서 각 키/값 역시 변환됩니다.  
예를 들어 DynamoDB에서 다음 DynamoDB Map 값을 반환한 경우:  

```
{ "M" : {
      "someString" : { "S"  : "A string value" },
      "someNumber" : { "N"  : 1 },
      "stringSet"  : { "SS" : [ "Another string value", "Even more string values!" ] }
   }
}
```
AWS AppSync는 이를 JSON 객체로 변환합니다.  

```
{
   "someString" : "A string value",
   "someNumber" : 1,
   "stringSet"  : [ "Another string value", "Even more string values!" ]
}
```

**Null 형식 `NULL` **  
null 값.  
예를 들어 DynamoDB에서 다음 DynamoDB Null 값을 반환한 경우:  

```
{ "NULL" : null }
```
AWS AppSync는 이를 null로 변환합니다.  

```
null
```