Elaticsearch REST API经常使用技巧

在Elasticsearch的REST API中，有不少使用技巧，这里针对官方文档给出的介绍，总结了几个经常使用的例子。

更多内容参考：Elastisearch文档总结

多索引

ES支持在一次请求中指定多个索引，能够使用通配符或者日期表达式的方式：

例如，foo*索引会匹配foo1，foo2，foo3等索引。_all则会匹配全部的索引。

同时也能够针对不可用的索引进行限制。

 

日期表达式支持以下的格式：

<static_name{date_math_expr{date_format|time_zone}}>

static_name是索引的静态部分

date_math_expr是日期表达式

后面跟着date_format是日期的格式；time_zone为时区

举个例子，若是想要查询logstash前两天的日期，能够写成：

curl -XGET 'localhost:9200/<logstash-{now/d-2d}>/_search' { "query" : { ... } }

再好比，当前的时间是2014年3月22日，那么：

<logstash-{now/d}> 会匹配 logstash-2024.03.22
<logstash-{now/M}> 会匹配 logstash-2024.03.01
<logstash-{now/M{YYYY.MM}}> 会匹配 logstash-2024.03
<logstash-{now/M-1M{YYYY.MM}}> 会匹配 logstash-2024.02
<logstash-{now/d{YYYY.MM.dd|+12:00}} 会匹配 logstash-2024.03.23

过去三天的索引能够表示为：

curl -XGET 'localhost:9200/<logstash-{now/d-2d}>,<logstash-{now/d-1d}>,<logstash-{now/d}>/_search' { "query" : { ... } }

过滤

全部的API均可以接受一个参数，filter_path，这个参数指定了过滤后的字段，返回的结果只会显示过滤指定的内容：

curl -XGET 'localhost:9200/_search?pretty&filter_path=took,hits.hits._id,hits.hits._score' { "took" : 3, "hits" : { "hits" : [ { "_id" : "3640", "_score" : 1.0 }, { "_id" : "3642", "_score" : 1.0 } ] } }

支持使用通配符，进行匹配

curl -XGET 'localhost:9200/_nodes/stats?filter_path=nodes.*.ho*' { "nodes" : { "lvJHed8uQQu4brS-SXKsNA" : { "host" : "portable" } } }

若是使用了两个**则会匹配全部的内容

curl 'localhost:9200/_segments?pretty&filter_path=indices.**.version' { "indices" : { "movies" : { "shards" : { "0" : [ { "segments" : { "_0" : { "version" : "5.2.0" } } } ], "2" : [ { "segments" : { "_0" : { "version" : "5.2.0" } } } ] } }, "books" : { "shards" : { "0" : [ { "segments" : { "_0" : { "version" : "5.2.0" } } } ] } } } }

若是要过滤_source，那么须要从新指定_source中的字段：

curl -XGET 'localhost:9200/_search?pretty&filter_path=hits.hits._source&_source=title' { "hits" : { "hits" : [ { "_source":{"title":"Book #2"} }, { "_source":{"title":"Book #1"} }, { "_source":{"title":"Book #3"} } ] } }

结果内容扁平化

使用flat_settings参数，它只会影响到返回的内容显示，例如设置为true后返回的内容是下面这种：

{ "persistent" : { }, "transient" : { "discovery.zen.minimum_master_nodes" : "1" } }

而设置为false，则为：

{ "persistent" : { }, "transient" : { "discovery" : { "zen" : { "minimum_master_nodes" : "1" } } } }

返回内容格式化

正常返回的数据，多是混杂在一行的，人的肉眼很难分别其中的信息，这时，能够再请求的末尾添加?pretty=true,或者?format-yaml设置成可读的形式。

pretty是以JSON的形式返回结果。直接写?pretty与?pretty=true做用同样

yaml则是使用横向缩进的方式展示结果。

返回结果可读

返回的结果设置为可读，对于咱们肉眼去观察结果也很重要，好比：

"exists_time": "1h"
"size": "1kb" 要比 "exists_time_in_millis": 3600000
"size_in_bytes": 1024 容易理解的多

参考

【1】YAML格式

【2】ElastICsearch APIs