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

author

JSCODE 박재성

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

이전 강의(

매핑(mapping)이란? / 데이터 타입(data type))에서 데이터 타입을 설명할 때 text는 유연한 검색이 필요할 때 사용한다고 얘기했다. 반면에 keyword는 정확한 검색이 필요할 때 사용한다고 했다.

그런데 유연한 검색과 정확한 검색 둘 다 하고 싶은 경우가 있을 수 있다. 예를 들어, 상품 카테고리와 이름 필드에 저장된 필드 값에 대해 키워드로 검색할 때는 유연하게 검색되게 하고 싶고, 정확한 비교를 통해 특정 카테고리를 기준으로 필터링을 하고 싶을 수 있다. 즉, text 타입과 keyword 타입을 동시에 사용하고 싶은 경우이다.

이 문제를 어떻게 해결할 수 있는 지 바로 알아보자.

✅ 문제 상황

먼저 위에서 설명한 문제 상황부터 경험해보자.

인덱스 생성


DELETE /products

PUT /products
{
  "mappings": {
    "properties": {
      "name": {
        "type": "text",
        "analyzer": "nori"
      },
      "category": {
        "type": "text",
        "analyzer": "nori"
      }
    }
  }
}

데이터 삽입


POST /products/_doc
{
  "name": "삼성 세탁기",
  "category": "특수 가전제품"
}

검색하기

[name, category을 활용해 유연하게 검색하고 싶을 때]


GET /products/_search
{
  "query": {
    "multi_match": {
      "query": "가전",
      "fields": ["name", "category"]
    }
  }
}

[특수 가전제품 카테고리의 상품만 검색하고 싶을 때]


GET /products/_search
{
  "query": {
    "term": {
      "category": "특수 가전제품"
    }
  }
}

⇒ 제대로 작동하지 않는다! 이걸 해결하기 위해서는 인덱스의 category의 데이터 타입을 설정할 때 text 타입과 keyword 타입을 둘 다 선언해야 한다. 그 방법을 알아보자.

✅ 해결 방법

하나의 필드에 여러 개의 타입을 선언할 수 있는 방법을 활용할 것이다. 이 방법을 보고 Elasticsearch에서는 multi-fields라고 얘기한다.

인덱스 생성, 데이터 삽입


DELETE /products

PUT /products
{
  "mappings": {
    "properties": {
      "name": {
        "type": "text",
        "analyzer": "nori"
      },
      "category": {
        "type": "text",
        "analyzer": "nori",
        "fields": { 
          "raw": { // 서브 필드명 (다른 이름으로 설정해도 됨)
            "type": "keyword"
          }
        }
      }
    }
  }
}

위와 같이 설정하면 category 필드에 하나의 데이터를 삽입하더라도 text, keyword 타입의 형태로 나눠서 보관하게 된다.

데이터 삽입


POST /products/_doc
{
  "name": "삼성 세탁기",
  "category": "특수 가전제품"
}

text 타입은 토큰으로 분리해서 저장하지만, keyword 타입은 값 자체를 통째로 저장한다. 그래서category에 특수 가전제품이라는 값을 삽입했을 때 아래와 같이 저장된다.

category (text 타입)	category.raw (keyword 타입)
특수	특수 가전제품
가전	ㅤ
제품	ㅤ

정말 위와 같이 저장되는 지 확인해보자.

Anaylze API로 디버깅해보기


POST /products/_analyze
{
  "field": "category",
  "text": "특수 가전제품"
}

POST /products/_analyze
{
  "field": "category.raw",
  "text": "특수 가전제품"
}

위에서 예상한대로 토큰이 분리되는 걸 확인할 수 있다. 그럼 이제 실제 검색을 해보자.

검색해보기

[name, category을 활용해 유연하게 검색하고 싶을 때]


POST /products/_search
{
  "query": {
    "multi_match": {
      "query": "가전",
      "fields": ["name", "category"]
    }
  }
}

[특수 가전제품 카테고리의 상품만 검색하고 싶을 때]


POST /products/_search
{
  "query": {
    "term": {
      "category.raw": "특수 가전제품"
    }
  }
}

정상적으로 잘 응답하는 걸 볼 수 있다.

author

JSCODE 박재성