https://elasticstack.blog.csdn.net/article/details/100555460
Elasticsearch使用Mustache模板引擎(参考http://mustache.github.io)来为查询模板生成可用的查询语句。如你所见,每个变量被双大括号包裹,这一点是Mustache规范要求的,是该模板引擎间接引用变量的方式。Mustache模板引擎的完整语法不在本书讨论范围内,不过我们可以在这里简单介绍一下它最具魅力的部分,包括条件表达式、循环和默认值。
使用模板好处:
Mustache语法的详细内容请参阅 http://mustache.github.io/mustache.5.html
{{val}}表达式用来插入变量val的值。{{#val}}和{{/val}}则用来在变量val取值计算为true时把位于它们之间的变量标记替换为变量值。
我们看一下下面这个示例:
curl -XGET http://10.8.10.12:9200/operator_website_index/_search/template?pretty -H 'Content-Type: application/json' -d '
{
"template":"{ {{#limit}}\"size\":2 {{/limit}} }",
"params":{
"limit": false
}
}'
当 limit
为 true
或者 有值时(随便赋值只有有内容) 条件则生效 size: 2
条件生效
当limit
为false
或者未设置limit
参数,条件size: 2
不生效
循环结构定义和条件表达式一模一样,都位于{{#val}}和{{/val}}之间。如果表达式中变量取值是数组,则可以使用{{.}}标记来指代当前变量值。
例如,假定我们需要模板引擎遍历一个词项数组来生成一个词项查询,可以执行如下命令:
curl -XGET http://10.8.10.12:9200/operator_website_index/_search/template?pretty -H 'Content-Type: application/json' -d '
{
"template":{
"query":{
"terms":{
"website_name":[
"{{#website_name_param}}",
"{{.}}",
"{{/website_name_param}}"
]
}
}
},
"params":{
"website_name_param":["fron","罗浮宫"]
}
}'
默认值标记允许我们在参数未定义时给它设置默认取值。比如,给var变量设置默认值语法的代码如下:
{{var}}{{^var}}default value{{/var}}
举个例子,假定我们要给查询模板中的website_name_param参数设置默认值“1”,可以使用如下命令:
curl -XGET http://10.8.10.12:9200/operator_website_index/_search/template?pretty -H 'Content-Type: application/json' -d '
{
"template":{
"query":{
"term":{
"website_name": "{{website_name_param}}{{^website_name_param}}1{{/website_name_param}}"
}
}
},
"params":{
"website_name_param": "罗浮宫"
}
}'
这个命令将从Elasticsearch查询出所有website_name
字段中包含罗浮宫的文档。而如果我们在params
片段中不指定phrase
参数的值,website_name_param
则使用默认1
来搜索。
创建template
curl -XPOST http://10.8.10.12:9200/_scripts/my_search_template -H 'Content-Type: application/json' -d '
{
"script": {
"lang": "mustache",
"source": {
"query": {
"match": {
"{{my_field}}": "{{my_value}}"
}
}
}
}
}'
在这里,我们定义了一个叫做my_search_template的search template。如果我们想更新这个search template,我们可以直接进行修改,然后再次运行上面的命令即可。
在match的字段里,我们定义了两个参数:my_field及my_value。下面,我们来首先建立一个叫做twitter的数据库:
curl -XPUT http://10.8.10.12:9200/twitter/_doc/1 -H 'Content-Type: application/json' -d '
{
"user" : "双榆树-张三",
"message" : "今儿天气不错啊,出去转转去",
"uid" : 2,
"age" : 20,
"city" : "北京",
"province" : "北京",
"country" : "中国",
"address" : "中国北京市海淀区",
"location" : {
"lat" : "39.970718",
"lon" : "116.325747"
}
}'
curl -XPUT http://10.8.10.12:9200/twitter/_doc/2 -H 'Content-Type: application/json' -d '
{
"user" : "虹桥-老吴",
"message" : "好友来了都今天我生日,好友来了,什么 birthday happy 就成!",
"uid" : 7,
"age" : 90,
"city" : "上海",
"province" : "上海",
"country" : "中国",
"address" : "中国上海市闵行区",
"location" : {
"lat" : "31.175927",
"lon" : "121.383328"
}
}'
我们这里把上面的两个文档存于到twitter的index之中。我们现在可以使用我们刚才定义的search template来进行搜索:
curl -XGET http://10.8.10.12:9200/twitter/_search/template -H 'Content-Type: application/json' -d '
{
"id": "my_search_template",
"params": {
"my_field": "city",
"my_value": "北京"
}
}'
返回结果
显示它只显示了我们的city为北京的一个文档,另外一个上海的文档没有做任何的显示。说明我们定义的search template是工作的。
{
"took" : 1,
"timed_out" : false,
"_shards" : {
"total" : 1,
"successful" : 1,
"skipped" : 0,
"failed" : 0
},
"hits" : {
"total" : {
"value" : 1,
"relation" : "eq"
},
"max_score" : 1.3862942,
"hits" : [
{
"_index" : "twitter",
"_type" : "_doc",
"_id" : "1",
"_score" : 1.3862942,
"_source" : {
"user" : "双榆树-张三",
"message" : "今儿天气不错啊,出去转转去",
"uid" : 2,
"age" : 20,
"city" : "北京",
"province" : "北京",
"country" : "中国",
"address" : "中国北京市海淀区",
"location" : {
"lat" : "39.970718",
"lon" : "116.325747"
}
}
}
]
}
}
创建template
curl -XPOST http://10.8.10.12:9200/_scripts/docs_from_beijing_and_age -H 'Content-Type: application/json' -d '
{
"script": {
"lang": "mustache",
"source": "{\"query\": {\"bool\": {\"must\": [{\"match\": {\"city\": \"{{search_term}}\"}}{{#search_age}},{\"range\": {\"age\": {\"gte\": {{search_age}}}}}{{/search_age}}]}}}"
}
}'
为方便查看我们将其格式化
POST _scripts/docs_from_beijing_and_age
{
"script": {
"lang": "mustache",
"source":
"""
{
"query": {
"bool": {
"must": [
{
"match": {
"city": "{{search_term}}"
}
}
{{#search_age}}
,
{
"range": {
"age": {
"gte": {{search_age}}
}
}
}
{{/search_age}}
]
}
}
}
"""
}
}
在这里,我们同时定义了两个变量:search_term及search_age。针对search_age,我们做了一个判断,如果它有定义,及做一个range的查询。如果没有定义,就只用search_term。我们来做如下的实验:
curl -XGET http://10.8.10.12:9200/twitter/_search/template -H 'Content-Type: application/json' -d '
{
"id": "docs_from_beijing_and_age",
"params": {
"search_term": "北京"
}
}'
返回结果
{
"took" : 0,
"timed_out" : false,
"_shards" : {
"total" : 1,
"successful" : 1,
"skipped" : 0,
"failed" : 0
},
"hits" : {
"total" : {
"value" : 1,
"relation" : "eq"
},
"max_score" : 1.3862942,
"hits" : [
{
"_index" : "twitter",
"_type" : "_doc",
"_id" : "1",
"_score" : 1.3862942,
"_source" : {
"user" : "双榆树-张三",
"message" : "今儿天气不错啊,出去转转去",
"uid" : 2,
"age" : 20,
"city" : "北京",
"province" : "北京",
"country" : "中国",
"address" : "中国北京市海淀区",
"location" : {
"lat" : "39.970718",
"lon" : "116.325747"
}
}
}
]
}
}
显然,city为北京的文档已经被搜索到了。如果我们做如下的查询:
curl -XGET http://10.8.10.12:9200/twitter/_search/template -H 'Content-Type: application/json' -d '
{
"id": "docs_from_beijing_and_age",
"params": {
"search_term": "北京",
"search_age": "30"
}
}
'
我们将搜索不到任何的结果,这是因为在这次查询中search_age已经被启用,而且在数据库中没有一个文档是来自“北京”,并且年龄大于30的。我们可以做如下的查询:
curl -XGET http://10.8.10.12:9200/twitter/_search/template?pretty -H 'Content-Type: application/json' -d '
{
"id": "docs_from_beijing_and_age",
"params": {
"search_term": "北京",
"search_age": "20"
}
}'
那么这次的显示结果为:
{
"took" : 2,
"timed_out" : false,
"_shards" : {
"total" : 1,
"successful" : 1,
"skipped" : 0,
"failed" : 0
},
"hits" : {
"total" : {
"value" : 1,
"relation" : "eq"
},
"max_score" : 2.3862944,
"hits" : [
{
"_index" : "twitter",
"_type" : "_doc",
"_id" : "1",
"_score" : 2.3862944,
"_source" : {
"user" : "双榆树-张三",
"message" : "今儿天气不错啊,出去转转去",
"uid" : 2,
"age" : 20,
"city" : "北京",
"province" : "北京",
"country" : "中国",
"address" : "中国北京市海淀区",
"location" : {
"lat" : "39.970718",
"lon" : "116.325747"
}
}
}
]
}
}
指定template进行查询template设置内容
curl -XGET http://10.8.10.12:9200/_scripts/
templateid
为我们设置的模板id
curl -XGET http://10.8.10.12:9200/_scripts/docs_from_beijing_and_age?pretty
{
"_id" : "docs_from_beijing_and_age",
"found" : true,
"script" : {
"lang" : "mustache",
"source" : "{\"query\": {\"bool\": {\"must\": [{\"match\": {\"city\": \"{{search_term}}\"}}{{#search_age}},{\"range\": {\"age\": {\"gte\": {{search_age}}}}}{{/search_age}}]}}}"
}
}
curl -XDELETE http://10.8.10.12:9200/_scripts/<templateid>
curl -XGET http://10.8.10.12:9200/_render/template?pretty -H 'Content-Type: application/json' -d '
{
"source": "{\"query\": {\"bool\": {\"must\": [{\"match\": {\"city\": \"{{search_term}}\"}}{{#search_age}},{\"range\": {\"age\": {\"gte\": {{search_age}}}}}{{/search_age}}]}}}"
,"params": {
"search_term": "北京",
"search_age": "20"
}
}'
返回结果为我们实际应用的查询条件
{
"template_output" : {
"query" : {
"bool" : {
"must" : [
{
"match" : {
"city" : "北京"
}
},
{
"range" : {
"age" : {
"gte" : 20
}
}
}
]
}
}
}
}
curl -XGET http://10.8.10.12:9200/_render/template/docs_from_beijing_and_age?pretty -H 'Content-Type: application/json' -d '
{
"params": {
"search_term": "北京",
"search_age": "20"
}
}'
返回结果为我们实际应用的查询条件
{
"template_output" : {
"query" : {
"bool" : {
"must" : [
{
"match" : {
"city" : "北京"
}
},
{
"range" : {
"age" : {
"gte" : 20
}
}
}
]
}
}
}
}