匹配查询 #

使用 match 查询在特定文档字段上执行全文搜索。如果你在 text 字段上运行 match 查询， match 查询会分析提供的搜索字符串，并返回匹配字符串中任意词的文档。如果你在精确值字段上运行 match 查询，它会返回匹配精确值的文档。搜索精确值字段的推荐方式是使用过滤（ filter ）查询，因为与普通查询不同，过滤（ filter ）查询会被缓存。

以下示例展示了在 title 中对 wind 的基本 match 查询：

GET _search
{
  "query": {
    "match": {
      "title": "wind"
    }
  }
}

通过传递其他参数，您可以使用扩展语法：

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

参考样例 #

在以下示例中，您将使用包含以下文档的索引：

PUT testindex/_doc/1
{
  "title": "Let the wind rise"
}

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

}

PUT testindex/_doc/3
{
  "title": "Rise is gone"
}

运算符 #

如果对 text 字段运行 match 查询，文本将使用 analyzer 参数中指定的分词器进行分析。然后，将生成的词元组合为使用 operator 参数中指定的操作符构成的布尔查询。默认操作符是 OR ，因此查询 wind rise 被改为 wind OR rise 。在这个示例中，此查询返回文档 1–3，因为每个文档都有一个与查询匹配的词元。要指定 and 操作符，请使用以下查询：

GET testindex/_search
{
  "query": {
    "match": {
      "title": {
        "query": "wind rise",
        "operator": "and"
      }
    }
  }
}

查询构建为 wind AND rise ，并返回文档 1 作为匹配文档：

{
  "took": 17,
  "timed_out": false,
  "_shards": {
    "total": 1,
    "successful": 1,
    "skipped": 0,
    "failed": 0
  },
  "hits": {
    "total": {
      "value": 1,
      "relation": "eq"
    },
    "max_score": 1.2667098,
    "hits": [
      {
        "_index": "testindex",
        "_id": "1",
        "_score": 1.2667098,
        "_source": {
          "title": "Let the wind rise"
        }
      }
    ]
  }
}

最小匹配 #

您可以通过指定 minimum_should_match 参数来控制文档必须匹配的最小词数，才能在结果中返回

GET testindex/_search
{
  "query": {
    "match": {
      "title": {
        "query": "wind rise",
        "operator": "or",
        "minimum_should_match": 2
      }
    }
  }
}

现在文档需要同时匹配这两个词，因此只返回文档 1（这等同于 and 运算符）：

{
  "took": 23,
  "timed_out": false,
  "_shards": {
    "total": 1,
    "successful": 1,
    "skipped": 0,
    "failed": 0
  },
  "hits": {
    "total": {
      "value": 1,
      "relation": "eq"
    },
    "max_score": 1.2667098,
    "hits": [
      {
        "_index": "testindex",
        "_id": "1",
        "_score": 1.2667098,
        "_source": {
          "title": "Let the wind rise"
        }
      }
    ]
  }
}

分词器 #

因为在这个示例中你没有明确指定分词器，所以使用了默认的 standard 分词器。默认分词器不会执行词干提取，因此如果你运行查询 the wind rises ，由于词 rises 与词 rise 不匹配，你将不会收到任何结果。要更改搜索分词器，请在 analyzer 字段中指定它。例如，以下查询使用了 english 分词器：

GET testindex/_search
{
  "query": {
    "match": {
      "title": {
        "query": "the wind rises",
        "operator": "and",
        "analyzer": "english"
      }
    }
  }
}

english 分词器移除了停用词 the 并执行词干提取，生成了 wind 和 rise 这两个词元。后者匹配了文档 1，该文档出现在结果中：

{
  "took": 19,
  "timed_out": false,
  "_shards": {
    "total": 1,
    "successful": 1,
    "skipped": 0,
    "failed": 0
  },
  "hits": {
    "total": {
      "value": 1,
      "relation": "eq"
    },
    "max_score": 1.2667098,
    "hits": [
      {
        "_index": "testindex",
        "_id": "1",
        "_score": 1.2667098,
        "_source": {
          "title": "Let the wind rise"
        }
      }
    ]
  }
}

空查询 #

在某些情况下，分词器可能会从查询中移除所有标记。例如， english 分词器会移除停用词，所以在查询 and OR or 中，所有标记都会被移除。要检查分词器的行为，你可以使用分析 API：

GET testindex/_analyze
{
  "analyzer" : "english",
  "text" : "and OR or"
}

正如预期，该查询没有产生任何标记：

{
  "tokens": []
}

你可以通过 zero_terms_query 参数指定空查询的行为。将 zero_terms_query 设置为 all 会返回索引中的所有文档，而将其设置为 none 则不会返回任何文档：

GET testindex/_search
{
  "query": {
    "match": {
      "title": {
        "query": "and OR or",
        "analyzer" : "english",
        "zero_terms_query": "all"
      }
    }
  }
}

模糊性查询 #

为了考虑拼写错误，您可以在查询中指定 fuzziness 作为以下任一选项：

• 一个整数，指定允许的最大 Damerau-Levenshtein 距离。
• AUTO
  • 0-2 个字符的字符串必须完全匹配。
  • 3–5 个字符的字符串允许 1 次编辑。
  • 超过 5 个字符的字符串允许 2 次编辑。

将 fuzziness 设置为默认的 AUTO 值在大多数情况下效果最佳：

GET testindex/_search
{
  "query": {
    "match": {
      "title": {
        "query": "wnid",
        "fuzziness": "AUTO"
      }
    }
  }
}

token wnid 匹配 wind ，查询返回文档 1 和 2：

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

前缀长度 #

拼写错误很少出现在单词的开头。因此，您可以指定匹配前缀的最小长度，以便在结果中返回文档。例如，您可以将前面的查询更改为包含 prefix_length ：

GET testindex/_search
{
  "query": {
    "match": {
      "title": {
        "query": "wnid",
        "fuzziness": "AUTO",
        "prefix_length": 2
      }
    }
  }
}

前面的查询没有返回结果。如果你将 prefix_length 改为 1，则会返回文档 1 和 2，因为词 wnid 的首字母没有拼写错误。

移位错误 #

在前面这个例子中，词 wnid 包含一个移位错误（ in 被改为了 ni ）。默认情况下，模糊匹配允许移位错误，但你可以通过将 fuzzy_transpositions 设置为 false 来禁止它们：

GET testindex/_search
{
  "query": {
    "match": {
      "title": {
        "query": "wnid",
        "fuzziness": "AUTO",
        "fuzzy_transpositions": false
      }
    }
  }
}

现在查询没有返回结果。

同义词 #

如果你使用 synonym_graph 过滤器并且 auto_generate_synonyms_phrase_query 设置为 true （默认值），Easysearch 会将查询解析为词项，然后将这些词项组合起来生成一个短语查询以匹配多词同义词。例如，如果你指定 ba,batting average 作为同义词并搜索 ba ，Easysearch 会搜索 ba OR "batting average" 。

要使用连词匹配多词同义词，将 auto_generate_synonyms_phrase_query 设置为 false ：

GET /testindex/_search
{
  "query": {
    "match": {
      "text": {
        "query": "good ba",
        "auto_generate_synonyms_phrase_query": false
      }
    }
  }
}

生成的查询是 ba OR (batting AND average) 。

参数说明 #

该查询将字段名称（ <field> ）作为顶级参数接受：

GET _search
{
  "query": {
    "match": {
      "<field>": {
        "query": "text to search for",
        ...
      }
    }
  }
}

<field> 接受以下参数。除 query 外，所有参数都是可选的。