一、Restful简介
RESTFul：Representational State Transfer，中文意思：表现层状态转化。变现层指的是资源的表现层，这里的资源是指网络上的信息，比如一张图片，一段文本，一步电影，那么每个资源在网络上都有一个标识，可以理解为一个ID，每个资源都有一个ID去表示它，这个ID就称之为URL。当我们给了这个资源一个地址后，比如我们经常说的URL，我们就能访问这个资源。
表现层状态转化：
我们平时访问一个网站，其实就是客户端和服务端的一种互动过程，有了互动，这个数据的状态肯定会发生改变。Elasticsearch默认走的是http协议，而http协议它是一种无状态的协议，无状态就是指服务端它不会记录客户端的所有信息和操作，客户端必须每次带上自己的状态去请求服务器。因此，如果客户端想要操作这个服务器，必须通过某些手段，才能让服务器发生状态转化。而这种转化是建立在表现层之上的，所以说这就表现层的状态转化。
转化手段：
- GET:用来获取资源
- POST：用来创建资源(也可以用来更新资源)
- PUT：用来更新资源
- DELETE：用来删除资源
我们对ES的所有操作，都被封装成了RestAPI，所以我们只要发送请求就行了。
二、查看ES的基本信息
查看所有结点：
GET _cat/nodes
查看ES健康状况
GET _cat/health
- Green：主分片与副本都正常分配
- Yellow：主分片全部正常分配，有副本分片未能正常分配
- Red：有主分片未能分配
查看主节点：
GET _cat/master
查看所有索引(类似于show databases)
GET _cat/indices
三、索引操作
3.1 创建索引
创建并显示指定索引字段的类型
创建名为user的索引与对应映射信息。
PUT /user
{
"mappings": {
"properties": {
"name": {
"type": "text",
"fields": {
"keyword": {
"type": "keyword",
"ignore_above": 256
}
}
},
"address": {
"type": "text",
"fields": {
"keyword": {
"type": "keyword",
"ignore_above": 256
}
}
},
"remark": {
"type": "text",
"fields": {
"keyword": {
"type": "keyword"
}
}
},
"age": {
"type": "long"
},
"salary": {
"type": "double"
},
"birthDate": {
"type": "date",
"format": "yyyy-MM-dd"
}
}
}
}
3.2 创建文档映射
通过创建文档的方式自动映射字段的类型，当索引不存在的时候会自动创建并且字段类型自动根据值进行映射。
格式：PUT /索引名/类型名/文档id
以前的写法是：{index}/{type}/{id}，例如：user/_doc/1
现在的写法是：{index}/_doc/{id}，例如：user/_doc/1
由于在ES7中将type概念移除了，所以现在建议直接写成_doc，当然你硬要指定type类型也行，只是ES是给出一个警告：#! [types removal] Specifying types in document index requests is deprecated, use the typeless endpoints instead (/{index}/_doc/{id}, /{index}/_doc, or /{index}/_create/{id}).
PUT /user/_doc/1
{
"name":"小白学es",
"age":3
}
如果索引原本中没有的字段，这是也会自动加上并且映射类型，比如之前是没有sex字段的：
PUT /user/_doc/1
{
"name":"小白学es",
"age":18,
"sex":"男"
}
3.3 查看索引
GET /user
3.4 删除索引
DELETE /user
四、文档操作
4.1 增加文档信息
在索引 user 中增加一条文档信息。如果不指定ID，那么ES会自动生成ID
POST /user/_doc
{
"name": "张三",
"age": 29,
"salary": 100,
"address": "北京市",
"remark": "来自中国北京市的张先生",
"birthDate": "1990-01-10"
}
增加文档时指定ID：
POST /user/_doc/1
{
"name": "张三",
"age": 29,
"salary": 100,
"address": "北京市",
"remark": "来自中国北京市的张先生",
"birthDate": "1990-01-10"
}
4.2 更新文档信息
更新文档信息可以使用PUT和POST来请求，TODO 待确认？ PUT修改：全量字段更新，而POST 修改：指定字段更新(推荐使用)
使用PUT方式更新之前创建的 id=1 的文档信息。
PUT /user/_doc/1
{
"name": "李四"
}
可以发现这里只更新了name字段，没有更新其它的字段，所以其它字段默认会填充空值。
使用POST请求修改文档：
首先将没个字段的值都初始化
POST /user/_doc/1
{
"name": "张三",
"age": 29,
"salary": 100,
"address": "北京市",
"remark": "来自中国北京市的张先生",
"birthDate": "1990-01-10"
}
然后再用POST请求执行修改文档操作：
POST方式第一种更新：
POST /user/_update/1/
{
"doc": {
"name": "王五"
}
}
第一次结果：
"_version": 5,
"result": "updated"
第二次结果：
"_version": 5,
"result": "noop"
使用这种更新操作进行重复更新时，若数据与原先一致，则不进行任何操作。返回的结果是："result": "noop"，而不是"result" : "updated"
POST方式第二种更新：
POST /user/_doc/1
{
"name":"赵六"
}
第一次结果：
"_version": 6,
"result": "updated"
第二次结果：
"_version": 7,
"result": "updated"
使用第二种更新操作时(即不带_update)，无论是否重复更新，数据是否一致，都会进行更新，version版本相应增加。因此若使用PUT方式，结果也一致。
4.3 获取文档信息
获取 user的索引 id=1 的文档信息。
GET /user/_doc/1
[4.4]、删除文档信息
删除之前创建的 id=1 的文档信息。
DELETE /user/_doc/1
五、批量操作
有些情况下可以通过批量操作以减少网络请求。如：批量查询、批量插入数据等。
5.1 批量查询
POST user/_mget
{
"ids" : [ "1", "mT245YABxusAxYeD-gUz" ]
}
注：POST user/_doc/_mget 类型没写则重写默认的类型,即_doc,如果写了ES会给一个系统警告,不过不影响结果
在Elasticsearch中，支持批量的插入、修改、删除操作，都是通过_bulk的api完成的。
请求格式如下：
{ action: { metadata }}
{ request body }
{ action: { metadata }}
{ request body }
...
注意：请求格式不同寻常，必须按照这种指定格式，如果不小心换行了，那么不好意思，执行报错。
5.2 单条插入数据
POST user/_doc
{"name":"周八","address":"广东省广州市花都区","remark":"公司底层码农员工","age":32,"salary":5000,"birthDate":"1987-09-26"}
5.3 批量插入数据
POST _bulk
{"create":{"_index":"user","_id":2001}}
{"name":"刘一","address":"广东省广州市花都区","remark":"公司底层码农员工","age":30,"salary":3000,"birthDate":"1989-11-11"}
{"create":{"_index":"user","_id":2002}}
{"name":"陈二","address":"广东省广州市花都区","remark":"公司底层码农员工","age":27,"salary":7900,"birthDate":"1992-01-25"}
{"create":{"_index":"user","_id":2003}}
{"name":"张三","address":"广东省广州市花都区","remark":"公司底层码农员工","age":28,"salary":8800,"birthDate":"1991-10-05"}
{"create":{"_index":"user","_id":2004}}
{"name":"李四","address":"广东省广州市花都区","remark":"公司底层码农员工","age":26,"salary":9000,"birthDate":"1993-08-18"}
{"create":{"_index":"user","_id":2005}}
{"name":"王五","address":"广东省广州市花都区","remark":"公司底层码农员工","age":31,"salary":4800,"birthDate":"1988-07-20"}
如果必须指定不好去掉配置就好了。
5.4 批量删除
POST _bulk
{"delete":{"_index":"user","_id":2001}}
{"delete":{"_index":"user","_id":2002}}
{"delete":{"_index":"user","_id":2003}}
六、简单的查询数据
查询所有文档信息
GET /user/_search
根据关键字查询文档信息，注意：text类型可以根据字段分词搜索，keyword关键词不会处理分词器
GET /user/_search?q=name:张三
