형식 시스템(응답 매핑)

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는 반환된 값을 문자열 목록으로 변환합니다.

[ "[phone]", "[phone]" ]

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 및 RFC 2045에 지정된 base64 인코딩 체계로 인코딩됩니다.

Binary set 형식 BS

이진 값 집합. DynamoDB Binary Set 값은 base64로 표시된 값이 포함된 문자열 목록으로 반환됩니다.

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

{ "BS" : [ "SGVsbG8sIFdvcmxkIQo=", "SG93IGFyZSB5b3U/Cg==" ... ] }

AWS AppSync는 반환된 값을 base64로 표시된 값이 포함된 문자열 목록으로 변환합니다.

[ "SGVsbG8sIFdvcmxkIQo=", "SG93IGFyZSB5b3U/Cg==" ... ]

이진 데이터는 RFC 4648 및 RFC 2045에 지정된 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