[실습] 인덱스 생성 / 매핑 정의 / 여러 필드에 걸쳐 검색하기

JSCODE 박재성

2026. 04. 04.

✅ 요구사항 반영하기

1. Clone 받은 프로젝트가 정상적으로 실행되는 지 확인하기
Spring Boot 프로젝트를 시작하기 전에 로컬 환경에 MySQL이 실행되어 있어야 하고, MySQL에 coupang이라는 데이터베이스가 만들어져 있어야 한다. 그리고 로컬 환경에 설치된 MySQL의 username과 password에 맞게 application.yml 파일을 수정해야 한다.
application.yml

spring:
  datasource:
    url: jdbc:mysql://localhost:3306/coupang
    username: root
    password: password123
    driver-class-name: com.mysql.cj.jdbc.Driver
  jpa:
    hibernate:
      ddl-auto: update
    show-sql: true

 
그런 뒤에 Spring Boot 서버를 실행시켜보자. 아무런 에러 없이 잘 실행된다면 정상적으로 Spring Boot와 MySQL이 연결되서 작동하는 것이다.



 
 

2. 인덱스 생성하기, 매핑 정의하기
Spring Boot에서 정의해놓은 Product 엔티티가 다음과 같은 필드를 가지고 있다. 그에 맞게 Elasticsearch에서 인덱스를 생성하고 매핑을 정의하자.
 
Product 엔티티

@Entity
@Table(name = "products")
public class Product {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    private String name;

    @Column(columnDefinition = "TEXT")
    private String description; // 에디터가 HTML로 상품 설명을 저장

    private int price;

    private double rating;

    private String category;
    
    ...
}

 
products 인덱스 생성 / 매핑 정의

DELETE /products

PUT /products
{
  "mappings": {
    "properties": {
      "id": {
        "type": "long"
      },
      "name": {
        "type": "text" // 유연한 검색 필요
      },
      "description": {
        "type": "text" // 유연한 검색 필요
      },
      "price": {
        "type": "integer" // 10억 이하의 정수
      },
      "rating": {
        "type": "double" // 실수(소수점을 가진 숫자 포함)
      },
      "category": {
        "type": "text" // 유연한 검색 필요 
      }
    }
  }
}

GET /products

상품명, 상품 설명, 카테고리명을 기반으로 관련된 상품을 검색하기 위해 name, description, category를 text 타입으로 매핑했다.
 

3. 테스트용 데이터 넣기

POST /products/_doc
{
  "id": 1,
  "name": "lg tv",
  "description": "",
  "price": 10000,
  "rating": 5.0,
  "category": ""
}

POST /products/_doc
{
  "id": 2,
  "name": "",
  "description": "lg tv",
  "price": 10000,
  "rating": 5.0,
  "category": ""
}

POST /products/_doc
{
  "id": 3,
  "name": "",
  "description": "",
  "price": 10000,
  "rating": 5.0,
  "category": "lg tv"
}

 

2. 검색하기

GET /products/_search
{
  "query": {
    "multi_match": {
      "query": "lg",
      "fields": [
        "name^3",
        "description^1",
        "category^2"
      ]
    }
  }
}

• 상품명(name), 상품 설명(description), 카테고리(category)에 포함된 키워드로 검색하더라도 검색이 잘 되는 걸 확인할 수 있다.
• 응답값을 보면 가중치에 따라 score가 책정되는 걸 확인할 수 있다. 그리고 score를 기준으로 데이터가 정렬돼서 조회된다.