Match Boolean prefix 쿼리

Match Boolean prefix 쿼리

match_bool_prefix 쿼리는 제공된 검색 문자열을 분석하고 문자열의 용어들로 Boolean 쿼리를 만들어요. 마지막 용어를 제외한 모든 용어를 전체 단어로 사용해 매칭하고, 마지막 용어는 접두사로 사용합니다. 어떤 순서로든 전체 단어 용어나 접두사 용어로 시작하는 용어를 포함한 문서를 반환합니다.

출처: 문서

본문

match_bool_prefix 쿼리는 제공된 검색 문자열을 분석하고 문자열의 용어들로 Boolean 쿼리를 만들어요. 마지막 용어를 제외한 모든 용어를 전체 단어로 사용해 매칭해요. 마지막 용어는 접두사로 사용돼요. match_bool_prefix 쿼리는 전체 단어 용어나 접두사 용어로 시작하는 용어를 어떤 순서로든 포함한 문서를 반환해요.

다음 예시는 기본 match_bool_prefix 쿼리를 보여줘요.

GET _search
{
  "query": {
    "match_bool_prefix": {
      "title": "the wind"
    }
  }
}

추가 파라미터를 전달하려면 확장 구문을 사용할 수 있어요.

GET _search
{
  "query": {
    "match_bool_prefix": {
      "title": {
        "query": "the wind",
        "analyzer": "stop"
      }
    }
  }
}

예시 (Example)

예를 들어 다음 문서가 있는 인덱스를 생각해 볼게요.

PUT testindex/_doc/1
{
  "title": "The wind rises"
}

PUT testindex/_doc/2
{
  "title": "Gone with the wind"
  
}

다음 match_bool_prefix 쿼리는 전체 단어 rises와 wi로 시작하는 단어를 어떤 순서로든 검색해요.

GET testindex/_search
{
  "query": {
    "match_bool_prefix": {
      "title": "rises wi"
    }
  }
}

앞의 쿼리는 다음 Boolean 쿼리와 동일해요.

GET testindex/_search
{
  "query": {
    "bool" : {
      "should": [
        { "term": { "title": "rises" }},
        { "prefix": { "title": "wi"}}
      ]
    }
  }
}

응답에는 두 문서가 모두 포함돼요.

응답

{
  "took": 15,
  "timed_out": false,
  "_shards": {
    "total": 1,
    "successful": 1,
    "skipped": 0,
    "failed": 0
  },
  "hits": {
    "total": {
      "value": 2,
      "relation": "eq"
    },
    "max_score": 1.73617,
    "hits": [
      {
        "_index": "testindex",
        "_id": "1",
        "_score": 1.73617,
        "_source": {
          "title": "The wind rises"
        }
      },
      {
        "_index": "testindex",
        "_id": "2",
        "_score": 1,
        "_source": {
          "title": "Gone with the wind"
        }
      }
    ]
  }
}

match_bool_prefix와 match_phrase_prefix 쿼리

match_bool_prefix 쿼리는 어떤 위치에서든 용어를 매칭하는 반면, match_phrase_prefix 쿼리는 용어를 전체 구문으로 매칭해요. 차이를 설명하기 위해 앞 섹션의 match_bool_prefix 쿼리를 다시 고려해 볼게요.

GET testindex/_search
{
  "query": {
    "match_bool_prefix": {
      "title": "rises wi"
    }
  }
}

The wind rises와 Gone with the wind 모두 검색 용어와 일치하므로 이 쿼리는 두 문서를 모두 반환해요.

이제 같은 인덱스에서 match_phrase_prefix 쿼리를 실행해 보세요.

GET testindex/_search
{
  "query": {
    "match_phrase_prefix": {
      "title": "rises wi"
    }
  }
}

어떤 문서도 지정된 순서로 rises wi라는 구문을 포함하지 않으므로 응답에 문서가 반환되지 않아요.

분석기 (Analyzer)

기본적으로 text 필드에서 쿼리를 실행하면 검색 텍스트가 필드와 연관된 인덱스 분석기를 사용해 분석돼요. analyzer 파라미터에서 다른 검색 분석기를 지정할 수 있어요.

GET testindex/_search
{
  "query": {
    "match_bool_prefix": {
      "title": {
        "query": "rise the wi",
        "analyzer": "stop"
      }
    }
  }
}

파라미터 (Parameters)

이 쿼리는 필드 이름(<field>)을 최상위 파라미터로 받아들여요.

GET _search
{
  "query": {
    "match_bool_prefix": {
      "": {
        "query": "text to search for",
        ... 
      }
    }
  }
}

<field>는 다음 파라미터를 받아들여요. query를 제외한 모든 파라미터는 선택 사항이에요.

fuzziness, fuzzy_transpositions, fuzzy_rewrite, max_expansions, prefix_length 파라미터는 마지막 용어를 제외한 모든 용어에 대해 구성된 term 하위 쿼리에 적용될 수 있어요. 이들은 마지막 용어에 대해 구성된 prefix 쿼리에는 아무 효과도 없어요.

더 알아보기 (Learn more)

• OpenSearch 공식 문서