Elasticsearch——Rest API中的常用用法
本篇翻译的是Elasticsearch官方文档中的一些技巧,是使用Elasticsearch必不可少的必备知识,并且适用于所有的Rest Api。
返回数据格式化
当在Rest请求后面添加?pretty
时,结果会以Json格式化的方式显示。另外,如果添加?format=yaml
结果会以树的形式显示,默认都是Flase.
返回数据的易读性
结尾添加?human=true
,返回的数据会有很好的可读性,比如:
- time:3600 会显示为 time:1h
- size:1024 会显示为 1kb
常用的Date Math
在Elasticsearch中日期数学表达式是很常用的,在查询中经常会通过它来作为检索条件,比如range或者daterange。表达式通常会有下面几种操作:
- +1h ,表示加上一个一个小时
- -1d,表示减去一天
- /d,表示向一天取整
支持的单位也很多,比如
- y,代表一年
- M,代表一个月
- w,代表一周
- d,代表一天
- h,代表一个小时
- m,代表一分钟
- s,代表一秒钟
- ms,代表毫秒
举个例子:
- now+1h,表示当前时间加上一个小时,即一个小时后
- now+1h+1m,表示当前时间加上一个小时零一分钟,即一个小时一分钟后
- now+1h/d,表示当前时间加上一个小时,并向一天取整。
- 2015-01-01||+1M/d,2015-01-01加上一个月,并向一天取整
返回的内容过滤
有时候我们可能并不想返回所有的数据,因为这样会浪费一定的空间和时间,因此需要对查询返回的结果进行过滤。所有的API都接受一个参数——filter_path,这个参数支持逗号分隔,可以同时填写多个值。
例如,如果只想要返回查询的时间、事件的id和分值,可以像下面这样:
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"}}
}
使用**则会忽略最大长度的路径,与Spring MVC的Url匹配差不多。
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"}}} ]}}}
}
注意,elasticsearch一般会直接返回一条数据的原始信息,即_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"}
}
关于参数
在Elastcisearch的使用中,往往要接触到各种数据类型。如果某个字段设置了固定的类型,那么当执行查询或者索引时,一些数据会发生自动的类型转换。
Boolean
在Es中,false、no、0、off这些值都代表false,其他的值都是true.
Number
所有的API都支持以字符串的方式代表JSON中的数字类型。
Date
支持的类型上面都说过了...
Geo
Geo类型主要用于地图一类的数据,这里就先不介绍了。使用方法可以参考
模糊查询
有的时候一些需要允许一定的模糊度,比如检索hallo可以查询到hello,这就要支持模糊查询。模糊查询可以使用fuzziness参数,它有点像range:
-fuzziness <= fieldValue <= +fuzziness
并且可以设置一定的模糊度,比如:
- 0,1,2 设置它的编辑距离(levenshtein distance,wiki)
- AUTO,如果设置Auto,那么会根据字符串的长度而改变
比如,长度为:
0..2
,必须完全匹配3..5
,可以有一个编辑距离的模糊度>5
,可以有两个编辑距离的模糊度
返回结果——驼峰式
所有的API都接受一个case参数,如果设置为camelCase,那么所有的名称都会以驼峰式的形式返回。
查询的请求体
除了POST请求外,其他的请求时没有请求体的。这个时候如果要执行查询,可以把参数放在Url后面。
参考
1 官方文档
2 编辑距离,wiki百科
转载于:https://www.cnblogs.com/xing901022/p/5303740.html
Elasticsearch——Rest API中的常用用法相关推荐
- java api中最常用的五个包_java 5 个常用的api包
一.java.lang包下的API Java常用基础包,在开发中会自动导入到代码环境中,不需要import. 1.基本数据类型/包装类 (1)基本数据类型:byte.short.int.long.fl ...
- 在API 中,常用的code码
状态码 Label 解释 200 OK 请求成功接收并处理,一般响应中都会有 body 201 Created 请求已完成,并导致了一个或者多个资源被创建,最常用在 POST 创建资源的时候 202 ...
- python xlrd使用_Python中xlrd常用用法整理
1.背景 1.1 安装模板: 到python官网下载http://pypi.python.org/pypi/xlrd模块安装,前提是已经安装了python 环境. 在cmd命令行输入:pip inst ...
- java string中indexOf()常用用法
Java中字符串中子串的查找共有四种方法,如下: 1.int indexOf(String str) :返回第一次出现的指定子字符串在此字符串中的索引. 2.int indexOf(String st ...
- c++中string常用用法详解(+例子部分代码)
小白笔记 文章目录 前言 一.string 字符串赋值 二.string 字符串的拼接 三.string 查找和替换 四.string 字符串比较(挨个字符的ASCLL码来进行对比) 五.string ...
- Oracle FND - 用户API fnd_user_pkg的常用用法
一.创建用户 BEGINfnd_user_pkg.createuser(x_user_name => 'YUSUF',x_owner => fnd_user_pkg.null_char,x ...
- .network 中文文档_以太坊链下支付网络Raiden API中文文档
雷电网络(Raiden Network)是以太坊区块链的链下扩容方案,Raiden节点的Restful API官方文档中文版由汇智网提供,访问地址:http://cw.hubwiz.com/card/ ...
- C/C++常用宏定义,注意事项,宏中#和##的用法
总结下宏和函数的不同之处,以供大家写代码时使用,这段总结摘自<C和指针>一书. 当然宏定义非常重要的,它可以帮助我们防止出错,提高代码的可移植性和可读性等. 下面列举一些成熟软件中常用得宏 ...
- Python中的基本函数及其常用用法简析
分享Python中的基本函数及其常用用法简析,首先关于函数的解释函数是为了达到某种目的而采取的行为,函数是可重复使用的,用来实现某个单一功能或者功能片段的代码块,简单来说就是由一系列的程序语句组成的程 ...
最新文章
- 软件测试自动化的成功经验
- px,em,rem,vw单位在网页和移动端的应用
- apache lucene_Apache Lucene拼写检查器的“您是不是要”功能
- Flink入门看完这篇文章就够了
- 点集的视点特征直方图的评估
- Eclipse导入Android Project遇到的问题
- router-LInk传参与接受参数(记录)
- java jco sap 重连_SAP R3和JAVA交换数据之JCO
- vmware ubuntu 内存不够解决方案
- Windows Embedded Standard 7 快速入门指南 2 of 4
- SVN入门教程,超简单,30分钟学会!
- 刷脸支付的场景应用遍布大街小巷
- Fluent 操作入门实例-从建模到计算结果可视化
- linux下删除隐藏文件夹及子文件夹
- 别再用浏览器一句句翻译了,华为手机点击这个按钮,一键轻松翻译
- Linux 安装 VSCode 桌面快捷方式创建
- Mybatis重点知识 与SQLMapper大全
- 网页设计后PSD时代(Post-PSD Era)
- Synchronous operations are disallowed. Call ReadAsync or set AllowSynchronousIO to true instead.
- 恢复Iphone手机的数据