Query

Query 요청 객체를 사용하면 AWS AppSync DynamoDB 해석기에 DynamoDB 에 Query 요청하도록 지시하고 다음을 지정할 수 있습니다.

Query 요청 객체는 다음과 같은 구조입니다.

type DynamoDBQueryRequest = {
  operation: 'Query';
  query: {
    expression: string;
    expressionNames?: { [key: string]: string };
    expressionValues?: { [key: string]: any };
  };
  index?: string;
  nextToken?: string;
  limit?: number;
  scanIndexForward?: boolean;
  consistentRead?: boolean;
  select?: 'ALL_ATTRIBUTES' | 'ALL_PROJECTED_ATTRIBUTES' | 'SPECIFIC_ATTRIBUTES';
  filter?: {
    expression: string;
    expressionNames?: { [key: string]: string };
    expressionValues?: { [key: string]: any };
  };
  projection?: {
    expression: string;
    expressionNames?: { [key: string]: string };
  };
};

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

쿼리 필드

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

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

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

결과의 구조는 다음과 같습니다.

{
    items = [ ... ],
    nextToken = "a pagination token",
    scannedCount = 10
}

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

예

다음 예제는 GraphQL 쿼리 getPosts(owner: ID!)를 위한 함수 요청 핸들러입니다.

이 예에서는 테이블의 글로벌 보조 인덱스를 쿼리해 지정한 ID가 소유한 게시물을 모두 반환합니다.

import { util } from '@aws-appsync/utils';

export function request(ctx) {
  const { owner } = ctx.args;
  return {
    operation: 'Query',
    query: {
      expression: 'ownerId = :ownerId',
      expressionValues: util.dynamodb.toMapValues({ ':ownerId': owner }),
    },
    index: 'owner-index',
  };
}

DynamoDB 에 대한 자세한 내용은 DynamoDB API 설명서 섹션을 Query API참조하세요.