ElasticSearch实践（三）Rest API简介

系统管理员 2022-04-08 08:52 252阅读 0赞

**REST API**

Elasticsearch提供了非常全面和强大的REST API，可以使用API与集群进行交互。 使用API可以做什么呢？

*  检查群集，节点和索引运行状况，状态和统计信息
 *  管理您的群集，节点和索引数据和元数据
 *  对索引执行CRUD（创建，读取，更新和删除）和搜索操作
 *  执行高级搜索操作，例如分页，排序，过滤，脚本编写，聚合等等

API命令可以在Kibana控制台中运行。

使用\_cat API查看集群的运行情况，可以在kibana控制使用命令查询，也可以通过rest服务查询。使用curl或者其他可以进行HTTP/REST调用的工具，或者在浏览器，都可以调用ElasticSearch的Rest API。

**集群****健康**

GET /_cat/health?v

[elasticsearch@legaoyun10514 elasticsearch-6.5.1]$ curl http://192.168.105.10:9200/_cat/health?v
    epoch      timestamp cluster       status node.total node.data shards pri relo init unassign pending_tasks max_task_wait_time active_shards_percent
    1544146216 01:30:16  elasticsearch green           1         1      0   0    0    0        0             0                  -                100.0%

可以看到名称为elasticsearch的集群，已经启动，且状态是green，集群的状态有：

green，集群状态良好，集群功能齐全

yellow，所有数据都可用，但某些副本尚未配备，集群功能几圈

red，某些数据不可用，集群只有部分功能

当集群状态为红色时，虽然elasticsearch还可以通过可用的分片提供服务，但是存在不可用分片，还是要尽快的修复它

从上面的响应中看到，可以看到elasticsearch有一个节点，有0个分片，因为还没有数据。请注意，目前使用的是默认的集群名称（elasticsearch），ElasticSearch默认使用单播网络发现同一台机器上的其他节点。可以随时在机器上启动多个节点，启动的节点会自动加入一个指定名称的集群。查看健康状态，就可以看到总节点数发生变化。

**集群节点列表**

GET /_cat/nodes?v

[elasticsearch@legaoyun10514 elasticsearch-6.5.1]$ curl http://192.168.105.10:9200/_cat/nodes?v
    ip             heap.percent ram.percent cpu load_1m load_5m load_15m node.role master name
    192.168.105.10           25          98   0    0.02    0.04     0.05 mdi       *      8h_m9Uy

`可以看到名称为8h_m9Uy，ip为192.168.105.10的节点，单独在集群中`

`查询索引列表`

GET /_cat/indices?v

[elasticsearch@legaoyun10514 elasticsearch-6.5.1]$ curl http://192.168.105.10:9200/_cat/indices?v
    health status index uuid pri rep docs.count docs.deleted store.size pri.store.size

`直接告诉我们现在集群中还没有索引`

`创建索引`

`创建名称为demand的索引，再次查询索引`

PUT /demand?pretty
    GET /_cat/indices?v

`第一个命令，使用PUT方式创建名称为demand的索引，后面接pretty是告诉ElasticSearch，如果有返回数据的话，打印格式化后的json。`

PUT  http://192.168.105.10:9200/demand?pretty

响应

{
        "acknowledged": true,
        "shards_acknowledged": true,
        "index": "demand"
    }

`第二个命令，在创建索引后，查看索引`

[root@legaoyun10514 package]#  curl http://192.168.105.10:9200/_cat/indices?v
    health status index  uuid                   pri rep docs.count docs.deleted store.size pri.store.size
    yellow open   demand BGcTxGxVRtaEZOnHSHfXWA   5   1          0            0      1.1kb          1.1kb

`从第二个命令的结果中可以看到，现在有一个名称为demand的索引，有5个主分片和1个副本，包含0个文档。索引健康状况是yellow，yellow表示某些副本尚未创建。 这个索引发生这种情况的原因是因为默认情况下Elasticsearch索引创建了一个副本。 但是由于我们目前只有一个节点在运行，因此在其他节点加入集群之前，无法成功的创建一个副本（用于HA）。 当其他节点的副本创建之后，此索引的运行状况将变为绿色。`

**索引和查询**

PUT /customer/_doc/1?pretty
    GET /customer/_doc/1?pretty
    GET /_cat/indices?v

第一个命令将文档插入demand索引，如下将一个id为1的“需求”数据索引到已经创建的索引demand中。

PUT http://192.168.105.10:9200/demand/_doc/1?pretty
    {
    "projectName" : "八达岭长城",
    "address":"北京市"
    }

响应

{
        "_index": "demand",
        "_type": "_doc",
        "_id": "1",
        "_version": 1,
        "result": "created",
        "_shards": {
            "total": 2,
            "successful": 1,
            "failed": 0
        },
        "_seq_no": 0,
        "_primary_term": 1
    }

这样一个“demand”文档就插入到demand索引中，并在在插入索引的时候需要指定文档的id为1。

其实，ElasticSearch在将文档插入到索引的时候，并不需要先显示的创建索引。在这个例子中，在插入文档时如果demand索引不存在，则会自动按照默认配置创建索引。

第二个命令，检索刚才插入到demand索引的文档

[root@legaoyun10514 package]# curl http://192.168.105.10:9200/demand/_doc/1?pretty
    {
      "_index" : "demand",
      "_type" : "_doc",
      "_id" : "1",
      "_version" : 1,
      "found" : true,
      "_source" : {
        "projectName" : "八达岭长城",
        "address" : "北京市"
      }
    }

没有任何异常，这样，我们就通过id1请求到了之前插入到demand索引的文档，且返回到了\_source字段中。

第三个命令，查询demand索引

发现索引demand已经有一个文档了

**删除索引**

DELETE /customer?pretty
    GET /_cat/indices?v

第一个命令，删除demand索引

DELETE http://192.168.105.10:9200/demand?pretty

响应

{
        "acknowledged": true
    }

第二个命令查看所有索引列表

[root@legaoyun10514 package]#  curl http://192.168.105.10:9200/_cat/indices?v
    health status index uuid pri rep docs.count docs.deleted store.size pri.store.size

索引已经删除

直接插入文档

PUT http://192.168.105.10:9200/demand/_doc/1?pretty
    {
    "projectName" : "八达岭长城",
    "address":"北京市"
    }

{
        "_index": "demand",
        "_type": "_doc",
        "_id": "100",
        "_version": 1,
        "result": "created",
        "_shards": {
            "total": 2,
            "successful": 1,
            "failed": 0
        },
        "_seq_no": 0,
        "_primary_term": 1
    }

查看所有索引列表

[root@legaoyun10514 package]#  curl http://192.168.105.10:9200/_cat/indices?v
    health status index  uuid                   pri rep docs.count docs.deleted store.size pri.store.size
    yellow open   demand MsrUocFNSfGdi0vCw5_PDw   5   1          1            0      4.9kb          4.9kb

索引已存在。

通过基本的API，先了解一下es吧^\_^