与ES的交互方式

与es的交互方式采用http的请求方式,请求的格式如下:

curl -X<VERB> '<PROTOCOL>://<HOST>:<PORT>/<PATH>?<QUERY_STRING>' -d '<BODY>'
  • 是请求的方法,比如:GET、POST、DELETE、PUT等。
  • 协议:http或者https。
  • 主机地址。
  • 端口
  • API的路径。比如查看集群状态:/_cluster/stats
  • <QUERY_STRING>参数。比如:?pretty,打印出格式化以后的Json。
  • 请求的内容。比如:添加索引时的数据。

创建索引

es创建索引的请求方式如下:

PUT /<index>
  • 请求的方法用PUT
  • /后面直接跟索引的名称即可。
  • 索引的设置和字段都放在Body中。

比如我们创建一个名字叫组织机构的索引,这个索引只有两个字段,一个id,一个name。并且这个索引设置为2个分片,2个副本。

我们使用POSTMAN发送请求,如下:

http://192.168.73.130:9200/orgnization

请求的方法选择PUT。然后在请求体(Body)中,写上索引的字段名称,索引的分片数和副本数,如下:

{
    "settings":{
        "number_of_shards":2,
        "number_of_replicas":2
    },
    "mappings":{
        "properties":{
            "id":{
                "type":"long"
            },
            "name":{
                "type":"text"
            }
        }
    }
}

我们观察一下,请求体中分为两个部分:settingsmappings。在settings中,我们设置了分片数和副本数。

  • number_of_shards:分片的数量;
  • number_of_replicas:副本的数量;

mappings中,我们设置索引的字段,在这里,我们只设置了id和name,id的映射类型是long,name的映射类型是text。这些类型我们会在后续为大家介绍。

请求体写完后,我们点击发送,es返回的结果如下:

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

说明索引创建成功,索引的名字正是我们在请求中设置的orgnization

然后,我们通过elasticsearch-head插件观察一下刚才创建的索引,如图:

我们可以看到索引orgnization已经创建好了,它有2个分片,分别是0和1,并且每个分片都是两个副本。如果我们仔细观察这个图,可以看出node-130节点中的0分片,和node-132节点中的1分片,它们的边框是加粗的,这说明它们是主节点,而边框没有加粗的节点是从节点,也就是我们说的副本节点。

查看索引

如果我们要查看一个索引的设置,可以通过如下请求方式:

GET /<index>

在我们的例子中,查看orgnization索引的设置,我们在POSTMAN中发送如下的请求:

我们可以看到索引的具体设置,比如:mapping的设置,分片和副本的设置。这些和我们创建索引时候的设置是一样的。

修改索引

索引一旦创建,我们是无法修改里边的内容的,不如说修改索引字段的名称。但是我们是可以向索引中添加其他字段的,添加字段的方式如下:

PUT /<index>/_mapping

然后在我们的请求体中,写好新添加的字段。比如,在我们的例子当中,新添加一个type字段,它的类型我们定义为long,请求如下:

http://192.168.73.130:9200/orgnization/_mapping

请求类型要改为PUT,请求体如下:

{
  "properties": {
    "type": {
      "type": "long"
    }
  }
}

我们点击发送,返回的结果如图所示:

添加索引字段成功,我们再使用GET查看一下索引,如图:

我们可以成功的查询到新添加的索引字段了。

删除索引

如果我们要删除一个索引,请求方式如下:

DELETE /<index>

假如我们要删除刚才创建的orgnization索引,我们只要把请求的方法改成DELETE,然后访问我们索引就可以,

http://192.168.73.130:9200/orgnization

关闭索引

如果索引被关闭,那么关于这个索引的所有读写操作都会被阻断。索引的关闭也很简单,请求方式如下:

POST /<index>/_close

在我们的例子中,如果要关闭索引,降请求方法改成POST,然后发送如下请求:

http://192.168.73.130:9200/orgnization/_close

打开索引

与关闭索引相对应的是打开索引,请求方式如下:

POST /<index>/_open

在我们的例子中,如果要打开索引,降请求方法改成POST,然后发送如下请求:

http://192.168.73.130:9200/orgnization/_open

冻结索引

冻结索引和关闭索引类似,关闭索引是既不能读,也不能写。而冻结索引是可以读,但是不能写。冻结索引的请求方式如下:

POST /<index>/_freeze

对应我们的例子当中:

http://192.168.73.130:9200/orgnization/_freeze

解冻索引

与冻结索引对应的是解冻索引,方式如下:

POST /<index>/_unfreeze

对应我们的例子:

http://192.168.73.130:9200/orgnization/_unfreeze

版权声明:本文为boboooo原创文章,遵循 CC 4.0 BY-SA 版权协议,转载请附上原文出处链接和本声明。
本文链接:https://www.cnblogs.com/boboooo/p/12780638.html