JSCODE Logo
프로그래밍 과외블로그후기멘토진
회사명 : JSCODE대표 : 박재성사업자 등록번호 : 244-22-01557통신판매업 : 제 2023-인천미추홀-0381 호
학원 명칭 : 제이에스코드(JSCODE)원격학원학원설립ㆍ운영 등록번호 : 제6063호

서울특별시 구로구 경인로 20가길 11(오류동, 아델리아)

Copyright ⓒ 2025 JSCODE - 최상위 현업 개발자들의 프로그래밍 교육 All rights reserved.

이용약관개인정보처리방침
← 블로그 목록으로 돌아가기

2가지 이상의 조건을 만족시키는 데이터를 조회하고 싶을 때 (bool : filter, must)

JSCODE 박재성
JSCODE 박재성
2025-12-06
author
JSCODE 박재성
category
Elasticsearch
createdAt
Dec 6, 2025
series
실전에서 바로 써먹는 Elasticsearch 입문 (검색 최적화편)
slug
bool-filter-and-must
type
post
updatedAt
Dec 6, 2025 04:48 AM

✅ 2가지 이상의 조건을 만족시키는 데이터를 조회하고 싶을 때 (bool : filter, must)

이전 강의에서 아래와 같이 쿼리를 했을 때 에러가 발생하는 걸 확인했다.
GET /boards/_search { "query": { "term": { "category": "자유 게시판", "board_id": 1 } } }
notion image
 
1가지 조건이 아닌 2가지 이상의 조건을 만족시키는 쿼리를 작성하려면 bool 쿼리를 활용해야 한다. 즉, bool 쿼리는 여러 쿼리를 조합하기 위해서 사용하는 개념이다. bool 쿼리에는 크게 4가지 기능이 있다.
  • must : SQL문에서의 AND 역할을 함
  • filter : SQL문에서의 AND 역할을 함
  • must_not : SQL문에서의 NOT 역할을 함
  • should : 조건을 만족하면 좋고, 아니면 말고.
이 중에서 2가지 조건을 전부 만족시키는 데이터를 조회하기 위해서 must와 filter에 대해 알아보도록 하자.
 
예시를 바로 살펴보자.
GET /boards/_search { "query": { "bool": { "filter": [ { "term": { "category": "자유 게시판" } }, { "term": { "board_id": 1 } } ] } } } GET /boards/_search { "query": { "bool": { "must": [ { "term": { "category": "자유 게시판" } }, { "term": { "board_id": 1 } } ] } } }
위 두 쿼리를 실행시켜보면 정상적으로 원하는 데이터를 잘 불러오는 것처럼 보이지만, 2번째 쿼리는 must의 용도에 맞지 않게 잘못 사용한 쿼리이다. 그럼 filter와 must의 차이에 대해 알아보고 각 기능은 언제 사용해야 하는 지까지 알아보자.
 
 

✅ filter vs must

filter와 must의 가장 큰 차이는 filter는 score(점수)에 영향을 주지 않고, must는 score(점수)에 영향을 준다는 점이다. 여기서 얘기하는 score(점수)는 검색을 할 때 관련도가 얼마나 높은 지를 나타내는 수치이다.
(참고 :
📖
역인덱스(Inverted Index)란?
,
🎯
[실습] 역인덱스(Inverted Index)를 활용한 데이터 조회
)
 
score(점수)가 활용되는 대표적인 쿼리가 match이다. score(점수)를 활용해 관련도가 높은 도큐먼트를 우선적으로 조회해온다. 즉, 정확하게 일치하지 않아도 도큐먼트를 조회해온다. 반면, term 쿼리와 같이 조건을 정확하게 일치시키지 않으면 도큐먼트를 아예 조회해오지 않는다. 이 때문에 score(점수)를 사용하지 않는다.
 
filter와 must의 사용 용도는 score(점수)에 영향을 주는 쿼리인지 아닌지로 구분해서 사용해야 한다.
  • filter : score(점수)와 상관없는 쿼리인 경우 → ex) term
  • must : score(점수)와 상관있는 쿼리인 경우 → ex) match
 
따라서 아래 예시에서의 term 쿼리는 score(점수)와 상관없는 쿼리이므로 must가 아닌 filter 내부에서 사용하는 것이 올바른 사용 방식이다.
// 올바른 사용 방식 GET /boards/_search { "query": { "bool": { "filter": [ { "term": { "category": "자유 게시판" } }, { "term": { "board_id": 1 } } ] } } } // 잘못된 방식 GET /boards/_search { "query": { "bool": { "must": [ { "term": { "category": "자유 게시판" } }, { "term": { "board_id": 1 } } ] } } }
 
 

✅ filter와 must를 쉽게 구분하기

점수(score)를 활용하는 쿼리는 text 타입을 기반으로 검색을 유연하게 해주는 쿼리(match, match_phrase, multi_match 등) 밖에 없다. 즉, 정확하게 일치하지 않더라도 관련성이 있는 데이터까지 조회하는 쿼리에 대해서만 must를 사용하면 된다. 그 외에는 전부 filter를 쓰면 된다.
 
머릿속에 아래와 같이 연결을 시켜도 이해하기가 쉽다.
  • 유연한 검색 필요
    • → text 타입, match 쿼리
      → bool의 must
  • 정확한 검색 필요 (정확한 값 비교)
    • → text 이외의 타입, term 쿼리
      → bool의 filter
 
👨🏻‍🏫
다음 강의에서 조금 더 복잡한 쿼리에서 filter와 must를 구분해서 사용하는 연습을 해보자.
author
JSCODE 박재성
category
Elasticsearch
createdAt
Dec 6, 2025
series
실전에서 바로 써먹는 Elasticsearch 입문 (검색 최적화편)
slug
type
series-footer
updatedAt
Dec 6, 2025 05:12 AM
📎
이 글은 실전에서 바로 써먹는 Elasticsearch 입문 (검색 최적화편) 강의의 수업 자료 중 일부입니다.