테이블 내보내기 필터링

전체 테이블을 내보내는 대신 필요한 항목과 속성만 내보낼 수 있습니다. DynamoDB는 사용자가 제공한 표현식과 일치하는 데이터만 내보냅니다. 필터링된 내보내기는 전체 내보내기와 증분 내보내기 모두에서 작동합니다.

증분 내보내기의 경우 DynamoDB는 변경된 각 항목의 최신 이미지를 기준으로 필터를 평가합니다. 삭제된 항목의 경우 새 이미지가 존재하지 않으므로 DynamoDB는 항목의 이전 이미지와 비교하여 필터를 평가합니다.

세 가지 유형의 표현식으로 필터링된 내보내기가 반환하는 항목을 제어합니다. 다음 중 하나를 제공하거나 단일 내보내기 요청으로 결합할 수 있습니다.

• 키 조건 표현식은 DynamoDB Query 키 조건 표현식과 동일한 구문 및 규칙을 사용하여 프라이머리 키로 항목을 선택합니다. 키 조건 표현식은 등식 비교를 통해 단일 파티션 키 값과 정렬 키에 대한 선택적 조건을 지정합니다. 키가 아닌 속성은 참조할 수 없으며 파티션 키 값을 두 개 이상 지정할 수 없습니다. 키 조건 표현식은 내보내기를 단일 파티션 키 값으로 제한하므로 DynamoDB가 내보내기를 위해 읽는 데이터의 양을 줄입니다. 자세한 내용은 DynamoDB에서의 쿼리 작업에 대한 키 조건 표현식 섹션을 참조하세요

• 필터 표현식은 Scan 작업의 필터 표현식과 동일한 구문 및 규칙을 사용하여 키 속성과 키가 아닌 속성 모두에 조건을 적용할 수 있습니다. 필터 표현식은 contains, IN, begins_with, BETWEEN, attribute_exists 및 size 함수와 함께 같음, 같지 않음 및 OR 같은 비교를 지원합니다. DynamoDB는 데이터를 읽은 후 필터 표현식을 적용하므로 필터는 DynamoDB가 내보내기를 위해 처리하는 데이터의 양을 줄이지 않습니다. 필터 표현식 및 해당 구문에 대한 자세한 내용은 필터 및 조건 표현식 구문 섹션을 참조하세요.

• 프로젝션 표현식은 다른 DynamoDB 작업의 프로젝션 표현식과 동일한 구문 및 규칙을 사용하여 내보내기 출력에서 원하는 특정 속성을 식별합니다. 자세한 내용은 DynamoDB에서 프로젝션 표현식 사용 섹션을 참조하세요

참고

키 속성이 필터 표현식에 나타날 수 있는지 여부는 키 조건 표현식도 제공하는지 여부에 따라 달라집니다. 키 조건 표현식을 제공하는 경우 키 속성이 필터 표현식에도 나타날 수 없습니다. 필터 표현식만 제공하는 경우 키 속성이 필터 표현식에 나타날 수 있습니다.

각 표현식에는 다음 제한이 적용됩니다.

• 표현식의 크기는 최대 4KB일 수 있습니다.

• 속성 이름은 최대 250바이트일 수 있습니다.

• 속성 값은 최대 2MB일 수 있습니다.

• 표현식에는 최대 300개의 연산자가 포함될 수 있습니다.