Index analyzers

원문 보기 위키 갱신 2026.10.14

출처: 문서

본문

인덱스 분석기

인덱스 분석기는 인덱싱 시점에 지정되며, 문서를 인덱싱할 때 text 필드를 분석하는 데 사용돼요.

사용할 인덱스 분석기 결정하기

문서가 인덱싱될 때 필드에 어떤 분석기를 사용할지 결정하려면, OpenSearch가 다음 파라미터를 순서대로 확인해요:

필드의 analyzer 매핑 파라미터
analysis.analyzer.default 인덱스 설정
standard 분석기 (기본값)

인덱스 분석기를 지정할 때는 대부분의 경우 인덱스 내 각 text 필드마다 분석기를 지정하는 것이 가장 잘 동작한다는 점을 기억하세요. 텍스트 필드(인덱싱 시점)와 쿼리 문자열(쿼리 시점)을 같은 분석기로 분석하면, 검색이 인덱스에 저장된 것과 동일한 용어를 사용하도록 보장돼요. {: .important }

어떤 분석기가 어떤 필드와 연결되어 있는지 확인하는 방법은 분석기 설정 확인하기를 참고하세요.

필드에 인덱스 분석기 지정하기

인덱스 매핑을 생성할 때 각 text 필드에 analyzer 파라미터를 지정할 수 있어요. 예를 들어 다음 요청은 text_entry 필드에 simple 분석기를 지정해요:

PUT testindex
{
  "mappings": {
    "properties": {
      "text_entry": {
        "type": "text",
        "analyzer": "simple"
      }
    }
  }
}

{% include copy-curl.html %}

인덱스에 기본 인덱스 분석기 지정하기

인덱스의 모든 텍스트 필드에 동일한 분석기를 사용하려면 다음과 같이 analysis.analyzer.default 설정에 지정하면 돼요:

PUT testindex
{
  "settings": {
    "analysis": {
      "analyzer": {
        "default": {
          "type": "simple"
        }
      }
    }
  }
}