버전 정보

이 가이드는 다음 버전을 기준으로 작성되었습니다:

• Elasticsearch: 8.11.x
• Kibana: 8.11.x
• Spring Boot: 3.2.x
• Spring Data Elasticsearch: 5.2.x
• Java: 17+

다른 버전에서는 일부 API나 설정이 다를 수 있습니다. 특히 Elasticsearch 7.x와 8.x는 보안 설정, 클라이언트 API 등에서 큰 차이가 있습니다.

Elasticsearch란?#

Elasticsearch는 분산 검색 및 분석 엔진입니다. 대용량 데이터에서 빠르게 검색하고, 실시간으로 분석할 수 있게 해주는 도구입니다.

왜 Elasticsearch가 필요한가?#

RDB의 LIKE '%검색어%'로 검색하면 어떤 문제가 생길까요?

Elasticsearch는 이런 문제들을 해결하면서도 실시간 검색, 복잡한 집계, 고가용성을 제공합니다.

언제 Elasticsearch를 써야 할까?#

적합한 경우:

• 상품, 게시글 등 풀텍스트 검색이 필요할 때
• 로그, 메트릭 등 시계열 데이터 분석이 필요할 때
• 대시보드용 실시간 집계가 필요할 때
• 자동완성, 오타 교정, 동의어 처리가 필요할 때
• 데이터가 많아 RDB 검색이 느려졌을 때

과할 수 있는 경우:

• 단순 CRUD만 필요할 때 (RDB로 충분)
• 트랜잭션 무결성이 중요할 때 (Elasticsearch는 Eventually Consistent)
• 데이터가 적고 검색 요구사항이 단순할 때
• 운영 인프라를 갖출 여력이 없을 때

Elasticsearch의 한계와 주의점#

Elasticsearch를 도입하기 전에 알아야 할 현실적인 단점입니다:

실무 조언: Elasticsearch는 “검색 전용 보조 저장소"로 사용하고, RDB를 메인 저장소로 유지하는 패턴이 가장 안전합니다. ES 장애 시에도 서비스 핵심 기능은 유지됩니다.

대안 기술 비교#

Elasticsearch만이 유일한 선택지는 아닙니다:

선택 기준: 데이터 규모 < 100만 건, 검색 요구사항이 단순하면 PostgreSQL FTS나 Meilisearch로 충분합니다. Elasticsearch는 대규모, 복잡한 요구사항에 적합합니다.

RDB vs Elasticsearch#

핵심 차이: RDB는 정규화된 데이터의 정확한 조회에, Elasticsearch는 비정규화된 데이터의 빠른 검색에 최적화되어 있습니다.

이 가이드에서 다루는 것#

Quick Start#

5분 만에 Elasticsearch에 데이터를 넣고 검색해봅니다. 개념보다 먼저 동작하는 것을 확인하세요.

개념 이해#

단순히 “이렇게 쓰세요"가 아닌, 왜 이렇게 동작하는지 원리를 설명합니다.

실습 예제#

Spring Boot 기반의 실행 가능한 예제 코드입니다.

• 환경 설정 - Docker로 Elasticsearch + Kibana 구성
• 기본 예제 - Document CRUD와 기본 검색 구현
• 상품 검색 시스템 - 한글 검색, 자동완성, 필터링 구현

How-To Guide#

특정 문제를 해결하기 위한 단계별 가이드입니다:

• 느린 쿼리 최적화 - 검색 응답 시간이 느릴 때 대응
• 메모리 문제 해결 - OOM, GC 문제 진단 및 해결

부록#

• 용어 사전 - Elasticsearch 용어 빠른 참조
• FAQ - 자주 묻는 질문
• 참고 자료 - 공식 문서 및 추가 학습 자료

선수 지식#

• 필수: REST API 기본, JSON 형식 이해
• 도움됨: Java/Spring Boot 경험, RDB 사용 경험

학습 경로 제안#

처음이라면:     Quick Start → 핵심 구성요소 → 데이터 모델링 → 기본 예제
검색 구현:      Query DSL → 검색 관련성 → 상품 검색 시스템
데이터 분석:    집계 → 인덱싱 전략
운영 준비:      클러스터 관리 → 성능 튜닝 → 고가용성

각 문서는 독립적으로 읽을 수 있지만, 처음이라면 위 순서를 추천합니다.