GetItem

포커스 모드

GetItem - AWS AppSync GraphQL

GetItem 요청 매핑 문서를 사용하면 AWS AppSync DynamoDB 해석기에 DynamoDB에 GetItem 요청하도록 지시하고 다음을 지정할 수 있습니다.

DynamoDB의 항목 키
일관된 읽기를 사용할지 여부

GetItem 매핑 문서의 구조는 다음과 같습니다.


{
    "version" : "2017-02-28",
    "operation" : "GetItem",
    "key" : {
        "foo" : ... typed value,
        "bar" : ... typed value
    },
    "consistentRead" : true,
    "projection" : {
        ...
    }
}

필드는 다음과 같이 정의됩니다.

GetItem 필드

version: 템플릿 정의 버전. 2017-02-28 및 2018-05-29만 현재 지원됩니다. 이 값은 필수입니다.
operation: 수행할 DynamoDB 작업입니다. GetItem DynamoDB 작업을 수행하려면 이 값을 GetItem으로 설정해야 합니다. 이 값은 필수입니다.
key: DynamoDB의 항목 키입니다. DynamoDB 항목은 테이블 구조에 따라 단일 해시 키 또는 해시 키와 정렬 키를 가질 수 있습니다. '입력된 값'을 지정하는 방법에 대한 자세한 내용은 유형 시스템(요청 매핑)을 참조하세요. 이 값은 필수입니다.
consistentRead: DynamoDB에서 강력히 일관된 읽기를 수행할지 여부. 선택 사항으로, 기본값은 false입니다.
projection: DynamoDB 작업에서 반환할 속성을 지정하는 데 사용되는 프로젝션입니다. 프로젝션에 대한 자세한 내용은 프로젝션을 참조하세요. 이 필드는 선택 사항입니다.

GetItem 필드 목록

version: 템플릿 정의 버전. 2017-02-28 및 2018-05-29만 현재 지원됩니다. 이 값은 필수입니다.
operation: 수행할 DynamoDB 작업입니다. GetItem DynamoDB 작업을 수행하려면 이 값을 GetItem으로 설정해야 합니다. 이 값은 필수입니다.
key: DynamoDB의 항목 키입니다. DynamoDB 항목은 테이블 구조에 따라 단일 해시 키 또는 해시 키와 정렬 키를 가질 수 있습니다. '입력된 값'을 지정하는 방법에 대한 자세한 내용은 유형 시스템(요청 매핑)을 참조하세요. 이 값은 필수입니다.
consistentRead: DynamoDB에서 강력히 일관된 읽기를 수행할지 여부. 선택 사항으로, 기본값은 false입니다.
projection: DynamoDB 작업에서 반환할 속성을 지정하는 데 사용되는 프로젝션입니다. 프로젝션에 대한 자세한 내용은 프로젝션을 참조하세요. 이 필드는 선택 사항입니다.

DynamoDB에서 반환된 항목은 자동으로 GraphQL 및 JSON 기본 유형으로 변환되며 매핑 컨텍스트($context.result)에서 사용할 수 있습니다.

DynamoDB 형식 변환에 대한 자세한 내용은 형식 시스템(응답 매핑)을 참조하세요.

응답 매핑 템플릿에 대한 자세한 내용은 해석기 매핑 템플릿 개요를 참조하세요.

예제

다음 예제는 GraphQL 쿼리 getThing(foo: String!, bar: String!)의 매핑 템플릿입니다.


{
    "version" : "2017-02-28",
    "operation" : "GetItem",
    "key" : {
        "foo" : $util.dynamodb.toDynamoDBJson($ctx.args.foo),
        "bar" : $util.dynamodb.toDynamoDBJson($ctx.args.bar)
    },
    "consistentRead" : true
}