util.dynamodb의 DynamoDB 도우미 - AWS AppSync
toDynamoDBtoString 유틸리티toNumber 유틸리티toBinary 유틸리티toBoolean 유틸리티toNull 유틸리티toList 유틸리티toMap 유틸리티S3Object 유틸리티

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

util.dynamodb의 DynamoDB 도우미

util.dynamodb에는 Amazon DynamoDB에 데이터 쓰기 및 읽기를 더 용이하게 하는 헬퍼 메서드가 포함되어 있습니다(예: 자동 유형 매핑 및 형식 지정).

toDynamoDB

util.dynamodb.toDynamoDB(Object)

입력 객체를 적절한 DynamoDB 표현으로 변환하는 DynamoDB용 일반 객체 변환 도구입니다. 이 도구는 몇 가지 형식을 표현하는 방법에 대해 독자적인 방식을 가지고 있습니다. 예를 들어 집합("SS", "NS", "BS")보다는 목록("L")을 사용합니다. DynamoDB 속성 값을 설명하는 객체를 반환합니다.

문자열 예제

Input:      util.dynamodb.toDynamoDB("foo")
Output:     { "S" : "foo" }

숫자 예제

Input:      util.dynamodb.toDynamoDB(12345)
Output:     { "N" : 12345 }

부울 예제

Input:      util.dynamodb.toDynamoDB(true)
Output:     { "BOOL" : true }

록 예제

Input:      util.dynamodb.toDynamoDB([ "foo", 123, { "bar" : "baz" } ])
Output:     {
               "L" : [
                   { "S" : "foo" },
                   { "N" : 123 },
                   {
                       "M" : {
                           "bar" : { "S" : "baz" }
                       }
                   }
               ]
           }

맵 예제

Input:      util.dynamodb.toDynamoDB({ "foo": "bar", "baz" : 1234, "beep": [ "boop"] })
Output:     {
               "M" : {
                   "foo"  : { "S" : "bar" },
                   "baz"  : { "N" : 1234 },
                   "beep" : {
                       "L" : [
                           { "S" : "boop" }
                       ]
                   }
               }
           }

toString 유틸리티

util.dynamodb.toString(String)

입력 문자열을 DynamoDB 문자열 형식으로 변환합니다. DynamoDB 속성 값을 설명하는 객체를 반환합니다.

Input:      util.dynamodb.toString("foo")
Output:     { "S" : "foo" }
util.dynamodb.toStringSet(List<String>)

문자열이 포함된 목록을 DynamoDB 문자열 집합 형식으로 변환합니다. DynamoDB 속성 값을 설명하는 객체를 반환합니다.

Input:      util.dynamodb.toStringSet([ "foo", "bar", "baz" ])
Output:     { "SS" : [ "foo", "bar", "baz" ] }

toNumber 유틸리티

util.dynamodb.toNumber(Number)

숫자를 DynamoDB 숫자 형식으로 변환합니다. DynamoDB 속성 값을 설명하는 객체를 반환합니다.

Input:      util.dynamodb.toNumber(12345)
Output:     { "N" : 12345 }
util.dynamodb.toNumberSet(List<Number>)

숫자 목록을 DynamoDB 숫자 집합 형식으로 변환합니다. DynamoDB 속성 값을 설명하는 객체를 반환합니다.

Input:      util.dynamodb.toNumberSet([ 1, 23, 4.56 ])
Output:     { "NS" : [ 1, 23, 4.56 ] }

toBinary 유틸리티

util.dynamodb.toBinary(String)

base64 문자열로 인코딩된 이진 데이터를 DynamoDB 이진 형식으로 변환합니다. DynamoDB 속성 값을 설명하는 객체를 반환합니다.

Input:      util.dynamodb.toBinary("foo")
Output:     { "B" : "foo" }
util.dynamodb.toBinarySet(List<String>)

base64 문자열로 인코딩된 이진 데이터 목록을 DynamoDB 이진수 집합 형식으로 변환합니다. DynamoDB 속성 값을 설명하는 객체를 반환합니다.

Input:      util.dynamodb.toBinarySet([ "foo", "bar", "baz" ])
Output:     { "BS" : [ "foo", "bar", "baz" ] }

toBoolean 유틸리티

util.dynamodb.toBoolean(Boolean)

부울을 적절한 DynamoDB 부울 형식으로 변환합니다. DynamoDB 속성 값을 설명하는 객체를 반환합니다.

Input:      util.dynamodb.toBoolean(true)
Output:     { "BOOL" : true }

toNull 유틸리티

util.dynamodb.toNull()

null을 DynamoDB null 형식으로 반환합니다. DynamoDB 속성 값을 설명하는 객체를 반환합니다.

Input:      util.dynamodb.toNull()
Output:     { "NULL" : null }

toList 유틸리티

util.dynamodb.toList(List)

객체 목록을 DynamoDB 목록 형식으로 변환합니다. 목록의 각 항목 역시 적절한 DynamoDB 형식으로 변환됩니다. 이 도구는 몇 가지 중첩 객체를 표현하는 방법에 대해 독자적인 방식을 가지고 있습니다. 예를 들어 집합("SS", "NS", "BS")보다는 목록("L")을 사용합니다. DynamoDB 속성 값을 설명하는 객체를 반환합니다.

Input:      util.dynamodb.toList([ "foo", 123, { "bar" : "baz" } ])
Output:     {
               "L" : [
                   { "S" : "foo" },
                   { "N" : 123 },
                   {
                       "M" : {
                           "bar" : { "S" : "baz" }
                       }
                   }
               ]
           }

toMap 유틸리티

util.dynamodb.toMap(Map)

맵을 DynamoDB 맵 형식으로 변환합니다. 맵의 각 값 역시 적절한 DynamoDB 형식으로 변환됩니다. 이 도구는 몇 가지 중첩 객체를 표현하는 방법에 대해 독자적인 방식을 가지고 있습니다. 예를 들어 집합("SS", "NS", "BS")보다는 목록("L")을 사용합니다. DynamoDB 속성 값을 설명하는 객체를 반환합니다.

Input:      util.dynamodb.toMap({ "foo": "bar", "baz" : 1234, "beep": [ "boop"] })
Output:     {
               "M" : {
                   "foo"  : { "S" : "bar" },
                   "baz"  : { "N" : 1234 },
                   "beep" : {
                       "L" : [
                           { "S" : "boop" }
                       ]
                   }
               }
           }
util.dynamodb.toMapValues(Map)

각 값이 적절한 DynamoDB 형식으로 변환된 탭의 사본을 생성합니다. 이 도구는 몇 가지 중첩 객체를 표현하는 방법에 대해 독자적인 방식을 가지고 있습니다. 예를 들어 집합("SS", "NS", "BS")보다는 목록("L")을 사용합니다.

Input:      util.dynamodb.toMapValues({ "foo": "bar", "baz" : 1234, "beep": [ "boop"] })
Output:     {
               "foo"  : { "S" : "bar" },
               "baz"  : { "N" : 1234 },
               "beep" : {
                   "L" : [
                       { "S" : "boop" }
                   ]
               }
           }
참고

이는 전체 속성 값 자체가 아니라 DynamoDB 속성 값의 내용만 반환하기 때문에 util.dynamodb.toMap(Map)과 약간 다릅니다. 예를 들어 다음 문은 정확하게 동일합니다.

util.dynamodb.toMapValues(<map>)
util.dynamodb.toMap(<map>)("M")

S3Object 유틸리티

util.dynamodb.toS3Object(String key, String bucket, String region)

키, 버킷 및 리전을 DynamoDB S3 객체 표현으로 변환합니다. DynamoDB 속성 값을 설명하는 객체를 반환합니다.

Input:      util.dynamodb.toS3Object("foo", "bar", region = "baz")
Output:     { "S" : "{ \"s3\" : { \"key\" : \"foo", \"bucket\" : \"bar", \"region\" : \"baz" } }" }
util.dynamodb.toS3Object(String key, String bucket, String region, String version)

키, 버킷, 리전 및 선택적 버전을 DynamoDB S3 객체 표현으로 변환합니다. DynamoDB 속성 값을 설명하는 객체를 반환합니다.

Input:      util.dynamodb.toS3Object("foo", "bar", "baz", "beep")
Output:     { "S" : "{ \"s3\" : { \"key\" : \"foo\", \"bucket\" : \"bar\", \"region\" : \"baz\", \"version\" = \"beep\" } }" }
util.dynamodb.fromS3ObjectJson(String)

DynamoDB S3 객체의 문자열 값을 수락하고 키, 버킷, 리전 및 선택적 버전을 포함하는 맵을 반환합니다.

Input:      util.dynamodb.fromS3ObjectJson({ "S" : "{ \"s3\" : { \"key\" : \"foo\", \"bucket\" : \"bar\", \"region\" : \"baz\", \"version\" = \"beep\" } }" })
Output:     { "key" : "foo", "bucket" : "bar", "region" : "baz", "version" : "beep" }