新野企业网站建设网站系统使用手册
一、语法
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=102、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 字段进行高亮处理: 关键词使用了 <em></em> 标签包围了。可以使用 css 修改对 <em> 标签的样式，以实现关键词高亮效果。
五、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 这个是默认值 ，必须等于当前的值<br>version_type=external_gte 大于等于当前的version<br>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
}