Elasticsearch 7.1API 文档翻译

Query DSL》Full Text Queries 》 match query

返回与提供的文本，数字，日期或布尔值匹配的文档。匹配之前对提供的文本进行分析
匹配查询是用于执行全文搜索的标准查询，其中包括模糊匹配的选项。

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

顶级参数

（必填，对象）您要搜索的字段。

query

（必需）您希望在提供的中找到的文本，数字，布尔值或日期。
匹配查询在执行搜索之前会分析所有提供的文本。这意味着匹配查询可以在文本字段中搜索已分析的标记，而不是确切的字词。

analyzer

（可选，字符串）分析器，用于将查询值中的文本转换为令牌。默认为为映射的索引时间分析器。如果未映射任何分析器，则使用索引的默认分析器。

auto_generate_synonyms_phrase_query

可选，布尔值）如果为true，则会自动为多个术语同义词创建匹配短语查询。默认为true

fuzziness

（可选，字符串）匹配允许的最大编辑距离，有关有效值和更多信息，请参见模糊性。

max_expansions

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

prefix_length

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

fuzzy_transpositions

（可选，布尔值）如果为true，则模糊匹配的编辑将包括两个相邻字符的转置（ab→ba）。默认为true

fuzzy_rewrite

（可选，字符串）用于重写查询的方法。有关有效值和更多信息，请参见rewrite参数。

lenient

（可选，布尔值）如果为true，则将忽略基于格式的错误，例如为数字字段提供文本查询值。默认为false

operator

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

• OR

• AND

minimum_should_match

（可选，字符串）要返回的文档必须匹配的最小子句数。有关有效值和更多信息，请参见minimum_should_match参数

zero_terms_query

可选，字符串）指示在分析器删除所有标记（例如使用停止过滤器时）时是否不返回文档。有效值为
none (Default);all

简短的示例

您可以通过组合和查询参数来简化匹配查询语法。

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

匹配查询的工作方式

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

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

可以将分析器设置为控制哪个分析器将对文本执行分析过程

模糊查询

模糊性允许基于要查询的字段类型进行模糊匹配。有关允许的设置，请参见模糊性。在这种情况下，可以设置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"
      }
    }
  }
}

Zero term query

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

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