1、_cat
GET /_cat/nodes:查看所有节点
请求 :
http://192.168.107.129:9200/_cat/nodes
响应 :
127.0.0.1 15 95 8 0.19 0.16 0.24 dilm * 32bb46713f1b
GET /_cat/health:查看 es 健康状况
请求 :
http://192.168.107.129:9200/_cat/nodes
响应 :
1672289253 04:47:33 elasticsearch green 1 1 3 3 0 0 0 0 - 100.0%
GET /_cat/master:查看主节点
请求 :
http://192.168.107.129:9200/_cat/master
响应 :
0UIKX1bRRBWnz03krbYtXw 127.0.0.1 127.0.0.1 32bb46713f1b
GET /_cat/indices:查看所有索引 (show databases)
请求 :
http://192.168.107.129:9200/_cat/masterhttp://192.168.107.129:9200/_cat/indiceshttp://192.168.107.129:9200/_cat/master
响应 :
green open .kibana_task_manager_1 zrlBv8ZPRrelVQk8Ha-4GQ 1 0 2 0 38.3kb 38.3kb
green open .apm-agent-configuration isnuogXsRt-nDUuNNoRp9A 1 0 0 0 283b 283b
green open .kibana_1 ITqnjQoXRse1VhpieOA6oQ 1 0 2 0 11.3kb 11.3kb
2、索引一个文档(保存)
发送put请求
保存一个数据,保存在哪个索引的哪个类型下,指定用哪个唯一标识
PUT customer/external/1;在 customer 索引下的 external 类型下保存 1 号数据为
PUT customer/external/1
请求:
http://192.168.107.129:9200/customer/external/1
jsion数据:
{ "name": "John Doe" }
响应
{ "_index": "customer",//在哪个索引下 "_type": "external",//在哪个type下 "_id": "1",//id "_version": 1,//版本 "result": "created",//结果新建 "_shards": {//分片 "total": 2, "successful": 1, "failed": 0 }, "_seq_no": 0, "_primary_term": 1 }
再一次这个发送请求
响应:
{ "_index": "customer", "_type": "external", "_id": "1 ", "_version": 2, "result": "updated", "_shards": { "total": 2, "successful": 1, "failed": 0 }, "_seq_no": 3, "_primary_term": 5 }
这个时候可以发现是更新操作。发送多次为更新
注意:再一次发送这个请求的时候如果发现出现的响如果为
{ "error": { "root_cause": [ { "type": "cluster_block_exception", "reason": "index [customer] blocked by: [FORBIDDEN/12/index read-only / allow delete (api)];" } ], "type": "cluster_block_exception", "reason": "index [customer] blocked by: [FORBIDDEN/12/index read-only / allow delete (api)];" }, "status": 403 }
这个错的意思呢,就是你的索引库为只读状态。
解决方法:
配置文件后加上这句:
cluster.routing.allocation.disk.threshold_enabled: false
执行完了之后需要重启ES。
接下来,我们把只读状态改了:
使用PUT提交:
http://127.0.0.1:9200/索引名称/_settings
{ "index.blocks.read_only_allow_delete": null }
或者将其指定为false。自己根据自己需要来。
发送post请求时
这个时候不带id时
响应
{ "_index": "customer", "_type": "external", "_id": "5SfpXIUB7T24Ga4R2BS6", "_version": 1, "result": "created", "_shards": { "total": 2, "successful": 1, "failed": 0 }, "_seq_no": 4, "_primary_term": 5 }
"_id": "5SfpXIUB7T24Ga4R2BS6":返回一个随机的id
再一次发送不带id的post请求
响应
{ "_index": "customer", "_type": "external", "_id": "5ifrXIUB7T24Ga4RnBSe", "_version": 1, "result": "created", "_shards": { "total": 2, "successful": 1, "failed": 0 }, "_seq_no": 5, "_primary_term": 5 }
我们可以发现这个时候也是新增,返回了一个随机的id
但是如果带了id发送post请求那么效果跟put请求的效果是一样的
总结
PUT 和 POST 都可以,
POST 新增。如果不指定 id,会自动生成 id。指定 id 就会修改这个数据,并新增版本号
PUT 可以新增可以修改。PUT 必须指定 id;由于 PUT 需要指定 id,我们一般都用来做修改 操作,不指定 id 会报错。
3、查询文档
GET customer/external/1
http://192.168.107.129:9200/customer/external/1
响应
{ "_index": "customer", //在哪个索引 "_type": "external", //在哪个类型 "_id": "1", //记录 id "_version": 2, //版本号 "_seq_no": 1, //并发控制字段,每次更新就会+1,用来做乐观锁 "_primary_term": 1, //同上,主分片重新分配,如重启,就会变化"found": true, "_source": { //真正的内容 "name": "John Doe" } }
更新携带 ?if_seq_no=0&if_primary_term=1
if_seq_no=0乐观锁的版本号,当不符合版本号的时候报409
{ "error": { "root_cause": [ { "type": "version_conflict_engine_exception", "reason": "[1]: version conflict, required seqNo [6], primary term [5]. current document has seqNo [7] and primary term [5]", "index_uuid": "Bdd3svLfS9ioGHqqBnxzdQ", "shard": "0", "index": "customer" } ], "type": "version_conflict_engine_exception", "reason": "[1]: version conflict, required seqNo [6], primary term [5]. current document has seqNo [7] and primary term [5]", "index_uuid": "Bdd3svLfS9ioGHqqBnxzdQ", "shard": "0", "index": "customer" }, "status": 409 }
4、更新文档
带_update或put更新的post请求
POST customer/external/1/_update
{
"doc":{
"name": "John123"
}
}
响应 :
{ "_index": "customer", "_type": "external", "_id": "1", "_version": 5, "result": "updated",//注意这个地方是updated的更新 "_shards": { "total": 2, "successful": 1, "failed": 0 }, "_seq_no": 8, "_primary_term": 5 }
json内容不变再一次发送响应:
{ "_index": "customer", "_type": "external", "_id": "1", "_version": 7, "result": "noop",//再一次发送的时候不是更新了 "_shards": { "total": 0, "successful": 0, "failed": 0 }, "_seq_no": 10, "_primary_term": 5 }
post带_update对比原来的数据,与原来的一样什么都不做version和sql_no也不会改变
不带_update或put更新的post请求
POST customer/external/1
{
"name": "John Doe2"
}
不会去比对信息
PUT customer/external/1
同理
总结
不同:POST 操作会对比源文档数据,如果相同不会有什么操作,文档 version 不增加
PUT 操作总会将数据重新保存并增加 version 版本;
带_update 对比元数据如果一样就不进行任何操作。
看场景;
对于大并发更新,不带 update;
对于大并发查询偶尔更新,带 update;对比更新,重新计算分配规则
更新同时增加属性
POST customer/external/1/_update
{
"doc": { "name": "Jane Doe", "age": 20 }
}
PUT 和 POST 不带_update 也可以
5、删除文档&索引
DELETE customer/external/1
响应:
{ "_index": "customer", "_type": "external", "_id": "1", "_version": 8, "result": "deleted", "_shards": { "total": 2, "successful": 1, "failed": 0 }, "_seq_no": 11, "_primary_term": 5 }
DELETE customer
响应 :
{ "acknowledged": true }
不存在删除类型type的玩意
6、bulk 批量 API
POST customer/external/_bulk
{"index":{"_id":"1"}}
{"name": "John Doe" }
{"index":{"_id":"2"}}
{"name": "Jane Doe" }
语法格式:
{ action: { metadata }}\n
{ request body }\n
{ action: { metadata }}\n
{ request body }\n
复杂的例子:
POST /_bulk
{ "delete": { "_index": "website", "_type": "blog", "_id": "123" }}
{ "create": { "_index": "website", "_type": "blog", "_id": "123" }}
{ "title": "My first blog post" }
{ "index": { "_index": "website", "_type": "blog" }}
{ "title": "My second blog post" }
{ "update": { "_index": "website", "_type": "blog", "_id": "123"} }
{ "doc" : {"title" : "My updated blog post"} }
响应
#! Deprecation: [types removal] Specifying types in bulk requests is deprecated.
{
"took" : 137,
"errors" : false,
"items" : [
{
"delete" : {
"_index" : "website",
"_type" : "blog",
"_id" : "123",
"_version" : 1,
"result" : "not_found",
"_shards" : {
"total" : 2,
"successful" : 1,
"failed" : 0
},
"_seq_no" : 0,
"_primary_term" : 1,
"status" : 404
}
},
{
"create" : {
"_index" : "website",
"_type" : "blog",
"_id" : "123",
"_version" : 2,
"result" : "created",
"_shards" : {
"total" : 2,
"successful" : 1,
"failed" : 0
},
"_seq_no" : 1,
"_primary_term" : 1,
"status" : 201
}
},
{
"index" : {
"_index" : "website",
"_type" : "blog",
"_id" : "5ycmXYUB7T24Ga4RRRSB",
"_version" : 1,
"result" : "created",
"_shards" : {
"total" : 2,
"successful" : 1,
"failed" : 0
},
"_seq_no" : 2,
"_primary_term" : 1,
"status" : 201
}
},
{
"update" : {
"_index" : "website",
"_type" : "blog",
"_id" : "123",
"_version" : 3,
"result" : "updated",
"_shards" : {
"total" : 2,
"successful" : 1,
"failed" : 0
},
"_seq_no" : 3,
"_primary_term" : 1,
"status" : 200
}
}
]
}