标签：name doc 改查 ElasticSearch user 增删文档 POST id

一、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:张三

标签：name,doc,改查,ElasticSearch,user,增删,文档,POST,id
From： https://www.cnblogs.com/ciel717/p/17657104.html

ElasticSearch的常规增删改查操作