This is an automated email from the ASF dual-hosted git repository.
qiaojialin pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/iotdb-docs.git
The following commit(s) were added to refs/heads/main by this push:
new 1943b2c1 Operations statement - region migration and related
modifications (#511)
1943b2c1 is described below
commit 1943b2c1fa2bd33f6ba321cf75cf5094bf8930d2
Author: W1y1r <[email protected]>
AuthorDate: Sun Jan 12 22:02:22 2025 +0800
Operations statement - region migration and related modifications (#511)
---
src/.vuepress/sidebar/V1.3.3/en.ts | 10 +-
src/.vuepress/sidebar/V1.3.3/zh.ts | 10 +-
src/.vuepress/sidebar_timecho/V1.3.3/en.ts | 10 +-
src/.vuepress/sidebar_timecho/V1.3.3/zh.ts | 10 +-
src/.vuepress/sidebar_timecho/V2.0.1/zh-Tree.ts | 10 +-
.../Master/Tree/User-Manual/Data-Recovery.md | 47 ++++++++++
.../Master/Tree/User-Manual/Load-Balance.md | 95 +++++++++++++++++++
.../User-Manual/Query-Performance-Analysis.md} | 26 +-----
.../V2.0.1/Tree/User-Manual/Data-Recovery.md | 47 ++++++++++
.../V2.0.1/Tree/User-Manual/Load-Balance.md | 95 +++++++++++++++++++
.../User-Manual/Query-Performance-Analysis.md} | 91 +------------------
src/UserGuide/latest/User-Manual/Data-Recovery.md | 47 ++++++++++
src/UserGuide/latest/User-Manual/Load-Balance.md | 95 +++++++++++++++++++
.../User-Manual/Query-Performance-Analysis.md} | 91 +------------------
.../Master/Tree/User-Manual/Data-Recovery.md | 45 +++++++++
.../Master/Tree/User-Manual/Load-Balance.md | 101 +++++++++++++++++++++
.../User-Manual/Query-Performance-Analysis.md} | 24 +----
.../V2.0.1/Tree/User-Manual/Data-Recovery.md | 45 +++++++++
.../V2.0.1/Tree/User-Manual/Load-Balance.md | 101 +++++++++++++++++++++
.../User-Manual/Query-Performance-Analysis.md} | 100 +-------------------
.../UserGuide/latest/User-Manual/Data-Recovery.md | 45 +++++++++
.../UserGuide/latest/User-Manual/Load-Balance.md | 101 +++++++++++++++++++++
.../User-Manual/Query-Performance-Analysis.md} | 100 +-------------------
23 files changed, 915 insertions(+), 431 deletions(-)
diff --git a/src/.vuepress/sidebar/V1.3.3/en.ts
b/src/.vuepress/sidebar/V1.3.3/en.ts
index 9e290d78..cec4994e 100644
--- a/src/.vuepress/sidebar/V1.3.3/en.ts
+++ b/src/.vuepress/sidebar/V1.3.3/en.ts
@@ -116,7 +116,15 @@ export const enSidebar = {
{ text: 'Stream Processing', link: 'Streaming_apache' },
],
},
- { text: 'Maintenance SQL', link: 'Maintennance' },
+ {
+ text: 'Maintenance SQL',
+ collapsible: true,
+ children: [
+ { text: 'Query Performance Analysis', link:
'Query-Performance-Analysis' },
+ { text: 'Load Balance', link: 'Load-Balance' },
+ { text: 'Data Recovery', link: 'Data-Recovery' },
+ ],
+ },
],
},
{
diff --git a/src/.vuepress/sidebar/V1.3.3/zh.ts
b/src/.vuepress/sidebar/V1.3.3/zh.ts
index da90caf0..88140461 100644
--- a/src/.vuepress/sidebar/V1.3.3/zh.ts
+++ b/src/.vuepress/sidebar/V1.3.3/zh.ts
@@ -103,7 +103,15 @@ export const zhSidebar = {
{ text: '流处理框架', link: 'Streaming_apache' },
],
},
- { text: '运维语句', link: 'Maintennance' },
+ {
+ text: '运维语句',
+ collapsible: true,
+ children: [
+ { text: '查询性能分析', link: 'Query-Performance-Analysis' },
+ { text: '负载均衡', link: 'Load-Balance' },
+ { text: '数据修复', link: 'Data-Recovery' },
+ ],
+ },
],
},
{
diff --git a/src/.vuepress/sidebar_timecho/V1.3.3/en.ts
b/src/.vuepress/sidebar_timecho/V1.3.3/en.ts
index 0ecd001d..86a614df 100644
--- a/src/.vuepress/sidebar_timecho/V1.3.3/en.ts
+++ b/src/.vuepress/sidebar_timecho/V1.3.3/en.ts
@@ -131,7 +131,15 @@ export const enSidebar = {
{ text: 'Stream Processing', link: 'Streaming_timecho' },
],
},
- { text: 'Maintenance SQL', link: 'Maintennance' },
+ {
+ text: 'Maintenance SQL',
+ collapsible: true,
+ children: [
+ { text: 'Query Performance Analysis', link:
'Query-Performance-Analysis' },
+ { text: 'Load Balance', link: 'Load-Balance' },
+ { text: 'Data Recovery', link: 'Data-Recovery' },
+ ],
+ },
],
},
{
diff --git a/src/.vuepress/sidebar_timecho/V1.3.3/zh.ts
b/src/.vuepress/sidebar_timecho/V1.3.3/zh.ts
index 36cc4ef4..04a2c81e 100644
--- a/src/.vuepress/sidebar_timecho/V1.3.3/zh.ts
+++ b/src/.vuepress/sidebar_timecho/V1.3.3/zh.ts
@@ -114,7 +114,15 @@ export const zhSidebar = {
{ text: '流处理框架', link: 'Streaming_timecho' },
],
},
- { text: '运维语句', link: 'Maintennance' },
+ {
+ text: '运维语句',
+ collapsible: true,
+ children: [
+ { text: '查询性能分析', link: 'Query-Performance-Analysis' },
+ { text: '负载均衡', link: 'Load-Balance' },
+ { text: '数据修复', link: 'Data-Recovery' },
+ ],
+ },
],
},
{
diff --git a/src/.vuepress/sidebar_timecho/V2.0.1/zh-Tree.ts
b/src/.vuepress/sidebar_timecho/V2.0.1/zh-Tree.ts
index 137b24f5..49810f08 100644
--- a/src/.vuepress/sidebar_timecho/V2.0.1/zh-Tree.ts
+++ b/src/.vuepress/sidebar_timecho/V2.0.1/zh-Tree.ts
@@ -114,7 +114,15 @@ export const zhSidebar = {
{ text: '流处理框架', link: 'Streaming_timecho' },
],
},
- { text: '运维语句', link: 'Maintennance' },
+ {
+ text: '运维语句',
+ collapsible: true,
+ children: [
+ { text: '查询性能分析', link: 'Query-Performance-Analysis' },
+ { text: '负载均衡', link: 'Load-Balance' },
+ { text: '数据修复', link: 'Data-Recovery' },
+ ],
+ },
],
},
{
diff --git a/src/UserGuide/Master/Tree/User-Manual/Data-Recovery.md
b/src/UserGuide/Master/Tree/User-Manual/Data-Recovery.md
new file mode 100644
index 00000000..ab0cd6ea
--- /dev/null
+++ b/src/UserGuide/Master/Tree/User-Manual/Data-Recovery.md
@@ -0,0 +1,47 @@
+<!--
+
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+-->
+
+## Data Recovery
+
+Used to fix issues in data, such as data in sequential space not being
arranged in chronological order.
+
+### START REPAIR DATA
+
+Start a repair task to scan all files created before current time.
+The repair task will scan all tsfiles and repair some bad files.
+
+```sql
+IoTDB> START REPAIR DATA
+IoTDB> START REPAIR DATA ON LOCAL
+IoTDB> START REPAIR DATA ON CLUSTER
+```
+
+### STOP REPAIR DATA
+
+Stop the running repair task. To restart the stopped task.
+If there is a stopped repair task, it can be restart and recover the repair
progress by executing SQL `START REPAIR DATA`.
+
+```sql
+IoTDB> STOP REPAIR DATA
+IoTDB> STOP REPAIR DATA ON LOCAL
+IoTDB> STOP REPAIR DATA ON CLUSTER
+```
+
diff --git a/src/UserGuide/Master/Tree/User-Manual/Load-Balance.md
b/src/UserGuide/Master/Tree/User-Manual/Load-Balance.md
new file mode 100644
index 00000000..17cfe039
--- /dev/null
+++ b/src/UserGuide/Master/Tree/User-Manual/Load-Balance.md
@@ -0,0 +1,95 @@
+<!--
+
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+-->
+
+## Load Balance
+
+Region migration belongs to advanced operations and maintenance functions,
which have certain operational costs. It is recommended to read the entire
document before using this function. If you have any questions about the
solution design, please contact the IoTDB team for technical support.
+
+
+### Feature introduction
+
+IoTDB is a distributed database, and the balanced distribution of data plays
an important role in load balancing the disk space and write pressure of the
cluster. Region is the basic unit for distributed storage of data in IoTDB
cluster, and the specific concept can be seen in
[region](../Background-knowledge/Cluster-Concept.md)。
+
+Under normal operation of the cluster, IoTDB will automatically perform load
balancing on data. However, in scenarios where a new DataNode node is added to
the cluster or where the hard disk of the machine where the DataNode is located
is damaged and data needs to be recovered, manual region migration can be used
to finely adjust the cluster load and operations.
+
+Here is a schematic diagram of the region migration process :
+
+
+
+
+### Notes
+
+1. It is recommended to only use the Region Migration feature on IoTDB 1.3.3
and higher versions.
+2. Region migration is only supported when the consensus protocol is IoTConsus
or Ratis (in iotdb system. properties, the
`schema_region_consensus_protocol_class`
and`data_region_consensus_protocol_class`).
+3. Region migration will occupy system resources such as hard drives and
network bandwidth, and it is recommended to perform it during low business
loads.
+4. The region migration process will occupy WAL files, blocking the deletion
of WAL files in this consensus group. If the total number of WAL files reaches
`wal_file_size_threshold_in_byte`, writing will be blocked.
+
+### Instructions for use
+
+- **Grammar definition** :
+
+ Submit an asynchronous task to migrate a region from one DataNode to another.
+
+
+ ```SQL
+ migrateRegion
+ : MIGRATE REGION regionId=INTEGER_LITERAL FROM fromId=INTEGER_LITERAL
TO toId=INTEGER_LITERAL
+ ;
+ ```
+
+- **Example** :
+
+ Migrating region 1 from DataNode 2 to DataNode 3:
+
+ ```SQL
+ IoTDB> migrate region 1 from 2 to 3
+ Msg: The statement is executed successfully.
+ ```
+
+ "The statement is executed successfully" only represents the successful
submission of the region migration task, not the completion of execution. The
execution status of the task can be viewed through the CLI command `show
regions `.
+- **Related configuration** :
+ - Migration speed control : modify `iotdb-system.properties `parameters
`region_migration_speed_limit_bytes_per_second `control region migration speed.
+- **Time cost estimation** :
+ - If there are no concurrent writes during the migration process, the time
consumption can be simply estimated by dividing the region data volume by the
data transfer speed. For example, for a 1TB region, the hard disk internet
bandwidth and speed limit parameters jointly determine that the data transfer
speed is 100MB/s, so it takes about 3 hours to complete the migration.
+ - If there are concurrent writes in the migration process, the time
consumption will increase, and the specific time consumption depends on various
factors such as write pressure and system resources. It can be simply estimated
as `no concurrent write time × 1.5 `.
+- **Migration progress observation** : During the migration process, the state
changes can be observed through the CLI command `show regions `. Taking the 2
replicas as an example, the state of the consensus group where the region is
located will go through the following process:
+ - Before migration starts: `Running `, `Running `.
+ - Expansion phase: `Running `, `Running `, `Adding `. Due to the large
number of file transfers involved, it may take a long time. If using
IoTConsensus, the specific file transfer progress can be searched in the
DataNode log `[SNAPSHOT TRANSMISSION] `.
+ - Stages: `Removing `, `Running `, `Running `.
+ - Migration complete: `Running `, `Running `.
+
+ Taking the expansion phase as an example, the result of `show regions` may
be:
+
+ ```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
+ ```
diff --git a/src/UserGuide/V2.0.1/Tree/User-Manual/Maintennance.md
b/src/UserGuide/Master/Tree/User-Manual/Query-Performance-Analysis.md
similarity index 97%
rename from src/UserGuide/V2.0.1/Tree/User-Manual/Maintennance.md
rename to src/UserGuide/Master/Tree/User-Manual/Query-Performance-Analysis.md
index 4f2e88b1..b31342ca 100644
--- a/src/UserGuide/V2.0.1/Tree/User-Manual/Maintennance.md
+++ b/src/UserGuide/Master/Tree/User-Manual/Query-Performance-Analysis.md
@@ -22,7 +22,7 @@
# Maintennance
-## Explain/Explain Analyze Statements
+## Query Performance Analysis
The purpose of query analysis is to assist users in understanding the
execution mechanism and performance bottlenecks of queries, thereby
facilitating query optimization and performance enhancement. This is crucial
not only for the efficiency of query execution but also for the user experience
of applications and the efficient utilization of resources. For effective query
analysis, IoTDB versions V1.3.2 and above offer the query analysis statements:
Explain and Explain Analyze.
@@ -346,27 +346,3 @@ Observing the results, we found that it is because the
query did not add a time
The final optimization plan is: Add a time filtering condition to avoid a full
table scan.
-
-## Start/Stop Repair Data Statements
-Used to repair the unsorted data generate by system bug.
-### START REPAIR DATA
-
-Start a repair task to scan all files created before current time.
-The repair task will scan all tsfiles and repair some bad files.
-
-```sql
-IoTDB> START REPAIR DATA
-IoTDB> START REPAIR DATA ON LOCAL
-IoTDB> START REPAIR DATA ON CLUSTER
-```
-
-### STOP REPAIR DATA
-
-Stop the running repair task. To restart the stopped task.
-If there is a stopped repair task, it can be restart and recover the repair
progress by executing SQL `START REPAIR DATA`.
-
-```sql
-IoTDB> STOP REPAIR DATA
-IoTDB> STOP REPAIR DATA ON LOCAL
-IoTDB> STOP REPAIR DATA ON CLUSTER
-```
diff --git a/src/UserGuide/V2.0.1/Tree/User-Manual/Data-Recovery.md
b/src/UserGuide/V2.0.1/Tree/User-Manual/Data-Recovery.md
new file mode 100644
index 00000000..ab0cd6ea
--- /dev/null
+++ b/src/UserGuide/V2.0.1/Tree/User-Manual/Data-Recovery.md
@@ -0,0 +1,47 @@
+<!--
+
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+-->
+
+## Data Recovery
+
+Used to fix issues in data, such as data in sequential space not being
arranged in chronological order.
+
+### START REPAIR DATA
+
+Start a repair task to scan all files created before current time.
+The repair task will scan all tsfiles and repair some bad files.
+
+```sql
+IoTDB> START REPAIR DATA
+IoTDB> START REPAIR DATA ON LOCAL
+IoTDB> START REPAIR DATA ON CLUSTER
+```
+
+### STOP REPAIR DATA
+
+Stop the running repair task. To restart the stopped task.
+If there is a stopped repair task, it can be restart and recover the repair
progress by executing SQL `START REPAIR DATA`.
+
+```sql
+IoTDB> STOP REPAIR DATA
+IoTDB> STOP REPAIR DATA ON LOCAL
+IoTDB> STOP REPAIR DATA ON CLUSTER
+```
+
diff --git a/src/UserGuide/V2.0.1/Tree/User-Manual/Load-Balance.md
b/src/UserGuide/V2.0.1/Tree/User-Manual/Load-Balance.md
new file mode 100644
index 00000000..17cfe039
--- /dev/null
+++ b/src/UserGuide/V2.0.1/Tree/User-Manual/Load-Balance.md
@@ -0,0 +1,95 @@
+<!--
+
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+-->
+
+## Load Balance
+
+Region migration belongs to advanced operations and maintenance functions,
which have certain operational costs. It is recommended to read the entire
document before using this function. If you have any questions about the
solution design, please contact the IoTDB team for technical support.
+
+
+### Feature introduction
+
+IoTDB is a distributed database, and the balanced distribution of data plays
an important role in load balancing the disk space and write pressure of the
cluster. Region is the basic unit for distributed storage of data in IoTDB
cluster, and the specific concept can be seen in
[region](../Background-knowledge/Cluster-Concept.md)。
+
+Under normal operation of the cluster, IoTDB will automatically perform load
balancing on data. However, in scenarios where a new DataNode node is added to
the cluster or where the hard disk of the machine where the DataNode is located
is damaged and data needs to be recovered, manual region migration can be used
to finely adjust the cluster load and operations.
+
+Here is a schematic diagram of the region migration process :
+
+
+
+
+### Notes
+
+1. It is recommended to only use the Region Migration feature on IoTDB 1.3.3
and higher versions.
+2. Region migration is only supported when the consensus protocol is IoTConsus
or Ratis (in iotdb system. properties, the
`schema_region_consensus_protocol_class`
and`data_region_consensus_protocol_class`).
+3. Region migration will occupy system resources such as hard drives and
network bandwidth, and it is recommended to perform it during low business
loads.
+4. The region migration process will occupy WAL files, blocking the deletion
of WAL files in this consensus group. If the total number of WAL files reaches
`wal_file_size_threshold_in_byte`, writing will be blocked.
+
+### Instructions for use
+
+- **Grammar definition** :
+
+ Submit an asynchronous task to migrate a region from one DataNode to another.
+
+
+ ```SQL
+ migrateRegion
+ : MIGRATE REGION regionId=INTEGER_LITERAL FROM fromId=INTEGER_LITERAL
TO toId=INTEGER_LITERAL
+ ;
+ ```
+
+- **Example** :
+
+ Migrating region 1 from DataNode 2 to DataNode 3:
+
+ ```SQL
+ IoTDB> migrate region 1 from 2 to 3
+ Msg: The statement is executed successfully.
+ ```
+
+ "The statement is executed successfully" only represents the successful
submission of the region migration task, not the completion of execution. The
execution status of the task can be viewed through the CLI command `show
regions `.
+- **Related configuration** :
+ - Migration speed control : modify `iotdb-system.properties `parameters
`region_migration_speed_limit_bytes_per_second `control region migration speed.
+- **Time cost estimation** :
+ - If there are no concurrent writes during the migration process, the time
consumption can be simply estimated by dividing the region data volume by the
data transfer speed. For example, for a 1TB region, the hard disk internet
bandwidth and speed limit parameters jointly determine that the data transfer
speed is 100MB/s, so it takes about 3 hours to complete the migration.
+ - If there are concurrent writes in the migration process, the time
consumption will increase, and the specific time consumption depends on various
factors such as write pressure and system resources. It can be simply estimated
as `no concurrent write time × 1.5 `.
+- **Migration progress observation** : During the migration process, the state
changes can be observed through the CLI command `show regions `. Taking the 2
replicas as an example, the state of the consensus group where the region is
located will go through the following process:
+ - Before migration starts: `Running `, `Running `.
+ - Expansion phase: `Running `, `Running `, `Adding `. Due to the large
number of file transfers involved, it may take a long time. If using
IoTConsensus, the specific file transfer progress can be searched in the
DataNode log `[SNAPSHOT TRANSMISSION] `.
+ - Stages: `Removing `, `Running `, `Running `.
+ - Migration complete: `Running `, `Running `.
+
+ Taking the expansion phase as an example, the result of `show regions` may
be:
+
+ ```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
+ ```
diff --git a/src/UserGuide/latest/User-Manual/Maintennance.md
b/src/UserGuide/V2.0.1/Tree/User-Manual/Query-Performance-Analysis.md
similarity index 81%
rename from src/UserGuide/latest/User-Manual/Maintennance.md
rename to src/UserGuide/V2.0.1/Tree/User-Manual/Query-Performance-Analysis.md
index 599011d7..b31342ca 100644
--- a/src/UserGuide/latest/User-Manual/Maintennance.md
+++ b/src/UserGuide/V2.0.1/Tree/User-Manual/Query-Performance-Analysis.md
@@ -22,7 +22,7 @@
# Maintennance
-## Explain/Explain Analyze Statements
+## Query Performance Analysis
The purpose of query analysis is to assist users in understanding the
execution mechanism and performance bottlenecks of queries, thereby
facilitating query optimization and performance enhancement. This is crucial
not only for the efficiency of query execution but also for the user experience
of applications and the efficient utilization of resources. For effective query
analysis, IoTDB versions V1.3.2 and above offer the query analysis statements:
Explain and Explain Analyze.
@@ -346,92 +346,3 @@ Observing the results, we found that it is because the
query did not add a time
The final optimization plan is: Add a time filtering condition to avoid a full
table scan.
-## Region Migration
-
-The Region migration feature has operating costs. It is recommended to read
this section completely before using this feature. If you have any questions
about the solution design, please contact the IoTDB team for technical support.
-
-### 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).
-
-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 :
-
-
-
-### Notes
-
-1. Region migration is supported only 1.3.3 IoTDB and later.
-2. IoTConsensus and Ratis protocols ( `schema_region_consensus_protocol_class
`and `data_region_consensus_protocol_class `in `iotdb-system.properties `) are
currently supported .
-3. Region migration requires system resources such as hard disk and internet
bandwidth, and although the process does not block reads and writes , it may
affect read and write speeds .
-4. The region migration process will block the deletion of the WAL file of
this consensus group. If the total number of WAL files reaches
`wal_file_size_threshold_in_byte `, it will block writing.
-
-### Instructions for use
-
-- **Grammar definition** :
- ```SQL
- migrateRegion
- : MIGRATE REGION regionId=INTEGER_LITERAL FROM fromId=INTEGER_LITERAL
TO toId=INTEGER_LITERAL
- ;
- ```
-- **Meaning** : Migrates a region from one DataNode to another.
-- **Example** : Migrating region 1 from DataNode 2 to DataNode 3:
- ```SQL
- IoTDB> migrate region 1 from 2 to 3
- Msg: The statement is executed successfully.
- ```
-
- "The statement is executed successfully" only represents the successful
submission of the region migration task, not the completion of execution. The
execution status of the task can be viewed through the CLI command `show
regions `.
-- **Related configuration** :
- - Migration speed control : modify `iotdb-system.properties `parameters
`region_migration_speed_limit_bytes_per_second `control region migration speed.
-- **Time cost estimation** :
- - If there are no concurrent writes during the migration process, the time
consumption can be simply estimated by dividing the region data volume by the
data transfer speed. For example, for a 1TB region, the hard disk internet
bandwidth and speed limit parameters jointly determine that the data transfer
speed is 100MB/s, so it takes about 3 hours to complete the migration.
- - If there are concurrent writes in the migration process, the time
consumption will increase, and the specific time consumption depends on various
factors such as write pressure and system resources. It can be simply estimated
as `no concurrent write time × 1.5 `.
-- **Migration progress observation** : During the migration process, the state
changes can be observed through the CLI command `show regions `. Taking the 2
replicas as an example, the state of the consensus group where the region is
located will go through the following process:
- - Before migration starts: `Running `, `Running `.
- - Expansion phase: `Running `, `Running `, `Adding `. Due to the large
number of file transfers involved, it may take a long time. If using
IoTConsensus, the specific file transfer progress can be searched in the
DataNode log `[SNAPSHOT TRANSMISSION] `.
- - Stages: `Removing `, `Running `, `Running `.
- - Migration complete: `Running `, `Running `.
-
- Taking the expansion phase as an example, the result of `show regions` may
be:
-
- ```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 Statements
-Used to repair the unsorted data generate by system bug.
-### START REPAIR DATA
-
-Start a repair task to scan all files created before current time.
-The repair task will scan all tsfiles and repair some bad files.
-
-```sql
-IoTDB> START REPAIR DATA
-IoTDB> START REPAIR DATA ON LOCAL
-IoTDB> START REPAIR DATA ON CLUSTER
-```
-
-### STOP REPAIR DATA
-
-Stop the running repair task. To restart the stopped task.
-If there is a stopped repair task, it can be restart and recover the repair
progress by executing SQL `START REPAIR DATA`.
-
-```sql
-IoTDB> STOP REPAIR DATA
-IoTDB> STOP REPAIR DATA ON LOCAL
-IoTDB> STOP REPAIR DATA ON CLUSTER
-```
diff --git a/src/UserGuide/latest/User-Manual/Data-Recovery.md
b/src/UserGuide/latest/User-Manual/Data-Recovery.md
new file mode 100644
index 00000000..ab0cd6ea
--- /dev/null
+++ b/src/UserGuide/latest/User-Manual/Data-Recovery.md
@@ -0,0 +1,47 @@
+<!--
+
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+-->
+
+## Data Recovery
+
+Used to fix issues in data, such as data in sequential space not being
arranged in chronological order.
+
+### START REPAIR DATA
+
+Start a repair task to scan all files created before current time.
+The repair task will scan all tsfiles and repair some bad files.
+
+```sql
+IoTDB> START REPAIR DATA
+IoTDB> START REPAIR DATA ON LOCAL
+IoTDB> START REPAIR DATA ON CLUSTER
+```
+
+### STOP REPAIR DATA
+
+Stop the running repair task. To restart the stopped task.
+If there is a stopped repair task, it can be restart and recover the repair
progress by executing SQL `START REPAIR DATA`.
+
+```sql
+IoTDB> STOP REPAIR DATA
+IoTDB> STOP REPAIR DATA ON LOCAL
+IoTDB> STOP REPAIR DATA ON CLUSTER
+```
+
diff --git a/src/UserGuide/latest/User-Manual/Load-Balance.md
b/src/UserGuide/latest/User-Manual/Load-Balance.md
new file mode 100644
index 00000000..17cfe039
--- /dev/null
+++ b/src/UserGuide/latest/User-Manual/Load-Balance.md
@@ -0,0 +1,95 @@
+<!--
+
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+-->
+
+## Load Balance
+
+Region migration belongs to advanced operations and maintenance functions,
which have certain operational costs. It is recommended to read the entire
document before using this function. If you have any questions about the
solution design, please contact the IoTDB team for technical support.
+
+
+### Feature introduction
+
+IoTDB is a distributed database, and the balanced distribution of data plays
an important role in load balancing the disk space and write pressure of the
cluster. Region is the basic unit for distributed storage of data in IoTDB
cluster, and the specific concept can be seen in
[region](../Background-knowledge/Cluster-Concept.md)。
+
+Under normal operation of the cluster, IoTDB will automatically perform load
balancing on data. However, in scenarios where a new DataNode node is added to
the cluster or where the hard disk of the machine where the DataNode is located
is damaged and data needs to be recovered, manual region migration can be used
to finely adjust the cluster load and operations.
+
+Here is a schematic diagram of the region migration process :
+
+
+
+
+### Notes
+
+1. It is recommended to only use the Region Migration feature on IoTDB 1.3.3
and higher versions.
+2. Region migration is only supported when the consensus protocol is IoTConsus
or Ratis (in iotdb system. properties, the
`schema_region_consensus_protocol_class`
and`data_region_consensus_protocol_class`).
+3. Region migration will occupy system resources such as hard drives and
network bandwidth, and it is recommended to perform it during low business
loads.
+4. The region migration process will occupy WAL files, blocking the deletion
of WAL files in this consensus group. If the total number of WAL files reaches
`wal_file_size_threshold_in_byte`, writing will be blocked.
+
+### Instructions for use
+
+- **Grammar definition** :
+
+ Submit an asynchronous task to migrate a region from one DataNode to another.
+
+
+ ```SQL
+ migrateRegion
+ : MIGRATE REGION regionId=INTEGER_LITERAL FROM fromId=INTEGER_LITERAL
TO toId=INTEGER_LITERAL
+ ;
+ ```
+
+- **Example** :
+
+ Migrating region 1 from DataNode 2 to DataNode 3:
+
+ ```SQL
+ IoTDB> migrate region 1 from 2 to 3
+ Msg: The statement is executed successfully.
+ ```
+
+ "The statement is executed successfully" only represents the successful
submission of the region migration task, not the completion of execution. The
execution status of the task can be viewed through the CLI command `show
regions `.
+- **Related configuration** :
+ - Migration speed control : modify `iotdb-system.properties `parameters
`region_migration_speed_limit_bytes_per_second `control region migration speed.
+- **Time cost estimation** :
+ - If there are no concurrent writes during the migration process, the time
consumption can be simply estimated by dividing the region data volume by the
data transfer speed. For example, for a 1TB region, the hard disk internet
bandwidth and speed limit parameters jointly determine that the data transfer
speed is 100MB/s, so it takes about 3 hours to complete the migration.
+ - If there are concurrent writes in the migration process, the time
consumption will increase, and the specific time consumption depends on various
factors such as write pressure and system resources. It can be simply estimated
as `no concurrent write time × 1.5 `.
+- **Migration progress observation** : During the migration process, the state
changes can be observed through the CLI command `show regions `. Taking the 2
replicas as an example, the state of the consensus group where the region is
located will go through the following process:
+ - Before migration starts: `Running `, `Running `.
+ - Expansion phase: `Running `, `Running `, `Adding `. Due to the large
number of file transfers involved, it may take a long time. If using
IoTConsensus, the specific file transfer progress can be searched in the
DataNode log `[SNAPSHOT TRANSMISSION] `.
+ - Stages: `Removing `, `Running `, `Running `.
+ - Migration complete: `Running `, `Running `.
+
+ Taking the expansion phase as an example, the result of `show regions` may
be:
+
+ ```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
+ ```
diff --git a/src/UserGuide/Master/Tree/User-Manual/Maintennance.md
b/src/UserGuide/latest/User-Manual/Query-Performance-Analysis.md
similarity index 81%
rename from src/UserGuide/Master/Tree/User-Manual/Maintennance.md
rename to src/UserGuide/latest/User-Manual/Query-Performance-Analysis.md
index e09a51e2..b31342ca 100644
--- a/src/UserGuide/Master/Tree/User-Manual/Maintennance.md
+++ b/src/UserGuide/latest/User-Manual/Query-Performance-Analysis.md
@@ -22,7 +22,7 @@
# Maintennance
-## Explain/Explain Analyze Statements
+## Query Performance Analysis
The purpose of query analysis is to assist users in understanding the
execution mechanism and performance bottlenecks of queries, thereby
facilitating query optimization and performance enhancement. This is crucial
not only for the efficiency of query execution but also for the user experience
of applications and the efficient utilization of resources. For effective query
analysis, IoTDB versions V1.3.2 and above offer the query analysis statements:
Explain and Explain Analyze.
@@ -346,92 +346,3 @@ Observing the results, we found that it is because the
query did not add a time
The final optimization plan is: Add a time filtering condition to avoid a full
table scan.
-## Region Migration
-
-The Region migration feature has operating costs. It is recommended to read
this section completely before using this feature. If you have any questions
about the solution design, please contact the IoTDB team for technical support.
-
-### 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).
-
-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 :
-
-
-
-### Notes
-
-1. Region migration is supported only 1.3.3 IoTDB and later.
-2. IoTConsensus and Ratis protocols ( `schema_region_consensus_protocol_class
`and `data_region_consensus_protocol_class `in `iotdb-system.properties `) are
currently supported .
-3. Region migration requires system resources such as hard disk and internet
bandwidth, and although the process does not block reads and writes , it may
affect read and write speeds .
-4. The region migration process will block the deletion of the WAL file of
this consensus group. If the total number of WAL files reaches
`wal_file_size_threshold_in_byte `, it will block writing.
-
-### Instructions for use
-
-- **Grammar definition** :
- ```SQL
- migrateRegion
- : MIGRATE REGION regionId=INTEGER_LITERAL FROM fromId=INTEGER_LITERAL
TO toId=INTEGER_LITERAL
- ;
- ```
-- **Meaning** : Migrates a region from one DataNode to another.
-- **Example** : Migrating region 1 from DataNode 2 to DataNode 3:
- ```SQL
- IoTDB> migrate region 1 from 2 to 3
- Msg: The statement is executed successfully.
- ```
-
- "The statement is executed successfully" only represents the successful
submission of the region migration task, not the completion of execution. The
execution status of the task can be viewed through the CLI command `show
regions `.
-- **Related configuration** :
- - Migration speed control : modify `iotdb-system.properties `parameters
`region_migration_speed_limit_bytes_per_second `control region migration speed.
-- **Time cost estimation** :
- - If there are no concurrent writes during the migration process, the time
consumption can be simply estimated by dividing the region data volume by the
data transfer speed. For example, for a 1TB region, the hard disk internet
bandwidth and speed limit parameters jointly determine that the data transfer
speed is 100MB/s, so it takes about 3 hours to complete the migration.
- - If there are concurrent writes in the migration process, the time
consumption will increase, and the specific time consumption depends on various
factors such as write pressure and system resources. It can be simply estimated
as `no concurrent write time × 1.5 `.
-- **Migration progress observation** : During the migration process, the state
changes can be observed through the CLI command `show regions `. Taking the 2
replicas as an example, the state of the consensus group where the region is
located will go through the following process:
- - Before migration starts: `Running `, `Running `.
- - Expansion phase: `Running `, `Running `, `Adding `. Due to the large
number of file transfers involved, it may take a long time. If using
IoTConsensus, the specific file transfer progress can be searched in the
DataNode log `[SNAPSHOT TRANSMISSION] `.
- - Stages: `Removing `, `Running `, `Running `.
- - Migration complete: `Running `, `Running `.
-
- Taking the expansion phase as an example, the result of `show regions` may
be:
-
- ```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 Statements
-Used to repair the unsorted data generate by system bug.
-### START REPAIR DATA
-
-Start a repair task to scan all files created before current time.
-The repair task will scan all tsfiles and repair some bad files.
-
-```sql
-IoTDB> START REPAIR DATA
-IoTDB> START REPAIR DATA ON LOCAL
-IoTDB> START REPAIR DATA ON CLUSTER
-```
-
-### STOP REPAIR DATA
-
-Stop the running repair task. To restart the stopped task.
-If there is a stopped repair task, it can be restart and recover the repair
progress by executing SQL `START REPAIR DATA`.
-
-```sql
-IoTDB> STOP REPAIR DATA
-IoTDB> STOP REPAIR DATA ON LOCAL
-IoTDB> STOP REPAIR DATA ON CLUSTER
-```
diff --git a/src/zh/UserGuide/Master/Tree/User-Manual/Data-Recovery.md
b/src/zh/UserGuide/Master/Tree/User-Manual/Data-Recovery.md
new file mode 100644
index 00000000..c02f04f3
--- /dev/null
+++ b/src/zh/UserGuide/Master/Tree/User-Manual/Data-Recovery.md
@@ -0,0 +1,45 @@
+<!--
+
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+-->
+
+## 数据修复
+
+用于修复数据中存在的问题，如顺序空间内的数据未按时间递增顺序排列。
+
+### START REPAIR DATA
+
+启动一个数据修复任务，扫描创建修复任务的时间之前产生的 tsfile 文件并修复有乱序错误的文件。
+
+```sql
+IoTDB> START REPAIR DATA
+IoTDB> START REPAIR DATA ON LOCAL
+IoTDB> START REPAIR DATA ON CLUSTER
+```
+
+### STOP REPAIR DATA
+
+停止一个进行中的修复任务。如果需要再次恢复一个已停止的数据修复任务的进度，可以重新执行 `START REPAIR DATA`.
+
+```sql
+IoTDB> STOP REPAIR DATA
+IoTDB> STOP REPAIR DATA ON LOCAL
+IoTDB> STOP REPAIR DATA ON CLUSTER
+```
+
diff --git a/src/zh/UserGuide/Master/Tree/User-Manual/Load-Balance.md
b/src/zh/UserGuide/Master/Tree/User-Manual/Load-Balance.md
new file mode 100644
index 00000000..494a39e2
--- /dev/null
+++ b/src/zh/UserGuide/Master/Tree/User-Manual/Load-Balance.md
@@ -0,0 +1,101 @@
+<!--
+
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+-->
+
+## 负载均衡
+
+Region 迁移属于高级运维功能，具有一定操作成本，建议完整阅读后再使用该功能。如有疑问请联系 IoTDB 团队寻求技术支持。
+
+### 功能介绍
+
+IoTDB 是一个分布式数据库，数据的均衡分布对集群的磁盘空间、写入压力的负载均衡有着重要作用，region 是数据在 IoTDB
集群中进行分布式存储的基本单元，具体概念可见[region](../Background-knowledge/Cluster-Concept.md)。
+
+集群正常运行情况下，IoTDB 将会自动对数据进行负载均衡，但在集群新加入 DataNode 节点、DataNode
所在机器硬盘损坏需要恢复数据等场景下，可通过手动 Region 迁移精细化调整集群负载和运维。
+
+下面是一次region迁移过程的示意图：
+
+
+
+
+### 注意事项
+
+1. 推荐仅在 IoTDB 1.3.3 以及更高版本使用 Region 迁移功能。
+2. 仅在共识协议为 IoTConsensus、Ratis 时支持 Region
迁移（iotdb-system.properties中的`schema_region_consensus_protocol_class` 和
`data_region_consensus_protocol_class`）。
+3. Region 迁移会占用硬盘和网络带宽等系统资源，推荐在低业务负载时进行。
+4. Region 迁移过程会占用 WAL 文件，阻塞本共识组 WAL 文件的删除，如果 WAL
文件总量达到`wal_file_size_threshold_in_byte`，则会阻塞写入。
+
+### 使用说明
+
+- **语法定义**：
+
+ 提交一个异步任务，将 region 从一个 DataNode 迁移到另一个 DataNode。
+
+ ```SQL
+ migrateRegion
+ : MIGRATE REGION regionId=INTEGER_LITERAL FROM fromId=INTEGER_LITERAL
TO toId=INTEGER_LITERAL
+ ;
+ ```
+
+- **示例**：
+
+ 将 region 1 从 DataNode 2 迁移至 DataNode 3：
+
+ ```SQL
+ IoTDB> migrate region 1 from 2 to 3
+ Msg: The statement is executed successfully.
+ ```
+
+ “The statement is executed successfully” 仅代表region迁移任务提交成功，不代表执行完毕。任务执行情况通过
CLI 指令`show regions`查看。
+
+- **相关配置项**：
+
+ - 迁移速度控制：修改`iotdb-system.properties`参数
`region_migration_speed_limit_bytes_per_second`控制 region 迁移速度。
+
+- **耗时估算**：
+ - 如果迁移过程无并发写入，那么耗时可以简单通过 region 数据量除以数据传输速度来估算。例如对于 1TB 的
region，硬盘网络带宽和限速参数共同决定数据传输速度是 100MB/s，那么需要约 3 小时完成迁移。
+ - 如果迁移过程有并发写入，那么耗时会有所上升，具体耗时取决于写入压力、系统资源等多方面因素，可简单按无并发写入耗时×1.5来估算。
+
+- **迁移进度观察**：迁移过程中可通过 CLI 指令`show regions`观察状态变化，以 2 副本为例，region
所在共识组的状态会经历如下过程：
+ - 迁移开始前：`Running`，`Running`。
+
+ - 扩容阶段：`Running`，`Running`，`Adding`。由于涉及到大量文件传输，可能耗时较长，具体进度在 DataNode
日志中搜索`[SNAPSHOT TRANSMISSION]`。
+
+ - 缩容阶段：`Removing`，`Running`，`Running`。
+
+ - 迁移完成：`Running`，`Running`。
+
+ 以扩容阶段为例，`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
+ ```
+
diff --git a/src/zh/UserGuide/V2.0.1/Tree/User-Manual/Maintennance.md
b/src/zh/UserGuide/Master/Tree/User-Manual/Query-Performance-Analysis.md
similarity index 97%
rename from src/zh/UserGuide/V2.0.1/Tree/User-Manual/Maintennance.md
rename to src/zh/UserGuide/Master/Tree/User-Manual/Query-Performance-Analysis.md
index b1cb1941..b41ba4f4 100644
--- a/src/zh/UserGuide/V2.0.1/Tree/User-Manual/Maintennance.md
+++ b/src/zh/UserGuide/Master/Tree/User-Manual/Query-Performance-Analysis.md
@@ -20,7 +20,7 @@
-->
# 运维语句
-## Explain/Explain Analyze 语句
+## 查询性能分析
查询分析的意义在于帮助用户理解查询的执行机制和性能瓶颈，从而实现查询优化和性能提升。这不仅关乎到查询的执行效率，也直接影响到应用的用户体验和资源的有效利用。为了进行有效的查询分析，**IoTDB**
**V1.3.2及以上版本**提供了查询分析语句：Explain 和 Explain Analyze。
@@ -327,25 +327,3 @@ select count(s1) as total from root.db.d1 where s1 like
'%XXXXXXXX%'
最终优化方案为：增加时间过滤条件，避免全表扫描
-## Start/Stop Repair Data 语句
-用于修复由于系统 bug 导致的乱序
-### START REPAIR DATA
-
-启动一个数据修复任务，扫描创建修复任务的时间之前产生的 tsfile 文件并修复有乱序错误的文件。
-
-```sql
-IoTDB> START REPAIR DATA
-IoTDB> START REPAIR DATA ON LOCAL
-IoTDB> START REPAIR DATA ON CLUSTER
-```
-
-### STOP REPAIR DATA
-
-停止一个进行中的修复任务。如果需要再次恢复一个已停止的数据修复任务的进度，可以重新执行 `START REPAIR DATA`.
-
-```sql
-IoTDB> STOP REPAIR DATA
-IoTDB> STOP REPAIR DATA ON LOCAL
-IoTDB> STOP REPAIR DATA ON CLUSTER
-```
-
diff --git a/src/zh/UserGuide/V2.0.1/Tree/User-Manual/Data-Recovery.md
b/src/zh/UserGuide/V2.0.1/Tree/User-Manual/Data-Recovery.md
new file mode 100644
index 00000000..c02f04f3
--- /dev/null
+++ b/src/zh/UserGuide/V2.0.1/Tree/User-Manual/Data-Recovery.md
@@ -0,0 +1,45 @@
+<!--
+
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+-->
+
+## 数据修复
+
+用于修复数据中存在的问题，如顺序空间内的数据未按时间递增顺序排列。
+
+### START REPAIR DATA
+
+启动一个数据修复任务，扫描创建修复任务的时间之前产生的 tsfile 文件并修复有乱序错误的文件。
+
+```sql
+IoTDB> START REPAIR DATA
+IoTDB> START REPAIR DATA ON LOCAL
+IoTDB> START REPAIR DATA ON CLUSTER
+```
+
+### STOP REPAIR DATA
+
+停止一个进行中的修复任务。如果需要再次恢复一个已停止的数据修复任务的进度，可以重新执行 `START REPAIR DATA`.
+
+```sql
+IoTDB> STOP REPAIR DATA
+IoTDB> STOP REPAIR DATA ON LOCAL
+IoTDB> STOP REPAIR DATA ON CLUSTER
+```
+
diff --git a/src/zh/UserGuide/V2.0.1/Tree/User-Manual/Load-Balance.md
b/src/zh/UserGuide/V2.0.1/Tree/User-Manual/Load-Balance.md
new file mode 100644
index 00000000..494a39e2
--- /dev/null
+++ b/src/zh/UserGuide/V2.0.1/Tree/User-Manual/Load-Balance.md
@@ -0,0 +1,101 @@
+<!--
+
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+-->
+
+## 负载均衡
+
+Region 迁移属于高级运维功能，具有一定操作成本，建议完整阅读后再使用该功能。如有疑问请联系 IoTDB 团队寻求技术支持。
+
+### 功能介绍
+
+IoTDB 是一个分布式数据库，数据的均衡分布对集群的磁盘空间、写入压力的负载均衡有着重要作用，region 是数据在 IoTDB
集群中进行分布式存储的基本单元，具体概念可见[region](../Background-knowledge/Cluster-Concept.md)。
+
+集群正常运行情况下，IoTDB 将会自动对数据进行负载均衡，但在集群新加入 DataNode 节点、DataNode
所在机器硬盘损坏需要恢复数据等场景下，可通过手动 Region 迁移精细化调整集群负载和运维。
+
+下面是一次region迁移过程的示意图：
+
+
+
+
+### 注意事项
+
+1. 推荐仅在 IoTDB 1.3.3 以及更高版本使用 Region 迁移功能。
+2. 仅在共识协议为 IoTConsensus、Ratis 时支持 Region
迁移（iotdb-system.properties中的`schema_region_consensus_protocol_class` 和
`data_region_consensus_protocol_class`）。
+3. Region 迁移会占用硬盘和网络带宽等系统资源，推荐在低业务负载时进行。
+4. Region 迁移过程会占用 WAL 文件，阻塞本共识组 WAL 文件的删除，如果 WAL
文件总量达到`wal_file_size_threshold_in_byte`，则会阻塞写入。
+
+### 使用说明
+
+- **语法定义**：
+
+ 提交一个异步任务，将 region 从一个 DataNode 迁移到另一个 DataNode。
+
+ ```SQL
+ migrateRegion
+ : MIGRATE REGION regionId=INTEGER_LITERAL FROM fromId=INTEGER_LITERAL
TO toId=INTEGER_LITERAL
+ ;
+ ```
+
+- **示例**：
+
+ 将 region 1 从 DataNode 2 迁移至 DataNode 3：
+
+ ```SQL
+ IoTDB> migrate region 1 from 2 to 3
+ Msg: The statement is executed successfully.
+ ```
+
+ “The statement is executed successfully” 仅代表region迁移任务提交成功，不代表执行完毕。任务执行情况通过
CLI 指令`show regions`查看。
+
+- **相关配置项**：
+
+ - 迁移速度控制：修改`iotdb-system.properties`参数
`region_migration_speed_limit_bytes_per_second`控制 region 迁移速度。
+
+- **耗时估算**：
+ - 如果迁移过程无并发写入，那么耗时可以简单通过 region 数据量除以数据传输速度来估算。例如对于 1TB 的
region，硬盘网络带宽和限速参数共同决定数据传输速度是 100MB/s，那么需要约 3 小时完成迁移。
+ - 如果迁移过程有并发写入，那么耗时会有所上升，具体耗时取决于写入压力、系统资源等多方面因素，可简单按无并发写入耗时×1.5来估算。
+
+- **迁移进度观察**：迁移过程中可通过 CLI 指令`show regions`观察状态变化，以 2 副本为例，region
所在共识组的状态会经历如下过程：
+ - 迁移开始前：`Running`，`Running`。
+
+ - 扩容阶段：`Running`，`Running`，`Adding`。由于涉及到大量文件传输，可能耗时较长，具体进度在 DataNode
日志中搜索`[SNAPSHOT TRANSMISSION]`。
+
+ - 缩容阶段：`Removing`，`Running`，`Running`。
+
+ - 迁移完成：`Running`，`Running`。
+
+ 以扩容阶段为例，`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
+ ```
+
diff --git a/src/zh/UserGuide/latest/User-Manual/Maintennance.md
b/src/zh/UserGuide/V2.0.1/Tree/User-Manual/Query-Performance-Analysis.md
similarity index 82%
rename from src/zh/UserGuide/latest/User-Manual/Maintennance.md
rename to src/zh/UserGuide/V2.0.1/Tree/User-Manual/Query-Performance-Analysis.md
index d01baa82..b41ba4f4 100644
--- a/src/zh/UserGuide/latest/User-Manual/Maintennance.md
+++ b/src/zh/UserGuide/V2.0.1/Tree/User-Manual/Query-Performance-Analysis.md
@@ -20,7 +20,7 @@
-->
# 运维语句
-## Explain/Explain Analyze 语句
+## 查询性能分析
查询分析的意义在于帮助用户理解查询的执行机制和性能瓶颈，从而实现查询优化和性能提升。这不仅关乎到查询的执行效率，也直接影响到应用的用户体验和资源的有效利用。为了进行有效的查询分析，**IoTDB**
**V1.3.2及以上版本**提供了查询分析语句：Explain 和 Explain Analyze。
@@ -327,101 +327,3 @@ select count(s1) as total from root.db.d1 where s1 like
'%XXXXXXXX%'
最终优化方案为：增加时间过滤条件，避免全表扫描
-## region 迁移
-
-region 迁移功能具有一定操作成本，建议完整阅读本节后再使用 region 迁移功能。如对方案设计有疑问请联系 IoTDB 团队寻求技术支持。
-
-### 功能介绍
-
-IoTDB 是一个分布式数据库，数据的均衡分布对集群的磁盘空间、写入压力的负载均衡有着重要作用，region 是数据在 IoTDB
集群中进行分布式存储的基本单元，具体概念可见[region](../Background-knowledge/Cluster-Concept.md)。
-
-集群正常运行情况下，IoTDB 内核将会自动对数据进行负载均衡，但在集群新加入 DataNode 节点、DataNode
所在机器硬盘损坏需要恢复数据等场景下，会涉及到对 region 的手动迁移，以达到更精细化的调整集群负载的目标。
-
-下面是一次region迁移过程的示意图：
-
-
-
-
-### 注意事项
-
-1. 仅支持在 IoTDB 1.3.3 以及更高版本使用 region 迁移功能。
-2. 目前支持 IoTConsensus、Ratis 协议。见 iotdb-system.properties
中的schema_region_consensus_protocol_class 和 data_region_consensus_protocol_class。
-3. region 迁移需要占用硬盘和网络带宽等系统资源，尽管过程不阻塞读取和写入，但可能影响读写速度。
-4. region 迁移过程会阻塞本共识组 WAL 文件的删除，如果 WAL
文件总量达到`wal_file_size_threshold_in_byte`，则会阻塞写入。
-
-### 使用说明
-
-- **语法定义**：
- ```SQL
- migrateRegion
- : MIGRATE REGION regionId=INTEGER_LITERAL FROM fromId=INTEGER_LITERAL
TO toId=INTEGER_LITERAL
- ;
- ```
-
-- **含义**：将 region 从一个 DataNode 迁移到另一个 DataNode。
-
-- **示例**：将 region 1 从 DataNode 2 迁移至 DataNode 3：
- ```SQL
- IoTDB> migrate region 1 from 2 to 3
- Msg: The statement is executed successfully.
- ```
-
- “The statement is executed successfully” 仅代表region迁移任务提交成功，不代表执行完毕。任务执行情况通过
CLI 指令`show regions`查看。
-
-- **相关配置项**：
-
- - 迁移速度控制：修改`iotdb-system.properties`参数
`region_migration_speed_limit_bytes_per_second`控制 region 迁移速度。
-
-- **耗时估算**：
- - 如果迁移过程无并发写入，那么耗时可以简单通过 region 数据量除以数据传输速度来估算。例如对于 1TB 的
region，硬盘网络带宽和限速参数共同决定数据传输速度是 100MB/s，那么需要约 3 小时完成迁移。
- - 如果迁移过程有并发写入，那么耗时会有所上升，具体耗时取决于写入压力、系统资源等多方面因素，可简单按`无并发写入耗时×1.5`来估算。
-
-- **迁移进度观察**：迁移过程中可通过 CLI 指令`show regions`观察状态变化，以 2 副本为例，region
所在共识组的状态会经历如下过程：
- - 迁移开始前：`Running`，`Running`。
-
- - 扩容阶段：`Running`，`Running`，`Adding`。由于涉及到大量文件传输，可能耗时较长，具体进度在 DataNode
日志中搜索`[SNAPSHOT TRANSMISSION]`。
-
- - 缩容阶段：`Removing`，`Running`，`Running`。
-
- - 迁移完成：`Running`，`Running`。
-
- 以扩容阶段为例，`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
- ```
-
-## Start/Stop Repair Data 语句
-用于修复由于系统 bug 导致的乱序
-### START REPAIR DATA
-
-启动一个数据修复任务，扫描创建修复任务的时间之前产生的 tsfile 文件并修复有乱序错误的文件。
-
-```sql
-IoTDB> START REPAIR DATA
-IoTDB> START REPAIR DATA ON LOCAL
-IoTDB> START REPAIR DATA ON CLUSTER
-```
-
-### STOP REPAIR DATA
-
-停止一个进行中的修复任务。如果需要再次恢复一个已停止的数据修复任务的进度，可以重新执行 `START REPAIR DATA`.
-
-```sql
-IoTDB> STOP REPAIR DATA
-IoTDB> STOP REPAIR DATA ON LOCAL
-IoTDB> STOP REPAIR DATA ON CLUSTER
-```
-
diff --git a/src/zh/UserGuide/latest/User-Manual/Data-Recovery.md
b/src/zh/UserGuide/latest/User-Manual/Data-Recovery.md
new file mode 100644
index 00000000..c02f04f3
--- /dev/null
+++ b/src/zh/UserGuide/latest/User-Manual/Data-Recovery.md
@@ -0,0 +1,45 @@
+<!--
+
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+-->
+
+## 数据修复
+
+用于修复数据中存在的问题，如顺序空间内的数据未按时间递增顺序排列。
+
+### START REPAIR DATA
+
+启动一个数据修复任务，扫描创建修复任务的时间之前产生的 tsfile 文件并修复有乱序错误的文件。
+
+```sql
+IoTDB> START REPAIR DATA
+IoTDB> START REPAIR DATA ON LOCAL
+IoTDB> START REPAIR DATA ON CLUSTER
+```
+
+### STOP REPAIR DATA
+
+停止一个进行中的修复任务。如果需要再次恢复一个已停止的数据修复任务的进度，可以重新执行 `START REPAIR DATA`.
+
+```sql
+IoTDB> STOP REPAIR DATA
+IoTDB> STOP REPAIR DATA ON LOCAL
+IoTDB> STOP REPAIR DATA ON CLUSTER
+```
+
diff --git a/src/zh/UserGuide/latest/User-Manual/Load-Balance.md
b/src/zh/UserGuide/latest/User-Manual/Load-Balance.md
new file mode 100644
index 00000000..494a39e2
--- /dev/null
+++ b/src/zh/UserGuide/latest/User-Manual/Load-Balance.md
@@ -0,0 +1,101 @@
+<!--
+
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+-->
+
+## 负载均衡
+
+Region 迁移属于高级运维功能，具有一定操作成本，建议完整阅读后再使用该功能。如有疑问请联系 IoTDB 团队寻求技术支持。
+
+### 功能介绍
+
+IoTDB 是一个分布式数据库，数据的均衡分布对集群的磁盘空间、写入压力的负载均衡有着重要作用，region 是数据在 IoTDB
集群中进行分布式存储的基本单元，具体概念可见[region](../Background-knowledge/Cluster-Concept.md)。
+
+集群正常运行情况下，IoTDB 将会自动对数据进行负载均衡，但在集群新加入 DataNode 节点、DataNode
所在机器硬盘损坏需要恢复数据等场景下，可通过手动 Region 迁移精细化调整集群负载和运维。
+
+下面是一次region迁移过程的示意图：
+
+
+
+
+### 注意事项
+
+1. 推荐仅在 IoTDB 1.3.3 以及更高版本使用 Region 迁移功能。
+2. 仅在共识协议为 IoTConsensus、Ratis 时支持 Region
迁移（iotdb-system.properties中的`schema_region_consensus_protocol_class` 和
`data_region_consensus_protocol_class`）。
+3. Region 迁移会占用硬盘和网络带宽等系统资源，推荐在低业务负载时进行。
+4. Region 迁移过程会占用 WAL 文件，阻塞本共识组 WAL 文件的删除，如果 WAL
文件总量达到`wal_file_size_threshold_in_byte`，则会阻塞写入。
+
+### 使用说明
+
+- **语法定义**：
+
+ 提交一个异步任务，将 region 从一个 DataNode 迁移到另一个 DataNode。
+
+ ```SQL
+ migrateRegion
+ : MIGRATE REGION regionId=INTEGER_LITERAL FROM fromId=INTEGER_LITERAL
TO toId=INTEGER_LITERAL
+ ;
+ ```
+
+- **示例**：
+
+ 将 region 1 从 DataNode 2 迁移至 DataNode 3：
+
+ ```SQL
+ IoTDB> migrate region 1 from 2 to 3
+ Msg: The statement is executed successfully.
+ ```
+
+ “The statement is executed successfully” 仅代表region迁移任务提交成功，不代表执行完毕。任务执行情况通过
CLI 指令`show regions`查看。
+
+- **相关配置项**：
+
+ - 迁移速度控制：修改`iotdb-system.properties`参数
`region_migration_speed_limit_bytes_per_second`控制 region 迁移速度。
+
+- **耗时估算**：
+ - 如果迁移过程无并发写入，那么耗时可以简单通过 region 数据量除以数据传输速度来估算。例如对于 1TB 的
region，硬盘网络带宽和限速参数共同决定数据传输速度是 100MB/s，那么需要约 3 小时完成迁移。
+ - 如果迁移过程有并发写入，那么耗时会有所上升，具体耗时取决于写入压力、系统资源等多方面因素，可简单按无并发写入耗时×1.5来估算。
+
+- **迁移进度观察**：迁移过程中可通过 CLI 指令`show regions`观察状态变化，以 2 副本为例，region
所在共识组的状态会经历如下过程：
+ - 迁移开始前：`Running`，`Running`。
+
+ - 扩容阶段：`Running`，`Running`，`Adding`。由于涉及到大量文件传输，可能耗时较长，具体进度在 DataNode
日志中搜索`[SNAPSHOT TRANSMISSION]`。
+
+ - 缩容阶段：`Removing`，`Running`，`Running`。
+
+ - 迁移完成：`Running`，`Running`。
+
+ 以扩容阶段为例，`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
+ ```
+
diff --git a/src/zh/UserGuide/Master/Tree/User-Manual/Maintennance.md
b/src/zh/UserGuide/latest/User-Manual/Query-Performance-Analysis.md
similarity index 82%
rename from src/zh/UserGuide/Master/Tree/User-Manual/Maintennance.md
rename to src/zh/UserGuide/latest/User-Manual/Query-Performance-Analysis.md
index d01baa82..b41ba4f4 100644
--- a/src/zh/UserGuide/Master/Tree/User-Manual/Maintennance.md
+++ b/src/zh/UserGuide/latest/User-Manual/Query-Performance-Analysis.md
@@ -20,7 +20,7 @@
-->
# 运维语句
-## Explain/Explain Analyze 语句
+## 查询性能分析
查询分析的意义在于帮助用户理解查询的执行机制和性能瓶颈，从而实现查询优化和性能提升。这不仅关乎到查询的执行效率，也直接影响到应用的用户体验和资源的有效利用。为了进行有效的查询分析，**IoTDB**
**V1.3.2及以上版本**提供了查询分析语句：Explain 和 Explain Analyze。
@@ -327,101 +327,3 @@ select count(s1) as total from root.db.d1 where s1 like
'%XXXXXXXX%'
最终优化方案为：增加时间过滤条件，避免全表扫描
-## region 迁移
-
-region 迁移功能具有一定操作成本，建议完整阅读本节后再使用 region 迁移功能。如对方案设计有疑问请联系 IoTDB 团队寻求技术支持。
-
-### 功能介绍
-
-IoTDB 是一个分布式数据库，数据的均衡分布对集群的磁盘空间、写入压力的负载均衡有着重要作用，region 是数据在 IoTDB
集群中进行分布式存储的基本单元，具体概念可见[region](../Background-knowledge/Cluster-Concept.md)。
-
-集群正常运行情况下，IoTDB 内核将会自动对数据进行负载均衡，但在集群新加入 DataNode 节点、DataNode
所在机器硬盘损坏需要恢复数据等场景下，会涉及到对 region 的手动迁移，以达到更精细化的调整集群负载的目标。
-
-下面是一次region迁移过程的示意图：
-
-
-
-
-### 注意事项
-
-1. 仅支持在 IoTDB 1.3.3 以及更高版本使用 region 迁移功能。
-2. 目前支持 IoTConsensus、Ratis 协议。见 iotdb-system.properties
中的schema_region_consensus_protocol_class 和 data_region_consensus_protocol_class。
-3. region 迁移需要占用硬盘和网络带宽等系统资源，尽管过程不阻塞读取和写入，但可能影响读写速度。
-4. region 迁移过程会阻塞本共识组 WAL 文件的删除，如果 WAL
文件总量达到`wal_file_size_threshold_in_byte`，则会阻塞写入。
-
-### 使用说明
-
-- **语法定义**：
- ```SQL
- migrateRegion
- : MIGRATE REGION regionId=INTEGER_LITERAL FROM fromId=INTEGER_LITERAL
TO toId=INTEGER_LITERAL
- ;
- ```
-
-- **含义**：将 region 从一个 DataNode 迁移到另一个 DataNode。
-
-- **示例**：将 region 1 从 DataNode 2 迁移至 DataNode 3：
- ```SQL
- IoTDB> migrate region 1 from 2 to 3
- Msg: The statement is executed successfully.
- ```
-
- “The statement is executed successfully” 仅代表region迁移任务提交成功，不代表执行完毕。任务执行情况通过
CLI 指令`show regions`查看。
-
-- **相关配置项**：
-
- - 迁移速度控制：修改`iotdb-system.properties`参数
`region_migration_speed_limit_bytes_per_second`控制 region 迁移速度。
-
-- **耗时估算**：
- - 如果迁移过程无并发写入，那么耗时可以简单通过 region 数据量除以数据传输速度来估算。例如对于 1TB 的
region，硬盘网络带宽和限速参数共同决定数据传输速度是 100MB/s，那么需要约 3 小时完成迁移。
- - 如果迁移过程有并发写入，那么耗时会有所上升，具体耗时取决于写入压力、系统资源等多方面因素，可简单按`无并发写入耗时×1.5`来估算。
-
-- **迁移进度观察**：迁移过程中可通过 CLI 指令`show regions`观察状态变化，以 2 副本为例，region
所在共识组的状态会经历如下过程：
- - 迁移开始前：`Running`，`Running`。
-
- - 扩容阶段：`Running`，`Running`，`Adding`。由于涉及到大量文件传输，可能耗时较长，具体进度在 DataNode
日志中搜索`[SNAPSHOT TRANSMISSION]`。
-
- - 缩容阶段：`Removing`，`Running`，`Running`。
-
- - 迁移完成：`Running`，`Running`。
-
- 以扩容阶段为例，`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
- ```
-
-## Start/Stop Repair Data 语句
-用于修复由于系统 bug 导致的乱序
-### START REPAIR DATA
-
-启动一个数据修复任务，扫描创建修复任务的时间之前产生的 tsfile 文件并修复有乱序错误的文件。
-
-```sql
-IoTDB> START REPAIR DATA
-IoTDB> START REPAIR DATA ON LOCAL
-IoTDB> START REPAIR DATA ON CLUSTER
-```
-
-### STOP REPAIR DATA
-
-停止一个进行中的修复任务。如果需要再次恢复一个已停止的数据修复任务的进度，可以重新执行 `START REPAIR DATA`.
-
-```sql
-IoTDB> STOP REPAIR DATA
-IoTDB> STOP REPAIR DATA ON LOCAL
-IoTDB> STOP REPAIR DATA ON CLUSTER
-```
-
