스캔

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

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

{
    "version" : "2017-02-28",
    "operation" : "Scan",
    "index" : "fooIndex",
    "limit" : 10,
    "consistentRead" : false,
    "nextToken" : "aPaginationToken",
    "totalSegments" : 10,
    "segment" : 1,
    "filter" : {
        ...
    },
    "projection" : {
        ...
    }
}

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

Scan 필드

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

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

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

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

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

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

예시 1

다음 예제는 GraphQL 쿼리 allPosts의 매핑 템플릿입니다.

이 예에서는 테이블의 항목을 모두 반환합니다.

{
    "version" : "2017-02-28",
    "operation" : "Scan"
}

예시 2

다음 예제는 GraphQL 쿼리 postsMatching(title: String!)의 매핑 템플릿입니다.

이 예에서는 제목이 title 인수로 시작하는 경우 테이블의 모든 항목이 반환됩니다.

{
    "version" : "2017-02-28",
    "operation" : "Scan",
    "filter" : {
        "expression" : "begins_with(title, :title)",
        "expressionValues" : {
            ":title" : $util.dynamodb.toDynamoDBJson($context.arguments.title)
        },
    }
}

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