Запрос Match

Вы можете упростить синтаксис запроса соответствия, объединив параметры <field> и query. Например:

GET /_search
{
  "query": {
    "match": {
      "message": "this is a test"
    }
  }
}

Запрос match имеет тип boolean. Это означает, что предоставленный текст анализируется, а процесс анализа создаёт булевый запрос на основе этого текста. Параметр operator может быть установлен в значение or или and для управления булевыми условиями (по умолчанию устанавливается значение or). Минимальное количество необязательных условий should для соответствия можно задать с помощью параметра minimum_should_match.

Вот пример с параметром operator:

GET /_search
{
  "query": {
    "match": {
      "message": {
        "query": "this is a test",
        "operator": "and"
      }
    }
  }
}

Параметр analyzer может быть установлен для управления анализатором, который выполнит анализ текста. По умолчанию используется явное определение сопоставления поля или анализатор по умолчанию для поиска.

Параметр lenient может быть установлен в значение true для игнорирования исключений, вызванных несоответствием типов данных, таких как попытка запроса числового поля с текстовой строкой запроса. По умолчанию устанавливается значение false.

fuzziness позволяет выполнять неточное соответствие на основе типа запрошенного поля. См. Неточность для разрешённых значений.

prefix_length и max_expansions в этом случае можно установить для управления процессом неточности. Если параметр неточности установлен, запрос будет использовать top_terms_blended_freqs_${max_expansions} в качестве метода переписывания. Параметр fuzzy_rewrite позволяет управлять тем, как будет переписан запрос.

По умолчанию разрешены неточные транспозиции (ab → ba), но их можно отключить, установив fuzzy_transpositions в значение false.

GET /_search
{
  "query": {
    "match": {
      "message": {
        "query": "this is a testt",
        "fuzziness": "AUTO"
      }
    }
  }
}

Если используемый анализатор удаляет все токены в запросе, как это делает фильтр stop, то по умолчанию никакие документы не будут соответствовать. Чтобы изменить это, можно использовать опцию zero_terms_query, которая принимает значения none (по умолчанию) и all, что соответствует запросу match_all.

GET /_search
{
  "query": {
    "match": {
      "message": {
        "query": "to be or not to be",
        "operator": "and",
        "zero_terms_query": "all"
      }
    }
  }
}

Запрос match поддерживает параметр cutoff_frequency, который позволяет указать абсолютную или относительную частоту документов, где термины с высокой частотой перемещаются в необязательный подзапрос и учитываются только в том случае, если один из терминов с низкой частотой (ниже порога) в случае оператора or или все термины с низкой частотой в случае оператора and соответствуют документу.

Этот запрос позволяет динамически обрабатывать stopwords во время выполнения, является независимым от предметной области и не требует файла стоп-слов. Он предотвращает вычисление/итерацию терминов высокой частоты и учитывает их только в том случае, если термин с более высокой значимостью/меньшей частотой соответствует документу. Тем не менее, если все термины запроса находятся выше заданной cutoff_frequency, запрос автоматически преобразуется в чистый конъюнктивный (and) запрос для обеспечения быстрого выполнения.

cutoff_frequency может быть относительным к общему количеству документов, если находится в диапазоне от 0 (включительно) до 1 (исключительно), или абсолютным, если больше или равно 1.0.

Вот пример запроса, состоящего исключительно из стоп-слов:

GET /_search
{
  "query": {
    "match": {
      "message": {
        "query": "to be or not to be",
        "cutoff_frequency": 0.001
      }
    }
  }
}

Запрос match поддерживает расширение синонимов с несколькими терминами с помощью фильтра токенов synonym_graph. При использовании этого фильтра парсер создаёт фразный запрос для каждого синонима с несколькими терминами. Например, следующий синоним: "ny, new york" даст:

(ny OR ("new york"))

Также возможно соответствие многословным синонимам с конъюнкцией вместо дизъюнкции:

GET /_search
{
   "query": {
       "match" : {
           "message": {
               "query" : "ny city",
               "auto_generate_synonyms_phrase_query" : false
           }
       }
   }
}

Приведённый выше пример создаёт булевый запрос:

(ny OR (new AND york)) city

который соответствует документам с термином ny или конъюнкцией new AND york. По умолчанию параметр auto_generate_synonyms_phrase_query установлен в значение true.