소개

지금도 DynamoDB의 쿼리 파라미터에 대해 정리한다.
이미 다른 사람들이 비슷한 기사를 쓰고 있을지 모르지만,
AWS 문서를 읽고,
「알기 힘들기 때문에 일람으로 정리해 줘!」라고 생각
어디까지나 자신을 위한 메모로 남긴다.
다른 DB 조작 파라미터에 대해서는 필요가 나오면 추기할 생각.

Query Parameters

TableName

문자 그대로 테이블명을 지정한다

KeyConditionExpression

1 차 키 (파티션 키, 정렬 키), 2 차 인덱스에 대한 조건식을 설명합니다.

DynamoDB 예약어가 아니면, 후술하는 ExpressionAttributeNames로 자리 표시자를 지정하지 않고 그대로 사용할 수 있습니다.

예

:main, :sub는 ExpressionAttributeValues에서 선언한다.

속성 값의 자리 표시자에는 콜론이 필요합니다

ExpressionAttributeNames

KeyConditionExpression 로 사용하는 속성명의 플레이스홀더를 정의한다

오브젝트 캐릭터 라인으로 지정한다

#을 접두사로 붙이는 것이 필수

예

이 경우 Views가 DynamoDB의 예약어이므로 별칭을 지정해야한다는 사정도 있습니다.

ExpressionAttributeValues

KeyConditionExpression 로 사용하는 속성치의 플레이스홀더를 정의한다

객체로 지정

접두사로서 콜론:을 붙이는 것이 필수

예

조건식 자체가 문자열이므로 그대로 쓰면 문자열인지 숫자인지 판별 할 수 없으므로 형식 정의 (S : 문자열, N : 숫자)가 필요하다고 생각됩니다.

FilterExpression

테이블에서 쿼리를 실행 한 후 API로 반환 값을 필터링하는 조건식을 작성합니다.

ExpressionAttributeNames, ExpressionAttributeValues로 정의 된 자리 표시자를 사용하여 KeyConditionExpression과 마찬가지로 작성할 수 있습니다.

ProjectionExpression

쿼리 결과에 출력되는 속성을 지정하고 싶은 경우에 사용합니다.

예

기타

DynamoDB DocumentClient

ExpressionAttributeValues로 지정하고있는 형태 선언이 불필요하게됩니다.

상기의 예라면, 다음과 같이 된다