Elasticsearch - QueryDSL¶
본 포스팅의 모든 실습과 예제는 Elasticsearch 7.6 버전을 기준으로 작성되었다.
지난 2편에서 기본적인 CRUD와 벌크(Bulk) 색인을 다루었으니, 이번에는 Elasticsearch 검색의 핵심이자 실무에서 가장 빈번하게 사용되는 Query DSL(Domain Specific Language)의 문법과 실전 활용법을 알아본다.
1. Query vs Filter의 핵심 차이점¶
Elasticsearch에서 Query DSL을 이용해 데이터를 찾는 방법은 크게 Query 컨텍스트와 Filter 컨텍스트 두 가지로 나뉜다. 둘 다 JSON 형식으로 작성되지만 다음과 같은 결정적인 차이가 있다.
| 구분 | Query (쿼리) | Filter (필터) |
|---|---|---|
| 주요 목적 | 전문 검색 (Full-text Search) | Yes/No 조건 필터링 (Exact Match) |
| 스코어 계산 | 문서와 질의 간의 유사도 점수(_score)를 계산함 |
점수를 계산하지 않음 (_score: 0.0) |
| 캐싱 여부 | 결과를 캐싱하지 않음 | 결과를 메모리에 자동 캐싱하여 재사용함 |
| 성능 | 상대적으로 연산 비용이 큼 | 매우 빠름 (고성능) |
💡 실무 권장 패턴:
복잡하고 정교한 텍스트 유사도 매칭에는query를 사용하고, 날짜 범위·상태값·카테고리 ID 등 단순 참/거짓 일치 여부를 가르는 조건에는 항상filter를 적용해야 성능을 극대화할 수 있다.
2. 쿼리(Query)의 기본 구조와 핵심 종류¶
Query DSL의 기본 JSON 골격은 다음과 같다:
{
"query": {
"<쿼리_타입>": {
"<대상_필드명>": { /* 파라미터 */ }
}
}
}
이제 자주 쓰이는 주요 쿼리들을 하나씩 살펴보자.
2.1 텀 / 텀즈 쿼리 (term, terms)¶
term 쿼리는 형태소 분석(Analysis)을 거치지 않고, 전달된 검색어와 인덱스에 저장된 텀(Term)이 정확히(Exact) 일치하는 도큐먼트를 찾는다.
대소문자 주의점¶
인덱스에 San Diego라는 문자열이 색인될 때, 기본 분석기(Standard Analyzer)는 소문자로 변환하여 san, diego라는 2개의 소문자 텀으로 나누어 저장한다.
# ❌ 대문자 'Diego'로 검색 시 매칭되는 텀이 없어 결과 0건
curl -H 'Content-Type: application/json' -X GET 'localhost:9200/user_bulk/_search?pretty' -d '
{
"query": {
"term": { "country": "Diego" }
}
}'
# ✅ 소문자 'diego'로 검색 시 정상 매칭 (결과 1건)
curl -H 'Content-Type: application/json' -X GET 'localhost:9200/user_bulk/_search?pretty' -d '
{
"query": {
"term": { "country": "diego" }
}
}'
공백 포함 시 주의점과 terms 쿼리¶
term 쿼리에 "san diego"처럼 공백이 있는 단어를 넣으면 인덱스에는 "san diego"라는 통째 텀이 없으므로 검색되지 않는다. 여러 개의 단어 중 하나라도 포함된 것을 찾으려면 terms 쿼리를 사용해야 한다:
curl -H 'Content-Type: application/json' -X GET 'localhost:9200/user_bulk/_search?pretty' -d '
{
"query": {
"terms": { "country": ["san", "diego"] }
}
}'
2.2 매치 쿼리 (match)¶
실무에서 가장 널리 쓰이는 대표적인 전문 검색 쿼리다.
term 쿼리와 달리 입력된 검색어를 먼저 형태소 분석한 뒤, 분석된 텀들과 비교하여 검색을 수행한다.
# "San Diego"를 검색하면 자동으로 소문자 토큰화("san", "diego") 후 검색 수행
# operator를 "and"로 지정하여 두 단어가 모두 포함된 도큐먼트만 추출
curl -H 'Content-Type: application/json' -X GET 'localhost:9200/user_bulk/_search?pretty' -d '
{
"query": {
"match": {
"country": {
"query": "San Diego",
"operator": "and"
}
}
}
}'
2.3 멀티 매치 쿼리 (multi_match)¶
하나의 검색어를 여러 개의 필드에 동시에 적용하여 검색할 때 사용한다.
# first_name 또는 last_name 필드 중 "Lenna Ketelsen"이 매칭되는 도큐먼트 검색
curl -H 'Content-Type: application/json' -X GET 'localhost:9200/user_bulk/_search?pretty' -d '
{
"query": {
"multi_match": {
"fields": ["first_name", "last_name"],
"query": "Lenna Ketelsen"
}
}
}'
2.4 불 쿼리 (bool)¶
여러 쿼리를 논리적으로 조합할 때 사용하는 가장 강력한 복합 쿼리다. 4가지 조건절을 제공한다:
must: 조건이 반드시 일치해야 함 (AND 역할, 스코어 계산)must_not: 조건이 반드시 일치하지 않아야 함 (NOT 역할, 스코어 영향 없음)should: 반드시 일치할 필요는 없으나, 일치할 경우 점수(_score)가 가산됨 (OR 역할)filter: 조건이 반드시 일치해야 하지만 스코어 계산을 생략하고 캐싱함
2.5 문자열 쿼리 (query_string)¶
URI 검색의 q 파라미터 문법을 그대로 JSON Body에서 사용할 수 있는 쿼리다. AND, OR, NOT 논리 연산자 및 와일드카드(*)를 자유롭게 혼용할 수 있다.
curl -H 'Content-Type: application/json' -X GET 'localhost:9200/user_bulk/_search?pretty' -d '
{
"query": {
"query_string": {
"default_field": "country",
"query": "San AND Diego"
}
}
}'
2.6 접두어 쿼리 (prefix)¶
지정한 글자로 시작하는 텀을 가진 도큐먼트를 찾는다. 검색창 자동완성(Autocomplete) 기능을 구현할 때 기초적으로 활용된다. (형태소 분석을 거치지 않으므로 소문자 토큰을 기준으로 검색해야 함)
# country의 토큰 중 's'로 시작하는 문서 검색 (San Francisco, San Diego 등 매칭)
curl -H 'Content-Type: application/json' -X GET 'localhost:9200/user_bulk/_search?pretty' -d '
{
"query": {
"prefix": {
"country": "s"
}
}
}'
2.7 범위 쿼리 (range)¶
숫자, 날짜, IP 등의 대소 비교 범위를 지정하여 검색한다.
gte(Greater-than or equal): 이상 (>=)gt(Greater-than): 초과 (>)lte(Less-than or equal): 이하 (<=)lt(Less-than): 미만 (<)
# birth 필드가 1989 이상, 1992 미만인 사용자 검색
curl -H 'Content-Type: application/json' -X GET 'localhost:9200/user_bulk/_search?pretty' -d '
{
"query": {
"range": {
"birth": {
"gte": 1989,
"lt": 1992
}
}
}
}'
3. 필터(Filter)의 활용과 성능 최적화¶
Elasticsearch 7.0 이후 최상위 Filter 컨텍스트가 정리(Deprecated)되면서, 모든 필터링은 bool 쿼리의 filter 절 내부에서 작성하도록 표준화되었다.
필터를 적용하면 유사도 스코어 계산 과정을 생략하므로 응답 속도가 빠르고, 결과가 내부 비트셋(Bitset) 캐시에 저장되어 동일한 필터 조건이 재사용될 때 번개처럼 빠르게 조회된다.
3.1 텀 필터 (bool.filter.term)¶
curl -H 'Content-Type: application/json' -X GET 'localhost:9200/user_bulk/_search?pretty' -d '
{
"query": {
"bool": {
"filter": {
"term": { "country": "san" }
}
}
}
}'
반환 결과의 max_score가 0.0으로 나오며, 점수 계산 없이 순수하게 조건에 맞는 도큐먼트만 초고속으로 걸러낸다.
3.2 범위 필터 (bool.filter.range)¶
날짜 범위나 가격대, 연령대 필터링 시 필수적인 패턴이다:
curl -H 'Content-Type: application/json' -X GET 'localhost:9200/user_bulk/_search?pretty' -d '
{
"query": {
"bool": {
"filter": {
"range": {
"birth": { "gte": 1989, "lt": 1992 }
}
}
}
}
}'
마치며¶
이번 글에서는 Query와 Filter의 차이점, 그리고 Query DSL의 대표적인 7대 쿼리(term, match, multi_match, bool, query_string, prefix, range)와 고성능 Filter 캐싱 기법을 정리했다.
- 검색어의 자연어 유사도 랭킹이 중요할 때는
match와multi_match를 적절히 배합하고, - 정확한 조건 분기 및 정형 데이터 필터링에는
bool쿼리의filter블록을 적극 활용하는 것이 실무 검색 엔진 최적화의 핵심이다.