【Elasticsearch学习】DSL搜索大全（持续更新中）
1.复合查询
复合查询能够组合其他复合查询或者查询子句，同时也可以组合各个查询的查询结果及得分，也可以从Query查询转换为Filter过滤器查询。
首先介绍一下Query Context和 Filter Context
1）Query Context查询主要关注的是文档和查询条件的匹配度，Query查询会计算文档和查询条件的相关度评分。
2）Filter Context过滤器主要关注文档是否匹配查询条件，并不关系文档和查询条件的匹配程度，也不会计算文档的相关度评分。过滤器查询速度比普通查询快，经常使用的过滤器将被ES自动缓存。
GET /kibana_sample_data_ecommerce/_search
{
"query": { //query context
"bool": {
"must": [
{ "match": { "customer_first_name": "Eddie"}},
{ "match": { "customer_gender": "MALE" }}
],
"filter": [ // filter context
{ "term": { "currency": "EUR" }},
{ "range": { "order_id": { "gte": "584679" }}}
]
}
}
}
1.1.Boolean Query
Bool查询由一个或多个bool查询子句组成，允许组合任意数量的查询子句，bool查询共有4钟查询类型。
1）must
如果查询子句为must，那么must子句中的所有查询条件都必须在匹配文档中出现。
2）must_not
查询条件中的任何一部分不能在文档中出现。
3）should
查询条件可以在匹配文档中出现也可以不出现，但是出现的数量至少要达到minimum_should_match参数所设置的数量，如果组合中使用了must子句，该值默认为0，如果没有使用该值默认为1.
4）filter
查询条件必须出现在匹配的文档中，但是该查询子句对于文档的评分没有影响，仅对文档进行过滤。
http://127.0.0.1:9200/kibana_sample_data_ecommerce/_search
{
"query": {
"bool" : {
"must" : [
{
"term" : { "day_of_week": "Monday" }
},
{
"term" : {"customer_gender": "FEMALE"}
}
]
}
}
}
1.2Boosting Query
Boosting Query返回和positive查询条件匹配的文档，减少与negative查询条件匹配的文档的分数。注意，只有匹配了positive查询条件的文档才会被返回，negative只是降低同时匹配positive条件和negative查询条件的文档的相关性评分。negative_boost为介于0和1.0之间的浮点数，用于降低与negative查询条件匹配的文档相关性评分。
GET /kibana_sample_data_ecommerce/_search
{
"query": {
"boosting" : {
"positive" : {
"match": {
"customer_first_name" : "Eddie"
}
},
"negative" : {
"match" : {
"customer_last_name" : "Underwood"
}
},
"negative_boost" : 0.5
}
}
}
1.3Constant Score Query
包装filter查询，返回所有匹配的文档，但是文档的相关度评分等于查询传入的boost值，默认值为1.0。
GET /kibana_sample_data_ecommerce/_search
{
"query": {
"constant_score" : {
"filter" : {
"match" : { "customer_first_name" : "Eddie"}
},
"boost" : 1.2
}
}
}
1.4Disjunction Max Query
将与任何一个查询条件匹配的文档作为结果返回，但是采用单个字段上最匹配的评分作为最终评分返回。
首先看一个不使用dis_max查询多查询字段匹配的例子，
GET /test/_search { "query": { "bool": { "should": [ { "match": { "title": "Brown fox" }}, { "match": { "body": "Brown fox" }} ] } } }
返回：可以看到文档2的body字段更加匹配查询条件”body”: “Brown fox”，但是由于文档1的title字段和body字段都有”brown”所以其评分叠加起来比文档2的评分更高。
{
"hits" : {
"max_score" : 0.90425634,
"hits" : [
{
"_index" : "test",
"_type" : "_doc",
"_id" : "1",
"_score" : 0.90425634,
"_source" : {
"title" : "Quick brown rabbits",
"body" : "Brown rabbits are commonly seen."
}
},
{
"_index" : "test",
"_type" : "_doc",
"_id" : "2",
"_score" : 0.77041256,
"_source" : {
"title" : "Keeping pets healthy",
"body" : "My quick brown fox eats rabbits on a regular basis."
}
}
]
}
}
dis_max不会将查询条件各个字段评分做简单的相加，而是将与查询条件匹配得分最高的单个字段的评分作为文档的评分返回。如下例：
GET /test/_search { "query": { "dis_max": { "queries": [ { "match": { "title": "Brown fox" }}, { "match": { "body": "Brown fox" }} ] } } }
返回：可以看到使用dis_max后文档1的评分降低了。
{
"hits" : {
"max_score" : 0.77041256,
"hits" : [
{
"_index" : "test",
"_type" : "_doc",
"_id" : "2",
"_score" : 0.77041256,
"_source" : {
"title" : "Keeping pets healthy",
"body" : "My quick brown fox eats rabbits on a regular basis."
}
},
{
"_index" : "test",
"_type" : "_doc",
"_id" : "1",
"_score" : 0.6931471,
"_source" : {
"title" : "Quick brown rabbits",
"body" : "Brown rabbits are commonly seen."
}
}
]
}
}
dis_max查询的tie_breaker参数，如果在查询的时候根据查询场景需要考虑到其他查询字段的得分，则可以使用tie_breaker参数[0.0,1.0]，使用tie_beaker之后，计算得分的过程将变为：
1.取到与查询条件最匹配的单个字段的评分，2.将与其他查询条件匹配的得分乘以tie_beaker，3.将1中最高分和2中的得分相加作为文档的评分返回。
1.5Function Score Query
function score query可以在查询结束后，对每一个匹配的文档重新算分，根据新生成的分数进行排序。
GET /_search
{
"query": {
"function_score": {
"query": { "match_all": {} },
"boost": "5",
"functions": [
{
"filter": { "match": { "test": "bar" } },
"random_score": {},
"weight": 23
},
{
"filter": { "match": { "test": "cat" } },
"weight": 42
}
],
"max_boost": 42,
"score_mode": "max",
"boost_mode": "multiply",
"min_score" : 42
}
}
}
score_mode：每一个文档将会被定义的函数打分，当有多个函数时由score_mode决定如何去组合各个函数的打分，score_mode的几个方法：multiply，各个得分相乘；sum，分数相加；avg，分数取平均；first，用第一个有match filter的函数的评分；max，选取分数的最大值；min，选取分数的最小值。
weight：因为各个函数的打分范围不同，例如衰减函数打分范围为[0,1]，而field_value_factor的打分值是任意的，而且有时候希望不同的函数对文档的分数有不同的影响，用户可以使用weight权重来调整各个函数的得分，在每个function中定义weight的数值，函数计算出文档的得分后将会和其定义的weight值。
max_score：用于限制得分，function算出的新得分会被限制在max_boost内，默认为FLT_MAX。
boost_mode：决定function算出的分和query的得分如何组合：multiply，function和query得分相乘；replace，使用function的得分替换query的得分；sum，两者得分相加；avg，取两者均值；max，取两者较大值；min，取两者较小值。
min_score：用于排除分值低于阈值的文档。
function score支持的几种改变分值的函数：
1）script_score：包装一个子查询，通过自定义脚本的方式完全自定义计算文档的得分。
2）Weight：为每个文档设置一个权重，将文档的得分乘以该权重，该参数和boost类似，boost对文档得分的提升不是线性的，文档得分在乘以boost值后会被归一化（nomalize）处理，所以当不想将得分归一化处理时即可使用Weight来提升文档的得分。
3）random_score：随机均匀的产生在[0,1)之间的得分，可以为该函数提供种子(seed)和计算得分的字段(filed)，这样来保证分数的可复制性。最后的得分将基于seed、filed以及salt（salt由索引名和分片id计算得来），所以有相同的值但是存储在不同索引中的文档会有不同的评分。但是在同一个分片中并具有相同字段值的文档将获得相同的分数，因此通常需要使用具有唯一值的字段来进行评分。
4）field_value_factor：可以使用文档中的字段来影响文档的得分
参数：field，用来计算得分的字段；factor，得分的乘数；modifier，得分的计算公式，可以为none(默认值), log, log1p, log2p, ln, ln1p, ln2p, square, sqrt, reciprocal；missing，如果指定的filed字段文档中没有，默认使用的值。如下计算公式为：sqrt(1.2 * doc['likes'].value)
"query": {
"function_score": {
"field_value_factor": {
"field": "likes",
"factor": 1.2,
"modifier": "sqrt",
"missing": 1
}
}
}
5）Decay functions：衰减函数，用户指定一个文档中的字段的值，衰减函数根据距离这个值的距离来进行打分；查询时需要为每个字段定义origin值和scale值，
origin代表的是中心点，用以计算其他值到中心点的距离；
scale代表衰减的范围，衰减的范围为[origin-offset-scale，origin-offset]，[origin+offset，origin+offset+scale]
此外有两个可选值：offset、decay
offset表示衰减函数只计算到中心点距离大于offset的文档，即衰减函数计算的范围是[origin-offset-scale，origin-offset]，[origin+offset，origin+offset+scale]；
decay表示衰减到两个边界上时origin-offset-scale，origin+offset+scale文档的得分，默认为0.5分。如图：
举例说明各参数的作用：假设衰减函数的origin定义为100，scale定义为10，offset定义为10，decay为0.5，那么衰减函数只会计算文档[80，90]，[110，120]，即介于90与110之间的文档评分与origin得分一样，在[80，90]，[110，120]之间文档得分将会进行衰减，在80，120边界上的文档得分是decay：0.5。
如下例所示：DECAY_FUNCTION可以是linear（线性）、exp（指数）、gauss（高斯）这三种衰减函数，FILED_NAME即用来评分的字段必须为数值型、日期型或地理位置型。
"DECAY_FUNCTION": { "FIELD_NAME": { "origin": "11, 12", "scale": "2km", "offset": "0km", "decay": 0.33 } }
日期型衰减函数：
"function_score": { "gauss": { "date": { "origin": "2013-09-17", "scale": "10d", "offset": "5d", "decay" : 0.5 } } }
如果用于计算衰减的字段包含多个值，在默认情况下，将选择最接近原点的值来确定距离，可以通过设置multi_value_mode来改变这个方法：min：衰减距离使用多个字段距离中的最小值，max：衰减距离使用多个字段距离中的最大值，avg：衰减距离使用多个字段距离的平均值，sum衰减距离使用多个字段距离的和。
2.全文检索
全文检索使用户能够搜索分析过的文本，查询的关键字也会被文档索引时使用的分析器进行处理。
2.1Intervals Query
允许对匹配词项的顺序和邻近性进行细粒度控制。用户可以应用一个或多个规则集合在指定的字段上进行操作。
POST _search
{
"query": {
"intervals" : {
"my_text" : {
"all_of" : {
"ordered" : true,
"intervals" : [
{
"match" : {
"query" : "my favorite food",
"max_gaps" : 0,
"ordered" : true
}
},
{
"any_of" : {
"intervals" : [
{ "match" : { "query" : "hot water" } },
{ "match" : { "query" : "cold porridge" } }
]
}
}
]
}
}
}
}
}
interval查询顶层参数：
Field，用户希望查询的字段，上例为my_text。Field的参数为一个基于词项匹配度、顺序、接近度规则的对象用于匹配文档，上例为{“all_of”:”….”}。
有如下一些规则：
1）match：match规则匹配分析后的文本。参数：
query：希望在Field字段中匹配的内容。
max_gaps：匹配的词项之间间隔的最大词数，超过max_gaps的被视为不匹配，默认为-1，如果没有设定，则对词项之间的间隔没有限制；如果设置为0，那么匹配的词项之间必须仅仅相邻。
ordered：如果为true，那么匹配的词项出现的顺序必须和查询内容的顺序一致，默认为false。
analyzer：用于分析查询内容的分析器，默认和文档的分析器一致。
filter：intervals filter。
use_field：如果指定该字段，那么此规则将应用于该字段而不是顶层Field字段。
POST /test/_search { "query": { "intervals" : { "body" : { "match" : { "query" : "quick rabbits", "max_gaps" : 10 } } } } }
2）prefix：前缀规则匹配以指定字符集开头的词项，prefix最多可以扩展到匹配128个字符，如果超过128个字符，ES将返回错误。参数：
prefix：希望顶层Field开头的字符。
analyzer：用以处理prefix的分析器。
use_field：如果指定该字段，那么此规则将应用于该字段而不是顶层Field字段。
POST /test/_search { "query": { "intervals" : { "body" : { "prefix" : { "prefix" : "Keeping", "use_field":"title" } } } } }
3）wildcard：wildcard使用通配符模式，最多能匹配128个词项。参数：
pattern：通配符，支持*、？两种通配符。
analyzer：同上。
use_field：同上。
POST /test/_search { "query": { "intervals" : { "body" : { "wildcard" : { "pattern" : "rab?i*" } } } } }
4）fuzzy：模糊规则匹配与提供的term相似的词项。参数：
term：需要匹配的词项。
prefix_length：保持不变的前缀的数量。
transpositions：模糊规则是否包含两个相邻字符的转换，默认为true。
fuzziness：通常被解释为莱文斯坦距离也叫做Edit Distance，指的是一个词与另一个词匹配需要编辑的次数，编辑操作替换字符，插入字符，删除字符，需要编辑的次数越多，说明Edit Distance越大。fuzziness的参数：0，1，2表示最大的编辑次数，默认为AUTO参数，表示根据term的长度自动生成编辑次数。
analyzer：同上。
use_field：同上。
POST /test/_search { "query": { "intervals" : { "body" : { "fuzzy" : { "term" : "rabibst",//需要移动两次 "fuzziness":2 //两次edit } } } } }
5）all_of：综合其他的interval规则，返回的文档必须满足所有的intervals规则。参数：
intervals：要组合的规则数组。
max_gaps：
ordered：决定各个规则产生的结果是否排序。
filter：intervals filter。
POST /test/_search
{
"query": {
"intervals" : {
"body" : {
"all_of" : {
"intervals" : [//match、prefix规则均需满足
{
"match" : {
"query" : "quick"
}
},
{
"prefix" : {
"prefix":"My"
}
}
]
}
}
}
}
}
6）any_of：满足任一子规则的文档即可返回。
intervals：匹配的规则数组。
filter：intervals filter。
POST /test/_search
{
"query": {
"intervals" : {
"body" : {
"any_of" : {
"intervals" : [ //match、prefix规则满足其一即可
{
"match" : {
"query" : "commonly"
}
},
{
"prefix" : {
"prefix":"My"
}
}
]
}
}
}
}
}
intervals filter参数：
after：匹配的词项在filter rule后。
before：匹配的词项在filter rule前。
contained_by：匹配的词项由filter rule包含。
not_contained_by：匹配的词项不被filter rule包含。
not_containing：fiter rule不在匹配间隙之间出现。
not_overlapping：匹配的词项和filter rule不重叠。
overlapping：匹配的词项和filter rule有重叠。
script：决定文档是否返回的自定义脚本。
POST /test/_search
{
"query": {
"intervals" : {
"body" : {
"match" : {
"query" : "commonly",
"filter":{
"contained_by" : {
"match" : {
"query" : "Brown seen" //brown seen 必须包含commonly词项
}
}
}
}
}
}
}
}
POST /test/_search
{
"query": {
"intervals" : {
"body" : {
"match" : {
"query" : "brown rabbits",
"max_gaps" : 10,
"filter":{
"not_containing" : {
"match" : {
"query" : "fox" //fox 不能出现在brown rabbits 之间
}
}
}
}
}
}
}
}
POST /test/_search
{
"query": {
"intervals" : {
"body" : {
"match" : {
"query" : "commonly",
"filter":{
"overlapping" : {
"match" : {
"query" : "Brown seen" //match规则查出的结果文档为Brown rabbits are commonly seen 与commonly 有重叠的地方
}
}
}
}
}
}
}
}
2.2Match Query
返回与提供的搜索文本相匹配的文档，搜索文本在匹配之前会被分析器进行分析。
参数：
顶层参数：Filed,表示想要搜索的字段。
Field下的参数：
1.query：想要在Field字段中匹配到的内容，match查询在查询之前会对查询内容进行分析。
2.analyzer：分析器，如果field的mapping中有定义分析器，则使用field的分析器，如果没有，则使用索引默认的分析器。
3.auto_generate_synonyms_phrase_query：是否开启同义词匹配，默认为false。
4.fuzziness：模糊匹配，参数见interval query fuzzy。
5.max_expansions：控制模糊匹配fuzzy能扩展多少个模糊选项。如test在fuzziness为1的时候，能匹配很多模糊选项：tes，tets，etst等，使用max_expansions控制能匹配多少个模糊选项。
6.prefix_length：fuzzy匹配时，保持不变的字符前缀数，默认为0。
7.transpositions：如果true，那么fuzzy匹配允许字符交换位置，ab->ba。
8.fuzzy_rewrite：重写查询的方法，
9.lenient：如果true，则忽略查询格式错误，例如为数值字段提供文本查询值。默认为false。
10.operator：用于解析查询值的bool逻辑。默认为OR，如果Query值为quick brown fox，则匹配规则为quick or brown or fox；此外还有AND值。
11.minimum_should_match：返回的文档必须匹配的子句数量。
12.zero_terms_query：决定当分析器移除所有的分词时是否返回文档，如当查询内容中都是停用词时，所有的分词被分析器的停用词过滤器过滤掉时，是否返回文档。默认为none，不返回任何文档，all，返回所有文档。
测试数据： POST /test/_doc/3 { "title": "tets healthy", "body": "My quick brown fox eats rabbits on a regular basis." } POST /test/_doc/4 { "title": "tes healthy", "body": "My quick brown fox eats rabbits on a regular basis." }
测试案例：
POST /test/_search { "query": { "match" : { "title":{ "query":"test", "fuzziness":1, "max_expansions": 1 //最大扩展数，test只允许有一个模糊选项，匹配的结果只有一个 } } } }
2.3Match boolean prefix query
match_bool_prefix分析查询内容，并将分词出来的各个词项组合成为一个bool查询，除了最后一个词项其他的词项都会被用在term query中，最后一个词项被用在prefix query中。
例如：
POST /test/_search { "query": { "match_bool_prefix" : { "message" : "quick brown f" } } }
这个查询类似于：
POST /test/_search { "query": { "bool" : { "should": [ { "term": { "message": "quick" }}, { "term": { "message": "brown" }}, { "prefix": { "message": "f"}} ] } } }
参数：
顶层参数：Filed,表示想要搜索的字段。
1.query：想要在Field字段中匹配到的内容。
2.analyzer：分析器，默认使用字段mapping中的分析器。
3.minimum_should_match：返回的文档最少匹配查询条件的程度。
4.operator：使用AND还是OR去连接词项。
5.模糊查询可以用于所有的分词起器分析出的词项，除了最后一个词项。
POST /test/_search { "query": { "match_bool_prefix" : { "body": { "query": "fox eats", "operator":"AND", "fuzziness":1 } } } }
2.4Match phrase query
match_phrase查询分析搜索内容并创建一个短语查询。
match_phrase的词项之间的间隔为0，analyzer使用查询字段mapping字段定义，如果未定义则使用默认查询分析器。
GET /test/_search
{
"query": {
"match_phrase" : {
"body": {
"query": "quick brown fox",
"analyzer":"whitespace"
}
}
}
}
2.5Match phrase prefix query
返回包含搜索内容的文档，与搜索内容提供的顺序一致。搜索内容的最后一个词项作为前缀匹配任何以前缀开始的词项。
参数：
顶层参数：Filed,表示想要搜索的字段。
query：想要搜索的文本。
analyzer：分析器。
max_expansions：最后一个查询词作为前缀去匹配到的词项最多扩展数。
slop：分词之间的最大间隔数，默认为0。
zero_terms_query：见Match Query。
GET /test/_search { "query": { "match_phrase_prefix" : { "body" : { "query" : "quick brown f", "max_expansions": 2 //为2代表以f开头的词项只会返回两种 } } } }
2.6Multi match query
multi match query以match query为基础，构建多字段的match查询。
参数：
1.query：查询文本。
2.fields：查询字段，支持多个字段，最多查询字段数由indices.query.bool.max_clause_count定义，默认为1024个。
3.type：查询的类型。
best_fields：查找匹配任意field的文档，但是文档的得分来自最匹配的那个字段。
most_fields：组合所有字段的得分，作为文档的评分。
cross_fields：将多个字段组合成一个字段，在组合成的字段里去查询。
phrase：每个字段以match_phrase方式查询，使用最匹配字段的得分作为文档的评分。
phrase_prefix：每个字段以match_phrase_prefix方式查询，，使用最匹配字段的得分作为文档的评分。
bool_prefix：每个字段以match_bool_prefix方式查询，组合所有字段的得分作为文档的评分。
4.tie_breaker：当使用tie_breaker时，best_field会根据tie_breaker定义的值的大小，决定除最佳匹配字段得分以外其他字段的得分。为tie_breaker * （其他字段_score）之和。
5.其他参数：analyzer, boost, operator, minimum_should_match, fuzziness, lenient, prefix_length, max_expansions, rewrite, zero_terms_query, cutoff_frequency, auto_generate_synonyms_phrase_query and fuzzy_transpositions。
GET /test/_search { "explain": true, "query": { "multi_match" : { "query": "brown fox", "type": "best_fields", "fields": [ "title", "body" ] } } }
GET /_search { "query": { "multi_match" : { "query": "Will Smith", "type": "cross_fields", "fields": [ "first_name", "last_name" ], "operator": "and" } } }
这个查询类似与：
(+first_name:will +first_name:smith) | (+last_name:will +last_name:smith)
所有的搜索词项都必须在单独的字段（也可以是多个字段组合成的单个字段，如first_name+last_name）中出现。
2.6Common Terms Query
使用语法基于操作符如：AND OR来解析和分割查询字符串，然后用分析器对分割的部分就行分析，并与文档进行匹配。
参数：
1.query：查询字符串。
2.default_field：当query_string没有指定查询字段时候，默认查询的字段。默认值为索引设定的index.query.default_field值，index.query.default_field默认值为*。
3.allow_leading_wildcard：true的时候，通配符*，？可以被作为查询字符串的首个字符。默认为true。
4.analyze_wildcard：true的时候，查询会分析查询字符串中的通配符。
5.analyzer：用于分析查询字符串的分析器，默认为文档索引时候的分析器。
6.auto_generate_synonyms_phrase_query：true的时候，自动创建多同义词查询。
7.boost：浮点数用于增加或减少查询的相关度评分。
8.default_operator：如果没有定义operator，默认被用作解析查询字符串的操作符。OR（默认）
9.enable_position_increments：
10.fields：希望查询的字段的集合。
11.模糊匹配相关：fuzziness，fuzzy_max_expansions模糊匹配最大扩展数，fuzzy_prefix_length模糊匹配前缀数，fuzzy_transpositions，lenient。
12.max_determinized_states：确定一个查询需要的最大的自动机的数量。解释：https://www.jianshu.com/p/9edca9474663?utm_source=desktop&utm_medium=timeline
13.minimum_should_match：返回的文档最少匹配查询条件的程度。
14.quote_analyzer：用于分析在引号中的查询文本。
15.phrase_slop：匹配的两个分词之间间隔的最大词项数。
16.quote_field_suffix：附加到引号查询文本的后缀。
17.rewrite：用于重写查询的方法。
18.time_zone：时区，用于转换日期参数。
2.7Simple Query String
返回匹配查询字符串的文档，使用有限制的但是容错的语法去解析查询字符串。该查询使用简单的语法基于操作符去解析和分割查询字符串，在查询之前分别分析各个词项。因为对语法有更多的限制，索引当有不合规的语法时不会返回错误，忽略查询字符串中不合法的部分。
参数：
1.Query：搜索内容。
2.Fields：搜索的字段集合。
3.default_operator：如果没有定义operator，默认被用作解析查询字符串的操作符。OR（默认）
4.analyze_wildcard：true的时候，查询会分析查询字符串中的通配符。
5.analyzer：用于分析查询字符串的分析器，默认为文档索引时候的分析器。
6.auto_generate_synonyms_phrase_query：true的时候，自动创建多同义词查询。
7.flags：查询操作可以使用的操作符列表。合法操作符：AND、ESCAPE、FUZZY、NEAR、NONE、NOT、OR、PHRASE、PRECEDENCE、PREFIX、SLOP、WHITESPACE。
8.其他参数：fuzzy_max_expansions、fuzzy_prefix_length、fuzzy_transpositions、lenient、minimum_should_match、quote_field_suffix。