Huny's Dev Blog
huny.dev

DynamoDB 벡터 검색: 상위 결과를 뽑기 전에 날짜와 언어로 거르기

DynamoDB SearchVectors 인라인 필터로 날짜 범위와 언어를 제한하는 방법, 파티션 키 조건과 누락 속성의 함정을 정리한다.

Hun Jang
Hun Jang Nov 23, 2026

검색 조건에 맞는 벡터 후보만 남기는 과정을 표현한 AI 생성 개념 이미지. 실제 AWS 화면이 아니다.

DynamoDB 벡터 검색에서 문서 언어와 발행일을 제한하려면, 전체 유사도 상위 5개를 가져온 뒤 애플리케이션에서 거르는 대신 SearchVectors에 검색 조건을 함께 보낸다. AWS는 2026년 11월 20일 DynamoDB 벡터 검색이 숫자 범위, 값 목록, 논리 연산자 등을 인라인 필터로 지원한다고 발표했다. 이미 DynamoDB에 문서와 임베딩을 저장하는 검색 시스템이라면, 결과를 고르는 위치부터 바꿔볼 만하다. AWS 발표

상위 5개를 뽑기 전에 조건을 적용한다

전체 검색에서 유사도 상위 5개를 먼저 가져왔는데, 그중 날짜와 언어 조건을 만족하는 문서가 한 건뿐일 수 있다. 조건을 만족하는 문서가 6위 아래에 더 있어도 앱의 후처리로는 찾을 수 없다.

인라인 필터는 DynamoDB가 벡터를 검색하는 동안 조건을 적용한다. 예컨대 운영 문서 중 한국어 또는 영어이고 특정 기간에 발행된 문서만 남긴 뒤, 해당 조건으로 유사한 결과를 최대 5개 요청한다. 조건을 만족하는 문서가 충분치 않으면 다섯 개가 보장되지 않는다. 기존 후처리를 바꿀 때는 정확도·지연·비용을 별도로 비교한다. DynamoDB 벡터 인덱스 가이드

문서 카테고리·언어·일자를 한 번에 지정하기

예시는 벡터 인덱스의 파티션 키가 문자열 Category이고, 문자열 Language와 숫자 PublishedDay가 인라인 필터 속성으로 이미 정의됐다고 가정한다. PublishedDay에는 20261120과 같이 YYYYMMDD를 숫자로 저장한다. 다음 JSON은 SearchVectors 요청 본문의 일부다. 실제 요청에는 TableName, IndexName, 인덱스 차원과 일치하는 SearchVector도 필요하다.

BETWEEN은 양쪽 경계를 포함하고 숫자 속성에만 쓸 수 있다. IN에는 비교할 값의 자리표시자를 넣는다. 인덱스가 파티션 키를 선언했다면 키 조건은 최상위의 단일 등식이어야 한다. 예시의 #category = :c를 IN으로 바꾸거나 OR 안에 넣지 않는다. 여러 파티션을 검색하려면 키별로 요청한다. 필터에 쓸 속성은 벡터 인덱스를 만들 때 선언한다. 조건식 전용 가이드 · 요청 본문 형식

날짜 경계와 속성 누락을 따로 확인한다

테스트 인덱스에 같은 파티션의 문서 다섯 개를 넣어본다. 시작일의 한국어 문서와 종료일의 영어 문서는 조건을 만족해야 한다. 프랑스어 문서, 기간 직전의 문서, 발행일이 없는 문서는 제외돼야 한다. 반환 건수만 보지 말고 문서 ID로 대조한다. 필요한 속성이 반환되도록 인덱스의 프로젝션도 확인한다.

특히 제외 조건은 누락 처리와 함께 설계한다. 예를 들어 NOT (#lang = :fr)만 쓰면 언어 속성이 없는 문서도 통과할 수 있다. 누락된 언어까지 제외하려면 attribute_exists(#lang) AND NOT (#lang = :fr)로 표현한다.

일반 API 레퍼런스에 인라인 필터가 등식만 지원한다는 설명이 남아 있지만, 11월 20일 발표와 조건식 전용 가이드는 새 연산자와 제한을 명시한다. 예제 JSON 문법과 자리표시자는 로컬에서 확인했고, 실제 AWS 호출이나 성능 측정은 하지 않았다.

추천 글