match query (匹配查询)
返回与提供的文本,数字,日期或布尔值匹配的文档。匹配之前对提供的文本进行分析。
匹配查询是用于执行全文搜索的标准查询,其中包括模糊匹配的选项。
Example Request( 请求示例)
GET /_search
{
"query": {
"match": {
"message": {
"query": "this is a test"
}
}
}
}
顶层参数match
<字段> (必填,对象)您要搜索的字段
参数域的含义:
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参数。
如果模糊参数不为0,则匹配查询默认使用top_terms_blended_freqs _ $ {max_expansions}的Fuzzy_rewrite方法。
lenient
可选,布尔值)如果为true,则将忽略基于格式的错误,例如为数字字段提供文本查询值。默认为false
operator
(可选,字符串)布尔型逻辑,用于解释查询值中的文本。有效值为
OR (Default)
例如,匈牙利的首都的查询值被解释为首都 OR OR OR匈牙利
AND
例如,匈牙利的首都的查询值被解释为首都 AND的AND
minimum_should_match
(可选,字符串)要返回的文档必须匹配的最小子句数。有关有效值和更多信息,请参见minimum_should_match参数
zero_terms_query
可选,字符串)指示在分析器删除所有标记(例如使用停止过滤器时)时是否不返回文档。有效值为
none (Default)
如果分析仪删除了所有令牌,则不会返回任何文档
all
返回所有文档,类似于match_all查询
Notes
short request example
您可以通过组合和查询参数来简化匹配查询语法。例如:
GET /_search
{
"query": {
"match": {
"message": "this is a test"
}
}
}
match query 是如何执行的
匹配查询的类型为布尔值。这意味着将对提供的文本进行分析,并且分析过程将从提供的文本中构造一个布尔查询。可以将operator参数设置为or或and来控制布尔子句(默认为or)。可以使用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 terms query
如果使用的分析器像停止过滤器一样删除查询中的所有令牌,则默认行为是根本不匹配任何文档。为了更改可以使用zero_terms_query选项,该选项不接受(默认),并且所有选项都与match_all查询相对应。
GET /_search
{
"query": {
"match": {
"message": {
"query": "to be or not to be",
"operator": "and",
"zero_terms_query": "all"
}
}
}
}