当前位置：首页 > news >正文

ES语法（一）概括

news 2026/2/10 12:09:27

一、语法

1、请求方式

Elasticsearch（ES）使用基于 JSON 的查询 DSL（领域特定语言）来与数据交互。

一个 ElasticSearch 请求和任何 HTTP 请求一样由若干相同的部件组成：

curl -X<VERB> '<PROTOCOL>://<HOST>:<PORT>/<PATH>?<QUERY_STRING>' -d '<BODY>'

被 < > 标记的部件	含义
VERB	适当的 HTTP 方法或谓词 : GET`、 `POST`、 `PUT`、 `HEAD 或者 `DELETE`。
PROTOCOL	http 或者 https`（如果你在 ElasticSearch 前面有一个 `https 代理）
HOST	ElasticSearch 集群中任意节点的主机名，或者用 localhost 代表本地机器上的节点。
PORT	运行 ElasticSearch HTTP 服务的端口号，默认是 9200 。
PATH	API 的终端路径（例如 _count 将返回集群中文档数量）。Path 可能包含多个组件，例如：_cluster/stats 和 _nodes/stats/jvm 。
QUERY_STRING	任意可选的查询字符串参数 (例如 pretty 将格式化地输出 JSON 返回值，使其更容易阅读)
BODY	一个 JSON 格式的请求体 (如果请求需要的话)

2、大小写敏感

es是大小写敏感的。

二、请求类型

1、GET请求

GET 请求通常用于查询操作；

它会通过 URL 参数传递请求数据，查询条件较简单时适用。

2、POST请求

POST 请求通常用于提交数据，如添加或更新文档；

也可用于执行复杂的查询：复杂查询或聚合（特别是当查询语句较大时，无法通过 URL 传递）

三、查询返回结果

执行命令：索引库名称/_search

空搜索的结果为：

{"took": 2,		# 该命令请求花费了多长时间，单位：毫秒。"timed_out": false,		# 搜索是否超时"_shards": {		# 搜索分片信息"total": 3,		# 搜索分片总数"successful": 3,		# 搜索成功的分片数量"skipped": 0,		# 没有搜索的分片，跳过的分片"failed": 0		# 搜索失败的分片数量},"hits": {		# 搜索结果集。需要的一切数据都是从hits中获取"total": 21798,		# 返回多少条数据"max_score": 1,		#返回结果中，最大的匹配度分值"hits": [		# 默认查询前十条数据，根据分值降序排序，这里为了节省地方，把默认查询的前十条数据删了9条，只剩下一条数据{"_index": "",		# 索引库名称"_type": "",		# 类型名称"_id": "",		# 该条数据的id"_score": 1,		# 关键字与该条数据的匹配度分值"_routing": "",		# routing参数是一个可选参数，默认使用文档的_id值，用于计算文档所属分片"_source": {		# 索引库中类型，返回结果字段，不指定的话，默认全部显示出来"id": 1,"orderNo": "","appId": "","componentAppId": "","settleNo": "","outSettleNo": "","settleAmount": 5,"orderAmount": 7,"settleStatus": 3,"paymentChannel": 1,"version": 2,"settleTime": ,"createTime": ,"updateTime": ,"promotionAccountId": "","invoiceStatus": 1,"promotionTypeValue": 0,"commissionRateFeeCentAmount": 0,"commissionChargeFeeCentAmount": 0,"promotionFeeCentAmount": 2,"developerPromotionFeeCentAmount": 0,"promotionType": ""}}]}
}

按照从上到下的顺序，一共四个返回值，took，timed_out，_shards，hits。

1、took

该命令请求花费了多长时间，单位：毫秒。

2、timed_out

搜索是否超时。

3、shards

搜索分片信息。

（1）total

搜索分片总数。

（2）successful

搜索成功的分片数量。

（3）skipped

没有搜索的分片，跳过的分片。

（4）failed

搜索失败的分片数量。

4、hits

搜索结果集，需要的一切数据都是从hits中获取。

（1）total

返回多少条数据。

（2）max_score

返回结果中，最大的匹配度分值。

（3）hits

默认查询前十条数据，根据分值降序排序。

（4）_index

索引库名称。

（5）_type

类型名称

（6）_id

该条数据的id。

（7）_score

关键字与该条数据的匹配度分值。

（8）_source

索引库中类型，返回结果字段，不指定的话，默认全部显示出来。

四、查询语法介绍

语法GET /索引/类型/_search 查询条件。

这个查询条件有两种写法，

1、URL 拼接

在GET的url中指定参数，这种方法比较简单。如

（1）查询所有

GET /索引名称/_search

（2）条件查询：

GET /es-test/_search?q=blog

（3）分页查询：

GET /es-test/_search?size=5&from=10

2、DSL（常用）

还有一种是ES查询表达式 (DSL) 检索，所有查询都以 JSON 格式表示，通常包含 query 或 filter 字段。在执行查询时，通常向特定的索引发起请求，使用 HTTP 方法（GET 或 POST）。JSON 的常用字段有：

（1）sort

封装排序

（2） _source

指定查询结果的字段，不指定则默认返回所有字段

GET /wtyy-test/user/_search
{"query":{"match_all":{}},"_source":["name","age"]
}

（3）query

封装查询条件

（4）分页条件

from、size

（5）highlight高亮

通常自己开发搜索引擎的时候，往往需要对搜索结果中的关键词高亮这种功能。注意，带条件查询高亮才生效，如无条件分页查询高亮是不生效的。

GET  wtyy-test/user/_search
{"query": {"match": {"address": "北京"}},"highlight": {"fields": {"address": {}}}
}

{"took": 61,"timed_out": false,"_shards": {"total": 5,"successful": 5,"failed": 0},"hits": {"total": 1,"max_score": 0.7787034,"hits": [{"_index": "wtyy-test","_type": "user","_id": "1","_score": 0.7787034,"_source": {"name": "王五1","age": 1,"address": "湖北","school": "测试学校"},"highlight": {"address": ["湖<em>北</em>"]}}]}
}

在返回体中有一个 highlight 字段，里面对 message 字段进行高亮处理: 关键词使用了  标签包围了。可以使用 css 修改对  标签的样式，以实现关键词高亮效果。

五、es的并发处理

使用的乐观锁在后面加上 version：

POST  /user/student/1?version=3
{"name":"zyk","age":0
}

只有version = 当前记录的version的时候才能修改成功。es 可以自动控制 vserion 通过，version_type指定，version_type=external 要求 version 大于当前的version ，version_type=internal 这个是默认值，必须等于当前的值 version_type=external_gte 大于等于当前的version version_type=force 已经废弃了不能用了，我也不知道以前什么意思，提升， Validation Failed: 1: version type [force] may no longer be used

POST  /user/student/1?version_type=external&version=505
{"name":"zyk","age":0
}

一、语法

1、请求方式

2、大小写敏感

二、请求类型

1、GET请求

2、POST请求

三、查询返回结果

1、took

2、timed_out

3、shards

（1）total

（2）successful

（3）skipped

（4）failed

4、hits

四、查询语法介绍

1、URL 拼接

2、DSL（常用）

（1）sort

（2） _source

（3）query

（4）分页条件

（5）highlight高亮

五、es的并发处理

相关文章：