【Elasticsearch系列六】系统命令API

news2024/9/21 20:38:00

💝💝💝欢迎来到我的博客，很高兴能够在这里和您见面！希望您在这里可以感受到一份轻松愉快的氛围，不仅可以获得有趣的内容和知识，也可以畅所欲言、分享您的想法和见解。

推荐:kwan 的首页,持续学习,不断总结,共同进步,活到老学到老
导航
檀越剑指大厂系列:全面总结 java 核心技术,jvm,并发编程 redis,kafka,Spring,微服务等
常用开发工具系列:常用的开发工具,IDEA,Mac,Alfred,Git,typora 等
数据库系列:详细总结了常用数据库 mysql 技术点,以及工作中遇到的 mysql 问题等
新空间代码工作室:提供各种软件服务,承接各种毕业设计,毕业论文等
懒人运维系列:总结好用的命令,解放双手不香吗?能用一个命令完成绝不用两个操作
数据结构与算法系列:总结数据结构和算法,不同类型针对性训练,提升编程思维,剑指大厂

非常期待和您一起在这个小小的网络世界里共同探索、学习和成长。💝💝💝 ✨✨ 欢迎订阅本专栏 ✨✨

博客目录

- - 1.获取基本信息
  - 2.\_cluster 获取 health
  - 3.\_cat 获取 health
  - 4.命令区别
  - 5.查看索引
  - 6.主键 id

1.获取基本信息

用于获取 Elasticsearch 集群的根节点信息。这个请求通常用于检查 Elasticsearch 服务是否正常运行，以及获取一些基本的状态信息。

get /

名称：集群的名称。
集群 UUID：集群的唯一标识符。
版本：Elasticsearch 服务的版本号。
标签：集群的标签信息，如果有的话。
HTTP 地址：集群可以访问的 HTTP 地址列表。
构建：关于 Elasticsearch 构建的详细信息，包括构建哈希、构建日期等。

{
  "name": "node-1",
  "cluster_name": "my-application",
  "cluster_uuid": "gmjBLVYEQFO6ZR2bveXFig",
  "version": {
    "number": "7.12.0",
    "build_flavor": "default",
    "build_type": "tar",
    "build_hash": "78722783c38caa25a70982b5b042074cde5d3b3a",
    "build_date": "2021-03-18T06:17:15.410153305Z",
    "build_snapshot": false,
    "lucene_version": "8.8.0",
    "minimum_wire_compatibility_version": "6.8.0",
    "minimum_index_compatibility_version": "6.0.0-beta1"
  },
  "tagline": "You Know, for Search"
}

2._cluster 获取 health

GET /_cluster/health

解释：Status：集群状态。

Green 所有分片可用。
Yellow 所有主分片可用。
Red 主分片不可用，集群不可用。

{
  "cluster_name": "my-application",
  "status": "yellow",
  "timed_out": false,
  "number_of_nodes": 1,
  "number_of_data_nodes": 1,
  "active_primary_shards": 8,
  "active_shards": 8,
  "relocating_shards": 0,
  "initializing_shards": 0,
  "unassigned_shards": 1,
  "delayed_unassigned_shards": 0,
  "number_of_pending_tasks": 0,
  "number_of_in_flight_fetch": 0,
  "task_max_waiting_in_queue_millis": 0,
  "active_shards_percent_as_number": 88.88888888888889
}

3._cat 获取 health

GET /_cat/health?v

green:每个索引的 primary shard 和 replica shard 都是 active 状态的.
yellow:每个索引的 primary shard 都是 active 状态的，但是部分 replica shard 不是 active 状态，处于不可用的状态
red：不是所有索引的 primary shard 都是 active 状态的，部分索引有数据丢失了

4.命令区别

GET /_cluster/health 和 GET /_cat/health?v 区别

GET /_cluster/health 和 GET /_cat/health?v 都是用于获取 Elasticsearch 集群健康状态的 API，但它们有一些区别：

用途：
- _cluster/health：这是一个监控集群整体健康状态的 API，它可以提供集群级别的健康状态，包括索引的健康状态。它通常用于自动化脚本和应用程序中。
- _cat/health?v：这是一个用于人类阅读的 API，它提供了易于阅读的表格格式输出，通常用于命令行或 Kibana 控制台中快速检查集群状态。
输出格式：
- _cluster/health：返回 JSON 格式的数据，适合程序解析和自动化处理。
- _cat/health?v：返回纯文本格式的数据，包含列标题，更易于人类阅读。
功能：
- _cluster/health：除了提供集群健康状态，还可以等待直到集群达到期望的健康状态，并且可以指定返回分片级别的健康信息。
- _cat/health?v：提供了集群健康状态的快照，包括节点总数、数据节点数、分片数等信息，但不提供等待功能。
参数：
- _cluster/health：支持多个参数，如 wait_for_status、timeout、level 等，可以细化请求和控制返回的信息。
- _cat/health?v：参数较少，v 参数用于显示列标题，ts 参数用于控制是否显示时间戳。
适用场景：
- _cluster/health：适合用于应用程序和自动化脚本中，需要详细和程序可操作的数据。
- _cat/health?v：适合用于快速检查和监控集群状态，以及在命令行界面中进行故障排除。

5.查看索引

GET /_cat/indices?v

6.主键 id

手动 id

文档的 ID 被指定为 2。

当这个请求被发送到 Elasticsearch 服务器后，服务器会处理这个请求，将提供的 JSON 数据存储在指定的索引和文档 ID 下。如果索引 book 不存在，Elasticsearch 会根据默认设置创建它。如果文档 ID 2 已经存在，则该文档将被更新；如果不存在，将创建一个新的文档。

PUT /book/2
{
    "id":1,
    "title":"这是一11文章",
    "content":"xxxxx",
    "comment":"备注信息",
    "mobile":"13344556677"
}

自动 id

POST /book/
{
    "id":1,
    "title":"这是一11文章",
    "content":"xxxxx",
    "comment":"备注信息",
    "mobile":"13344556677"
}

自动id特点:长度为 20 个字符，URL 安全，base64 编码，GUID，分布式生成不冲突

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