Elasticsearch——Match query

返回与提供的text、number、date或boolean匹配的文档。匹配前会分析提供的文本。

match查询是执行全文搜索的标准查询，包括模糊匹配选项。

例如：

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

match的Top-level参数

<field>

（必填，object）要搜索的字段。

Parameters for <field>

query:

        （必填）我们希望在提供的<field>中找到的text、number、boolean或date。

        match query在执行搜索之前分析任何提供的文本。这意味着匹配查询可以在text字段中搜索经过分析的标记，而不是精确的term。

analyzer:

        （可选，string）分析器，用于将查询值中的文本转换为标记。默认为映射到<field>的索引时间分析器。如果没有映射分析器，则使用索引的默认分析器。

auto_generate_synonyms_phrase_query:

        （可选，Boolean）如果为true，将自动为多术语同义词创建匹配短语查询。默认为true。

fuzziness:

        （可选，String）匹配允许的最大编辑距离。

max_expansions:

        （可选，integer）查询将扩展到的最大术语数。默认值为50。

prefix_length:

        （可选，integer）为模糊匹配保留不变的起始字符数。默认值为0。

fuzzy_transpositions:

        （可选，Boolean）如果为真，则模糊匹配的编辑包括两个相邻字符（ab）的换位→ ba）。默认为true。

operator:

        （可选，String）用于解释查询值中文本的布尔逻辑。有效值为：

        OR(Default):例如，capital of Hungary 的查询值被解释为capital OR of OR Hungary。

        AND:例如，capital of Hungary的查询值被解释为 capital AND of AND Hungary。

minimum_should_match：

        （可选，String）返回文档必须匹配的最小子句数。

Notes

一个短请求例子：

通过组合<field>和查询参数，可以简化匹配查询语法。例如：

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

How the match query works

match query的类型为boolean。这意味着将对提供的文本进行分析，分析过程将从提供的文本构造一个布尔查询。运算符参数可以设置为or或and，以控制布尔子句（默认为or）。可以使用minimum_should_match参数设置要匹配的可选should子句的最小数量。

以下是运算符参数的示例：

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

analyzer可设置为控制哪个analyzer将对文本执行分析过程。它默认为字段显式映射定义或默认搜索分析器。

可以将lenient参数设置为true，以忽略由数据类型不匹配引起的异常，例如尝试使用text查询字符串查询数值字段。默认为false。

Fuzziness in the match query

fuzziness(模糊性)允许根据所查询字段的类型进行模糊匹配。

在这种情况下，可以设置prefix_length和max_expansions来控制模糊过程。如果设置了fuzzy选项，查询将使用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"
      }
    }
  }
}

Zero terms query

如果使用的分析器像停止过滤器一样删除查询中的所有标记，则默认行为是根本不匹配任何文档。为了更改是否可以使用zero_terms_query选项，该选项接受none（默认）和与match_all查询相对应的all查询。

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