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

프로젝트 설명 / 요구 사항 (상품 검색 기능, 자동 완성 기능)

JSCODE 박재성
JSCODE 박재성
2026. 04. 04.
author
JSCODE 박재성
category
Elasticsearch
createdAt
Dec 6, 2025 01:21 PM
isPublic
isPublic
series
실전에서 바로 써먹는 Elasticsearch 입문 (검색 최적화편)
slug
project-description
type
post
updatedAt
Apr 4, 2026 10:00
👨🏻‍🏫
지금까지 배운 Elasticsearch의 기능을 활용해 쿠팡의 상품 검색 기능을 구현해보자.

✅ 프로젝트 설명

elasticsearch-coupang-project
JSCODE-EDU • Updated Aug 4, 2025
Spring boot(gradle), Spring Data JPA, MySQL을 활용해 아래 API를 가진 서버를 운영하고 있었다고 가정하자.
  • 상품 전체 조회 API
  • 상품 등록 API
  • 상품 삭제 API
 
그런데 기획자가 검색 기능과 검색어 자동 완성 기능을 구현해달라고 요청한 것이다. 기존 프로젝트에서 검색 기능과 검색어 자동 완성 기능을 구현해야 하는데 MySQL로는 한계가 있어 Elasticsearch를 활용하기로 결정한 상황이라고 하자.
 
기획자의 구체적인 요구 사항은 다음과 같다.
 
 

✅ 요구 사항

  1. 검색 기능
    1. 검색을 했을 때 상품명, 상품 설명, 카테고리명을 기반으로 관련된 상품을 검색해야 한다.
      상품명 : 상품 설명 : 카테고리명의 score 가중치를 3 : 1 : 2로 설정하기
      대소문자 구분없이 검색할 수 있어야 한다.
      단어의 순서에 상관없이 검색할 수 있어야 한다.
      • ex) 삼성 노트북이라는 상품을 노트북 삼성이라고 검색해도 조회가 되야 한다.
      상품 설명에 HTML 태그가 섞여서 저장되어 있는데, 검색할 때는 HTML 태그로 검색되지 않아야 한다.
      한글, 영어 둘 다 검색이 잘 돼야 한다.
      상품명에 대해서는 아래 값을 동의어로 인식할 수 있어야 한다.
      samsung, 삼성 apple, 애플 노트북, 랩탑, 컴퓨터, computer, laptop, notebook 전화기, 휴대폰, 핸드폰, 스마트폰, 휴대전화, phone, smartphone, mobile phone, cell phone 아이폰, iphone 맥북, 맥, macbook, mac
      카테고리, 가격으로 필터링을 할 수 있어야 한다.
      • 특정 카테고리 내에서만 검색할 수 있어야 한다.
      • 특정 가격 범위 내에서만 검색할 수 있어야 한다.
      되도록이면 검색 결과 중 평점이 4.0이 넘는 상품을 상위에 노출시킬 수 있도록 한다.
      검색어에 어느 정도 오타가 있더라도 유사한 상품을 조회할 수 있어야 한다.
      • ex) samsung notebook이라는 상품을 simsung notebook이라고 검색해도 조회가 되야 한다.
      상품명에서 일치하는 검색 키워드는 하이라이팅 처리( <b></b>)를 해야 한다.
      상품이 5개씩 조회되도록 페이지네이션 해야 한다.
       
  1. 자동 완성 기능
    1. 상품명으로만 자동 완성이 되도록 해야 한다.
      자동 완성 결과가 5개만 조회되도록 설정해야 한다.
 
 
 
📎
이 글은 실전에서 바로 써먹는 Elasticsearch 입문 (검색 최적화편) 강의의 수업 자료 중 일부입니다.