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 리소스 정리하기
← 블로그 목록으로 돌아가기

하나의 필드에 text와 keyword 타입을 동시에 사용하고 싶을 때 (Multi Field)

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

✅ 하나의 필드에 text와 keyword 타입을 동시에 사용하고 싶을 때 (Multi Field)

이전 강의(
📖
매핑(mapping)이란? / 데이터 타입(data type)
)에서 데이터 타입을 설명할 때 text는 유연한 검색이 필요할 때 사용한다고 얘기했다. 반면에 keyword는 정확한 검색이 필요할 때 사용한다고 했다.
 
그런데 유연한 검색과 정확한 검색 둘 다 하고 싶은 경우가 있을 수 있다. 예를 들어, 상품 카테고리와 이름 필드에 저장된 필드 값에 대해 키워드로 검색할 때는 유연하게 검색되게 하고 싶고, 정확한 비교를 통해 특정 카테고리를 기준으로 필터링을 하고 싶을 수 있다. 즉, text 타입과 keyword 타입을 동시에 사용하고 싶은 경우이다.
 
이 문제를 어떻게 해결할 수 있는 지 바로 알아보자.
 
 

✅ 문제 상황

먼저 위에서 설명한 문제 상황부터 경험해보자.
  1. 인덱스 생성
    1. DELETE /products PUT /products { "mappings": { "properties": { "name": { "type": "text", "analyzer": "nori" }, "category": { "type": "text", "analyzer": "nori" } } } }
       
  1. 데이터 삽입
    1. POST /products/_doc { "name": "삼성 세탁기", "category": "특수 가전제품" }
       
  1. 검색하기
    1. [name, category을 활용해 유연하게 검색하고 싶을 때]
      GET /products/_search { "query": { "multi_match": { "query": "가전", "fields": ["name", "category"] } } }
       
      [특수 가전제품 카테고리의 상품만 검색하고 싶을 때]
      GET /products/_search { "query": { "term": { "category": "특수 가전제품" } } }
      ⇒ 제대로 작동하지 않는다! 이걸 해결하기 위해서는 인덱스의 category의 데이터 타입을 설정할 때 text 타입과 keyword 타입을 둘 다 선언해야 한다. 그 방법을 알아보자.
 
 

✅ 해결 방법

하나의 필드에 여러 개의 타입을 선언할 수 있는 방법을 활용할 것이다. 이 방법을 보고 Elasticsearch에서는 multi-fields라고 얘기한다.
 
  1. 인덱스 생성, 데이터 삽입
    1. DELETE /products PUT /products { "mappings": { "properties": { "name": { "type": "text", "analyzer": "nori" }, "category": { "type": "text", "analyzer": "nori", "fields": { "raw": { // 서브 필드명 (다른 이름으로 설정해도 됨) "type": "keyword" } } } } } }
      위와 같이 설정하면 category 필드에 하나의 데이터를 삽입하더라도 text, keyword 타입의 형태로 나눠서 보관하게 된다.
       
  1. 데이터 삽입
    1. POST /products/_doc { "name": "삼성 세탁기", "category": "특수 가전제품" }
      text 타입은 토큰으로 분리해서 저장하지만, keyword 타입은 값 자체를 통째로 저장한다. 그래서category에 특수 가전제품이라는 값을 삽입했을 때 아래와 같이 저장된다.
      category (text 타입)
      category.raw (keyword 타입)
      특수
      특수 가전제품
      가전
      ㅤ
      제품
      ㅤ
      정말 위와 같이 저장되는 지 확인해보자.
       
  1. Anaylze API로 디버깅해보기
    1. POST /products/_analyze { "field": "category", "text": "특수 가전제품" } POST /products/_analyze { "field": "category.raw", "text": "특수 가전제품" }
      위에서 예상한대로 토큰이 분리되는 걸 확인할 수 있다. 그럼 이제 실제 검색을 해보자.
       
  1. 검색해보기
    1. [name, category을 활용해 유연하게 검색하고 싶을 때]
      POST /products/_search { "query": { "multi_match": { "query": "가전", "fields": ["name", "category"] } } }
       
      [특수 가전제품 카테고리의 상품만 검색하고 싶을 때]
      POST /products/_search { "query": { "term": { "category.raw": "특수 가전제품" } } }
      정상적으로 잘 응답하는 걸 볼 수 있다.
 
 
📎
이 글은 실전에서 바로 써먹는 Elasticsearch 입문 (검색 최적화편) 강의의 수업 자료 중 일부입니다.