JSCODE Logo
JSCODE 박재성JSCODE 제이온JSCODE 시니
온라인 강의프로그래밍 과외책/전자책무료 강의
유튜브블로그
후기
완강 후기 이벤트블로그 리뷰 이벤트AWS SAA 합격 후기 이벤트
회사명 : JSCODE대표 : 박재성사업자 등록번호 : 244-22-01557통신판매업 : 제 2023-인천미추홀-0381 호

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

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

이용약관개인정보처리방침

실전에서 바로 써먹는 Elasticsearch 입문 (검색 최적화편)

Elasticsearch 기본 개념

Elasticsearch란? / Elasticsearch 주요 활용 사례
Elasticsearch 설치하기
Elasticsearch 작동 방식 / GUI 툴
GUI 툴로 Elasticsearch 훨씬 쉽게 조작하기 (feat. Kibana)
Elasticsearch의 기본 용어 정리 (인덱스, 도큐먼트, 매핑, 필드)
인덱스 생성하기 / 매핑 정의하기 / 도큐먼트 삽입하기
도큐먼트 저장, 조회, 수정, 삭제하기

Spring Boot, Elasitcsearch를 활용해 CRUD 구현하기

[실습] Spring Boot에 Elasitcsearch 연결하기 (feat. Spring Data Elasticsearch)
[실습] Elasticsearch를 활용해 CRUD API 만들기

기본 검색 기능 및 작동 원리

단어의 순서가 바뀌어도 검색이 가능하다 ?!
[실습] Elasitcsearch의 검색 기능 테스트해보기
역인덱스(Inverted Index)란?
[실습] 역인덱스(Inverted Index)를 활용한 데이터 조회
애널라이저(Analyzer)란?
Elasticsearch에 기본값으로 설정되어 있는 애널라이저(Analyzer)
[실습] 애널라이저(Analyzer)가 토큰을 어떻게 나누는 지 확인하는 방법
[실습] 대소문자 구분없이 검색하는 방법 (lowercase)
[실습] 검색할 때 필요없는 HTML 태그 제거하기 (html_strip)
[실습] 검색할 때 필요없는 불용어(a, an, the, or, but) 제거하기 (stop)
[실습] 단어의 형태(-ed, -ing, -s 등)에 상관없이 검색하는 방법 (stemmer)
[실습] 동의어로 검색하는 방법 (synonym)

한글에 최적화된 검색 기능

한글(korean)이 제대로 검색되지 않는 현상
[실습] Nori Analyzer를 활용해 한글(korean)이 제대로 검색되게 만들기
[실습] 한글(korean)과 영어(english)가 섞인 글을 검색 가능하게 만들기

데이터의 저장 타입을 결정하는 매핑(Mapping)

매핑(mapping)이란? / 데이터 타입(data type)
매핑(mapping)의 특이한 특징 (null 허용, Array 허용)
[실습] 저장할 데이터에 맞게 매핑 정의하기

자주 사용하는 검색 기능

검색 키워드가 포함된 데이터를 조회하고 싶을 때 (match)
특정 값과 정확하게 일치하는 데이터를 조회하고 싶을 때 (term, terms)
2가지 이상의 조건을 만족시키는 데이터를 조회하고 싶을 때 (bool : filter, must)
[예제] filter와 must 구분해서 사용하기
특정 조건을 만족하지 않는 데이터를 조회하고 싶을 때 (bool : must_not)
숫자/날짜의 값에 대해 범위 조건으로 데이터를 조회하고 싶을 때 (range)
특정 조건을 만족하는 데이터 위주로 상위 노출 시키고 싶을 때 (bool : should)
[실습] 검색 결과 중 평점이 높고 좋아요 수가 많은 글을 상위에 노출시키고 싶은 경우
오타가 있더라도 유사한 단어를 포함한 데이터를 조회하고 싶을 때 (fuzziness)
여러 필드(ex. 제목, 내용)에서 검색 키워드가 포함된 데이터를 조회하고 싶을 때 (multi_match)
검색한 키워드를 하이라이팅 처리하고 싶을 때 (highlight)
페이지네이션 (Pagination), 정렬(Sorting)
하나의 필드에 text와 keyword 타입을 동시에 사용하고 싶을 때 (Multi Field)
검색 키워드를 일부 입력했을 때 검색어를 추천해주는 기능 (자동 완성 기능)

[프로젝트] Elasticsearch로 쿠팡의 상품 검색 기능 구현하기

프로젝트 설명 / 요구 사항 (상품 검색 기능, 자동 완성 기능)
기존 프로젝트 구조 살펴보기
인프라 아키텍처 설계하기
[실습] 인덱스 생성 / 매핑 정의 / 여러 필드에 걸쳐 검색하기
[실습] 대소문자 구분 없이 검색 / 단어 순서 상관없이 검색 / HTML 태그 섞이지 않게 검색
[실습] 한글, 영어 검색 / 동의어 기반 검색 / 필터링
[실습] 특정 조건 상위 노출 / 오타 허용 검색 / 하이라이팅 처리 / 페이지네이션
[실습] 자동 완성 기능
최종 쿼리 / 적용 전략 및 순서
[실습] Spring Boot에서 인덱스에 맞게 Document 정의하기
[실습] MySQL에 데이터 삽입/삭제 시 Elasticsearch에도 같이 반영되게 만들기
[실습] Spring Boot에서 Elasticsearch 활용해 자동완성 API 만들기
[실습] Spring Boot에서 Elasticsearch 활용해 검색 API 만들기
[참고 자료] 프로젝트 완성본 (Github)
현업에서는 Elasticsearch를 직접 구축해서 쓰진 않나요?
AWS Opensearch vs Elastic Cloud
[참고 자료] 실습에서 발생하는 Elastic Cloud 비용
[실습] Elastic Cloud에서 Elasticsearch 생성하기 (+ 가입하기)
[실습] Spring Boot에 Elasitc Cloud의 Elasticsearch 연결하기
[보충 강의] 비용 나가지 않게 Elastic Cloud 리소스 정리하기
← 블로그 목록으로 돌아가기

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

JSCODE 박재성
JSCODE 박재성
2026. 04. 04.
author
JSCODE 박재성
category
Elasticsearch
createdAt
Dec 6, 2025 01:20 PM
isPublic
isPublic
series
실전에서 바로 써먹는 Elasticsearch 입문 (검색 최적화편)
slug
bool-filter-and-must
type
post
updatedAt
Apr 4, 2026 10:00

✅ 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를 구분해서 사용하는 연습을 해보자.
📎
이 글은 실전에서 바로 써먹는 Elasticsearch 입문 (검색 최적화편) 강의의 수업 자료 중 일부입니다.