Skip to content

Commit

Permalink
fix region migration doc format (#459)
Browse files Browse the repository at this point in the history
  • Loading branch information
@liyuheng55555
liyuheng55555 authored Dec 13, 2024
1 parent b2c569a commit b9dcaf8
Show file tree
Hide file tree
Showing 4 changed files with 40 additions and 50 deletions.
10 changes: 3 additions & 7 deletions src/UserGuide/Master/Tree/User-Manual/Maintennance.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down Expand Up @@ -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
Expand Down
10 changes: 3 additions & 7 deletions src/UserGuide/latest/User-Manual/Maintennance.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down Expand Up @@ -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
Expand Down
35 changes: 17 additions & 18 deletions src/zh/UserGuide/Master/Tree/User-Manual/Maintennance.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -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)

### 注意事项

Expand Down Expand Up @@ -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 导致的乱序
Expand Down
35 changes: 17 additions & 18 deletions src/zh/UserGuide/latest/User-Manual/Maintennance.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -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)

### 注意事项

Expand Down Expand Up @@ -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 导致的乱序
Expand Down

0 comments on commit b9dcaf8

Please sign in to comment.