GetItem - AWS AppSync GraphQL
GetItem 필드예제

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

GetItem

이 GetItem 요청을 통해 AWS AppSync DynamoDB 함수에 DynamoDB에 GetItem 요청하도록 지시하고 다음을 지정할 수 있습니다.

  • DynamoDB의 항목 키

  • 일관된 읽기를 사용할지 여부

GetItem 요청의 구조는 다음과 같습니다.

type DynamoDBGetItem = {
  operation: 'GetItem';
  key: { [key: string]: any };
  consistentRead?: ConsistentRead;
  projection?: {
    expression: string;
    expressionNames?: { [key: string]: string };
  };
};

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

GetItem 필드

operation

수행할 DynamoDB 작업입니다. GetItem DynamoDB 작업을 수행하려면 이 값을 GetItem으로 설정해야 합니다. 이 값은 필수입니다.

key

DynamoDB의 항목 키입니다. DynamoDB 항목은 테이블 구조에 따라 단일 해시 키 또는 해시 키와 정렬 키를 가질 수 있습니다. '입력된 값'을 지정하는 방법에 대한 자세한 내용은 유형 시스템(요청 매핑)을 참조하세요. 이 값은 필수입니다.

consistentRead

DynamoDB에서 강력히 일관된 읽기를 수행할지 여부. 선택 사항으로, 기본값은 false입니다.

projection

DynamoDB 작업에서 반환할 속성을 지정하는 데 사용되는 프로젝션입니다. 프로젝션에 대한 자세한 내용은 프로젝션을 참조하세요. 이 필드는 선택 사항입니다.

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

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

JavaScript 해석기에 대한 자세한 내용은 JavaScript 해석기 개요를 참조하세요.

예제

다음 예제는 GraphQL 쿼리 getThing(foo: String!, bar: String!)을 위한 함수 요청 핸들러입니다.

export function request(ctx) {
  const {foo, bar} = ctx.args
  return {
    operation : "GetItem",
    key : util.dynamodb.toMapValues({foo, bar}),
    consistentRead : true
  }
}

DynamoDB GetItem API에 대한 자세한 내용은 DynamoDB API 문서를 참조하십시오.