From b9dcaf88762770d2bd2c046ec22ccf8b16954218 Mon Sep 17 00:00:00 2001 From: Li Yu Heng Date: Fri, 13 Dec 2024 11:11:25 +0800 Subject: [PATCH] fix region migration doc format (#459) --- .../Master/Tree/User-Manual/Maintennance.md | 10 ++---- .../latest/User-Manual/Maintennance.md | 10 ++---- .../Master/Tree/User-Manual/Maintennance.md | 35 +++++++++---------- .../latest/User-Manual/Maintennance.md | 35 +++++++++---------- 4 files changed, 40 insertions(+), 50 deletions(-) diff --git a/src/UserGuide/Master/Tree/User-Manual/Maintennance.md b/src/UserGuide/Master/Tree/User-Manual/Maintennance.md index 54665e7f4..e09a51e2f 100644 --- a/src/UserGuide/Master/Tree/User-Manual/Maintennance.md +++ b/src/UserGuide/Master/Tree/User-Manual/Maintennance.md @@ -352,17 +352,13 @@ The Region migration feature has operating costs. It is recommended to read this ### Feature introduction -IoTDB is a distributed database. -The balanced distribution of data plays an important role in the load balance of disk space -and write pressure in the cluster. -Region is the basic unit for distributed storage of data in IoTDB cluster. -Specific concept can be seen in [region](../../Background-knowledge/Cluster-Concept.md). +IoTDB is a distributed database. The balanced distribution of data plays an important role in the load balance of disk space and write pressure in the cluster. Region is the basic unit for distributed storage of data in IoTDB cluster. Specific concept can be seen in [region](../Background-knowledge/Cluster-Concept.md). In cluster normal operation, IoTDB kernel will automatically load balance the data, but in the cluster new join DataNode node, DataNode where the machine hard disk damage needs to recover data and other scenarios, will involve the region of manual migration, in order to achieve more fine adjustment of the cluster load goal. Here is a schematic diagram of the region migration process : -![image-20241209174037655.png](https://alioss.timecho.com/docs/img/image-20241209174037655.png) +![](https://alioss.timecho.com/docs/img/region%E8%BF%81%E7%A7%BB%E7%A4%BA%E6%84%8F%E5%9B%BE20241210.png) ### Notes @@ -398,7 +394,7 @@ Here is a schematic diagram of the region migration process : - Stages: `Removing `, `Running `, `Running `. - Migration complete: `Running `, `Running `. - Taking the expansion phase as an example, the result of `show regions `may be: + Taking the expansion phase as an example, the result of `show regions` may be: ```Plain IoTDB> show regions diff --git a/src/UserGuide/latest/User-Manual/Maintennance.md b/src/UserGuide/latest/User-Manual/Maintennance.md index e8c525843..599011d74 100644 --- a/src/UserGuide/latest/User-Manual/Maintennance.md +++ b/src/UserGuide/latest/User-Manual/Maintennance.md @@ -352,17 +352,13 @@ The Region migration feature has operating costs. It is recommended to read this ### Feature introduction -IoTDB is a distributed database. -The balanced distribution of data plays an important role in the load balance of disk space -and write pressure in the cluster. -Region is the basic unit for distributed storage of data in IoTDB cluster. -Specific concept can be seen in [region](../../Background-knowledge/Cluster-Concept.md). +IoTDB is a distributed database. The balanced distribution of data plays an important role in the load balance of disk space and write pressure in the cluster. Region is the basic unit for distributed storage of data in IoTDB cluster. Specific concept can be seen in [region](../Background-knowledge/Cluster-Concept.md). In cluster normal operation, IoTDB kernel will automatically load balance the data, but in the cluster new join DataNode node, DataNode where the machine hard disk damage needs to recover data and other scenarios, will involve the region of manual migration, in order to achieve more fine adjustment of the cluster load goal. Here is a schematic diagram of the region migration process : -![image-20241209174037655.png](https://alioss.timecho.com/docs/img/image-20241209174037655.png) +![](https://alioss.timecho.com/docs/img/region%E8%BF%81%E7%A7%BB%E7%A4%BA%E6%84%8F%E5%9B%BE20241210.png) ### Notes @@ -398,7 +394,7 @@ Here is a schematic diagram of the region migration process : - Stages: `Removing `, `Running `, `Running `. - Migration complete: `Running `, `Running `. - Taking the expansion phase as an example, the result of `show regions `may be: + Taking the expansion phase as an example, the result of `show regions` may be: ```Plain IoTDB> show regions diff --git a/src/zh/UserGuide/Master/Tree/User-Manual/Maintennance.md b/src/zh/UserGuide/Master/Tree/User-Manual/Maintennance.md index 5598988e1..d01baa82e 100644 --- a/src/zh/UserGuide/Master/Tree/User-Manual/Maintennance.md +++ b/src/zh/UserGuide/Master/Tree/User-Manual/Maintennance.md @@ -333,15 +333,14 @@ region 迁移功能具有一定操作成本，建议完整阅读本节后再使 ### 功能介绍 -IoTDB 是一个分布式数据库，数据的均衡分布对集群的磁盘空间、写入压力的负载均衡有着重要作用，region 是数据在 IoTDB 集群中进行分布式存储的基本单元， -具体概念可见[region](../../Background-knowledge/Cluster-Concept.md)。 +IoTDB 是一个分布式数据库，数据的均衡分布对集群的磁盘空间、写入压力的负载均衡有着重要作用，region 是数据在 IoTDB 集群中进行分布式存储的基本单元，具体概念可见[region](../Background-knowledge/Cluster-Concept.md)。 集群正常运行情况下，IoTDB 内核将会自动对数据进行负载均衡，但在集群新加入 DataNode 节点、DataNode 所在机器硬盘损坏需要恢复数据等场景下，会涉及到对 region 的手动迁移，以达到更精细化的调整集群负载的目标。 下面是一次region迁移过程的示意图： -![image-20241209174037655.png](https://alioss.timecho.com/docs/img/image-20241209174037655.png) +![](https://alioss.timecho.com/docs/img/region%E8%BF%81%E7%A7%BB%E7%A4%BA%E6%84%8F%E5%9B%BE20241210.png) ### 注意事项 @@ -388,21 +387,21 @@ IoTDB 是一个分布式数据库，数据的均衡分布对集群的磁盘空 以扩容阶段为例，`show regions`的结果可能为： - ```Plain - IoTDB> show regions - +--------+------------+-------+--------+-------------+-----------+----------+----------+-------+---------------+--------+-----------------------+ - |RegionId| Type| Status|Database|SeriesSlotNum|TimeSlotNum|DataNodeId|RpcAddress|RpcPort|InternalAddress| Role| CreateTime| - +--------+------------+-------+--------+-------------+-----------+----------+----------+-------+---------------+--------+-----------------------+ - | 0|SchemaRegion|Running| root.ln| 1| 0| 1| 0.0.0.0| 6668| 127.0.0.1| Leader|2024-04-15T18:55:17.691| - | 0|SchemaRegion|Running| root.ln| 1| 0| 2| 0.0.0.0| 6668| 127.0.0.1| Leader|2024-04-15T18:55:17.691| - | 0|SchemaRegion|Running| root.ln| 1| 0| 3| 0.0.0.0| 6668| 127.0.0.1| Leader|2024-04-15T18:55:17.691| - | 1| DataRegion|Running| root.ln| 1| 1| 1| 0.0.0.0| 6667| 127.0.0.1| Leader|2024-04-15T18:55:19.457| - | 1| DataRegion|Running| root.ln| 1| 1| 2| 0.0.0.0| 6668| 127.0.0.1|Follower|2024-04-15T18:55:19.457| - | 1| DataRegion| Adding| root.ln| 1| 1| 3| 0.0.0.0| 6668| 127.0.0.1|Follower|2024-04-15T18:55:19.457| - +--------+------------+-------+--------+-------------+-----------+----------+----------+-------+---------------+--------+-----------------------+ - Total line number = 3 - It costs 0.003s - ``` + ```Plain + IoTDB> show regions + +--------+------------+-------+--------+-------------+-----------+----------+----------+-------+---------------+--------+-----------------------+ + |RegionId| Type| Status|Database|SeriesSlotNum|TimeSlotNum|DataNodeId|RpcAddress|RpcPort|InternalAddress| Role| CreateTime| + +--------+------------+-------+--------+-------------+-----------+----------+----------+-------+---------------+--------+-----------------------+ + | 0|SchemaRegion|Running| root.ln| 1| 0| 1| 0.0.0.0| 6668| 127.0.0.1| Leader|2024-04-15T18:55:17.691| + | 0|SchemaRegion|Running| root.ln| 1| 0| 2| 0.0.0.0| 6668| 127.0.0.1| Leader|2024-04-15T18:55:17.691| + | 0|SchemaRegion|Running| root.ln| 1| 0| 3| 0.0.0.0| 6668| 127.0.0.1| Leader|2024-04-15T18:55:17.691| + | 1| DataRegion|Running| root.ln| 1| 1| 1| 0.0.0.0| 6667| 127.0.0.1| Leader|2024-04-15T18:55:19.457| + | 1| DataRegion|Running| root.ln| 1| 1| 2| 0.0.0.0| 6668| 127.0.0.1|Follower|2024-04-15T18:55:19.457| + | 1| DataRegion| Adding| root.ln| 1| 1| 3| 0.0.0.0| 6668| 127.0.0.1|Follower|2024-04-15T18:55:19.457| + +--------+------------+-------+--------+-------------+-----------+----------+----------+-------+---------------+--------+-----------------------+ + Total line number = 3 + It costs 0.003s + ``` ## Start/Stop Repair Data 语句 用于修复由于系统 bug 导致的乱序 diff --git a/src/zh/UserGuide/latest/User-Manual/Maintennance.md b/src/zh/UserGuide/latest/User-Manual/Maintennance.md index 5598988e1..d01baa82e 100644 --- a/src/zh/UserGuide/latest/User-Manual/Maintennance.md +++ b/src/zh/UserGuide/latest/User-Manual/Maintennance.md @@ -333,15 +333,14 @@ region 迁移功能具有一定操作成本，建议完整阅读本节后再使 ### 功能介绍 -IoTDB 是一个分布式数据库，数据的均衡分布对集群的磁盘空间、写入压力的负载均衡有着重要作用，region 是数据在 IoTDB 集群中进行分布式存储的基本单元， -具体概念可见[region](../../Background-knowledge/Cluster-Concept.md)。 +IoTDB 是一个分布式数据库，数据的均衡分布对集群的磁盘空间、写入压力的负载均衡有着重要作用，region 是数据在 IoTDB 集群中进行分布式存储的基本单元，具体概念可见[region](../Background-knowledge/Cluster-Concept.md)。 集群正常运行情况下，IoTDB 内核将会自动对数据进行负载均衡，但在集群新加入 DataNode 节点、DataNode 所在机器硬盘损坏需要恢复数据等场景下，会涉及到对 region 的手动迁移，以达到更精细化的调整集群负载的目标。 下面是一次region迁移过程的示意图： -![image-20241209174037655.png](https://alioss.timecho.com/docs/img/image-20241209174037655.png) +![](https://alioss.timecho.com/docs/img/region%E8%BF%81%E7%A7%BB%E7%A4%BA%E6%84%8F%E5%9B%BE20241210.png) ### 注意事项 @@ -388,21 +387,21 @@ IoTDB 是一个分布式数据库，数据的均衡分布对集群的磁盘空 以扩容阶段为例，`show regions`的结果可能为： - ```Plain - IoTDB> show regions - +--------+------------+-------+--------+-------------+-----------+----------+----------+-------+---------------+--------+-----------------------+ - |RegionId| Type| Status|Database|SeriesSlotNum|TimeSlotNum|DataNodeId|RpcAddress|RpcPort|InternalAddress| Role| CreateTime| - +--------+------------+-------+--------+-------------+-----------+----------+----------+-------+---------------+--------+-----------------------+ - | 0|SchemaRegion|Running| root.ln| 1| 0| 1| 0.0.0.0| 6668| 127.0.0.1| Leader|2024-04-15T18:55:17.691| - | 0|SchemaRegion|Running| root.ln| 1| 0| 2| 0.0.0.0| 6668| 127.0.0.1| Leader|2024-04-15T18:55:17.691| - | 0|SchemaRegion|Running| root.ln| 1| 0| 3| 0.0.0.0| 6668| 127.0.0.1| Leader|2024-04-15T18:55:17.691| - | 1| DataRegion|Running| root.ln| 1| 1| 1| 0.0.0.0| 6667| 127.0.0.1| Leader|2024-04-15T18:55:19.457| - | 1| DataRegion|Running| root.ln| 1| 1| 2| 0.0.0.0| 6668| 127.0.0.1|Follower|2024-04-15T18:55:19.457| - | 1| DataRegion| Adding| root.ln| 1| 1| 3| 0.0.0.0| 6668| 127.0.0.1|Follower|2024-04-15T18:55:19.457| - +--------+------------+-------+--------+-------------+-----------+----------+----------+-------+---------------+--------+-----------------------+ - Total line number = 3 - It costs 0.003s - ``` + ```Plain + IoTDB> show regions + +--------+------------+-------+--------+-------------+-----------+----------+----------+-------+---------------+--------+-----------------------+ + |RegionId| Type| Status|Database|SeriesSlotNum|TimeSlotNum|DataNodeId|RpcAddress|RpcPort|InternalAddress| Role| CreateTime| + +--------+------------+-------+--------+-------------+-----------+----------+----------+-------+---------------+--------+-----------------------+ + | 0|SchemaRegion|Running| root.ln| 1| 0| 1| 0.0.0.0| 6668| 127.0.0.1| Leader|2024-04-15T18:55:17.691| + | 0|SchemaRegion|Running| root.ln| 1| 0| 2| 0.0.0.0| 6668| 127.0.0.1| Leader|2024-04-15T18:55:17.691| + | 0|SchemaRegion|Running| root.ln| 1| 0| 3| 0.0.0.0| 6668| 127.0.0.1| Leader|2024-04-15T18:55:17.691| + | 1| DataRegion|Running| root.ln| 1| 1| 1| 0.0.0.0| 6667| 127.0.0.1| Leader|2024-04-15T18:55:19.457| + | 1| DataRegion|Running| root.ln| 1| 1| 2| 0.0.0.0| 6668| 127.0.0.1|Follower|2024-04-15T18:55:19.457| + | 1| DataRegion| Adding| root.ln| 1| 1| 3| 0.0.0.0| 6668| 127.0.0.1|Follower|2024-04-15T18:55:19.457| + +--------+------------+-------+--------+-------------+-----------+----------+----------+-------+---------------+--------+-----------------------+ + Total line number = 3 + It costs 0.003s + ``` ## Start/Stop Repair Data 语句 用于修复由于系统 bug 导致的乱序