本文已收录至Github,推荐阅读 👉 Java随想录
微信公众号:Java随想录
本篇主要是介绍Elasticsearch中索引的基本操作API,即增删改查(CRUD)。
创建索引
PUT /my_index?pretty
?pretty
是一个可选参数,如果加上,Elasticsearch 将返回格式化(即缩进、换行等使结果更易读)过的 JSON。
输出示例:
{
"acknowledged" : true,
"shards_acknowledged" : true,
"index" : "my_index"
}
这个输出表示索引已成功创建。"acknowledged": true
表示请求已被接受,"shards_acknowledged": true
表示所有的分片都已经准备就绪,"index": "my_index"
是你刚才创建的索引名称。
删除索引
DELETE /my_index?pretty
假设 my_index
索引存在并已成功删除,则输出如下:
{
"acknowledged" : true
}
这个响应表示Elasticsearch已确认删除请求。
注意:该操作是不可逆的,一旦删除,所有存储在索引中的数据都将被永久移除,因此在执行此操作时务必谨慎
查询数据
请求:
GET /my_index/_search
{
"query": {
"match": {
"field_name": "my_value"
}
}
}
在此示例中,我们在名为 my_index
的索引上进行搜索,查找字段 field_name
中值为 my_value
的文档。
响应:
Elasticsearch返回的响应包括一系列关于查询的信息,例如查询所花费的时间、是否超时、命中的文档数等。同时,返回的结果也会包括所有匹配的文档。
{
"took": 30,
"timed_out": false,
"_shards": {
"total": 5,
"successful": 5,
"skipped": 0,
"failed": 0
},
"hits": {
"total": {
"value": 1,
"relation": "eq"
},
"max_score": 1.0,
"hits": [
{
"_index": "my_index",
"_type": "_doc",
"_id": "1",
"_score": 1.0,
"_source": {
"field_name": "my_value"
}
}
]
}
}
请注意,以上只是基本的示例,实际ES查询可能会复杂得多,包含过滤、聚合、排序等多种操作。
获取所有索引数据的信息
GET _cat/indices?v
示例输出:
health status index uuid pri rep docs.count docs.deleted store.size pri.store.size
green open .kibana_task_manager_1 C9SW_Y7cQ8-TJQGArKRcDA 1 0 2 0 31.8kb 31.8kb
yellow open my_index 7V75Rtf1QBCslQvWWPOS2A 1 1 0 0 283b 283b
green open .apm-agent-configuration en6N1awvRZSLySqh0yjleA 1 0 0 0 283b 283b
green open .kibana_1 9-gHntOQTCeM8RqViBAaog 1 0 8 1 19.1kb 19.1kb
返回的结果会包含以下列:
-
health
:索引的健康状态。它可以是"green"(一切正常),“yellow”(至少所有主分片都是可用的,但不是所有副本分片都可用)或者"red"(有主分片无法使用)。 -
status
:索引的状态。通常情况下,可能的值是"open"或"close"。 -
index
:索引的名称。 -
uuid
:代表索引的唯一标识符。 -
pri
:主分片的数量。 -
rep
:每个主分片的副本数。 -
docs.count
:存储在索引中的文档数量。 -
docs.deleted
:已删除但尚未完全从存储中移除的文档数量。 -
store.size
:索引当前占用的总物理存储空间。 -
pri.store.size
:主分片占用的物理存储空间。
查询指定文档id
GET /my_index/_doc/doc_id
返回如下:
{
"_index": "my_index",
"_type": "_doc",
"_id": "1",
"_version": 3,
"_seq_no": 2,
"_primary_term": 2,
"found": true,
"_source": {
"field1": "123",
"field2": "456"
}
}
这个命令会返回一个包含以下字段的 JSON 响应:
-
_index
:文档所在的索引。 -
_type
:文档的类型。在 7.x 版本中,这通常是_doc
。 -
_id
:文档的 ID。 -
_version
: 文档的版本号。每当文档更新时,此数字都会增加。 -
_seq_no
:序列号,每次对文档进行操作时此数字会增加。 -
_primary_term
: 主要期限数,主要用于处理并发控制。 -
found
:如果找到了文档,则此值为 true;否则,为 false。 -
_source
: 文档的原始内容。
如果没有找到与给定 ID 匹配的文档,Elasticsearch 会返回一个状态码为 404 的响应,并且 found
字段的值将为 false。
添加 & 更新数据
PUT /index/_doc/doc_id
{
JSON数据
}
//例如:PUT /my_index/_doc/1
//{
// "field1": "123",
// "field2": "456"
//}
PUT既可以用于添加数据,也可以用于更新数据,比如我想更新文档 1 的name字段为:小明,可以这么写:
PUT /my_index/_doc/1
{
"name": "小明"
}
注意:PUT既可以用于插入,也可以用于更新,所以PUT的更新是全量更新,而不是部分更新。也就是上面的语句执行之后,文档会被直接替换,只会有name字段,字段值为小明
如果我们只想部分更新文档中的字段,可以使用POST,示例如下:
POST /index/_update/1
{
"doc": {
"name": "小明"
}
}
这个命令只会更新文档中的 name 字段为小明。其他字段还是保留原样。
cat命令
cat命令在ES中会经常使用,下面介绍cat命令中常用的几个命令。
参数
cat命令组成形式是:GET /_cat/indices?format=json&pretty
, ?
之前是命令,之后是参数,多个参数用&
分隔。
参数有下:
//v 显示更加详细的信息
GET /_cat/master?v
//help 显示命令结果字段说明
GET /_cat/master?help
//h 显示命令结果想要展示的字段
GET /_cat/master?h=ip,node
GET /_cat/master?h=i*,node
//format 显示命令结果展示格式,支持格式类型:text json smile yaml cbor
GET /_cat/indices?format=json&pretty
//s 显示命令结果按照指定字段排序
GET _cat/indices?v&s=index:desc,docs.count:desc
常用命令
aliases :显示别名
GET /_cat/aliases
获取所有索引别名,如果想获得某个索引的别名可以使用:GET index/alias
。
allocation :显示每个节点的分片数和磁盘使用情况
GET /_cat/allocation
count :显示整个集群或者索引的文档个数
GET /_cat/count
GET /_cat/count/index
fielddata :显示每个节点字段所占的堆空间
GET /_cat/fielddata
GET /_cat/fielddata?fields=name,addr
health :显示集群是否健康
GET /_cat/health
indices :显示索引的情况
GET /_cat/indices
GET /_cat/indices/index
master: 显示master节点信息
GET /_cat/master
nodes :显示所有node节点信息
GET /_cat/nodes
recovery :显示索引恢复情况
当索引迁移的任何时候都可能会出现恢复情况,例如,快照恢复、复制更改、节点故障或节点启动期间。
GET /_cat/recovery
thread_pool :显示每个节点线程运行情况
GET /_cat/thread_pool
GET /_cat/thread_pool/bulk
GET /_cat/thread_pool/bulk?h=id,name,active,rejected,completed
shards :显示每个索引各个分片的情况
展示索引的各个分片,主副分片,文档个数,所属节点,占存储空间大小等信息。
GET /_cat/shards
GET /_cat/shards/index
GET _cat/shards?h=index,shard,prirep,state,unassigned.reason
分片的状态:INITIALIZING
初始化;STARTED
分配完成;UNASSIGNED
不能分配;可以通过unassigned.reason
属性查看不能分配的原因。
segments :显示每个segment的情况
包括属于索引,节点,主副,文档数等文章来源:https://www.toymoban.com/news/detail-782819.html
GET /_cat/segments
GET /_cat/segments/index
templates :显示每个template的情况文章来源地址https://www.toymoban.com/news/detail-782819.html
GET /_cat/templates
GET /_cat/templates/mytempla*
到了这里,关于一起学Elasticsearch系列-索引的CRUD的文章就介绍完了。如果您还想了解更多内容,请在右上角搜索TOY模板网以前的文章或继续浏览下面的相关文章,希望大家以后多多支持TOY模板网!