This is an automated email from the ASF dual-hosted git repository.
critas 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 0b6617be add extend region and remove region to maintenance statement
of 13x (#934)
0b6617be is described below
commit 0b6617be806a35044c801c8d0fb41eca2ebb72f0
Author: leto-b <[email protected]>
AuthorDate: Fri Dec 26 11:13:33 2025 +0800
add extend region and remove region to maintenance statement of 13x (#934)
---
.../V1.3.x/User-Manual/Maintenance-commands.md | 47 ++++++++++++++++++-
.../dev-1.3/User-Manual/Maintenance-commands.md | 47 ++++++++++++++++++-
.../V1.3.x/User-Manual/Maintenance-statement.md | 46 +++++++++++++++++-
.../dev-1.3/User-Manual/Maintenance-statement.md | 54 ++++++++++++++++++++--
4 files changed, 183 insertions(+), 11 deletions(-)
diff --git a/src/UserGuide/V1.3.x/User-Manual/Maintenance-commands.md
b/src/UserGuide/V1.3.x/User-Manual/Maintenance-commands.md
index 0e00ac5c..3f11c232 100644
--- a/src/UserGuide/V1.3.x/User-Manual/Maintenance-commands.md
+++ b/src/UserGuide/V1.3.x/User-Manual/Maintenance-commands.md
@@ -427,9 +427,52 @@ localOrClusterMode
IoTDB> STOP REPAIR DATA ON CLUSTER;
```
-## 5. Query Termination
-### 5.1 Terminating Queries
+## 5. Replica Repair
+
+> This function has supported passing in a regionId list since V1.3.6,
allowing multiple regions to be processed at one time.
+
+### 5.1 Manual Expansion
+
+**Description**: Expand the specified Region to the specified DataNode.
+
+**Syntax**:
+
+```SQL
+extendRegionStatement
+ : EXTEND REGION <region_id>(, <region_id>)* TO <data_node_id>
+ ;
+```
+
+**Example**:
+
+```SQL
+IoTDB> EXTEND REGION 1,2,3 TO 3;
+```
+
+### 5.2 Manual Capacity Reduction
+
+**Description**: Remove the specified Region from the specified DataNode.
+> Note: Manual capacity reduction can only reduce the number of replicas to 1
at most, and cannot be reduced to 0.
+
+**Syntax**:
+
+```SQL
+removeRegionStatement
+ : REMOVE REGION <region_id>(, <region_id>)* FROM <data_node_id>
+ ;
+```
+
+**Example**:
+
+```SQL
+IoTDB> REMOVE REGION 1,2,3 FROM 2;
+```
+
+
+## 6. Query Termination
+
+### 6.1 Terminating Queries
**Description**: Terminates one or more running queries.
diff --git a/src/UserGuide/dev-1.3/User-Manual/Maintenance-commands.md
b/src/UserGuide/dev-1.3/User-Manual/Maintenance-commands.md
index 0e00ac5c..3f11c232 100644
--- a/src/UserGuide/dev-1.3/User-Manual/Maintenance-commands.md
+++ b/src/UserGuide/dev-1.3/User-Manual/Maintenance-commands.md
@@ -427,9 +427,52 @@ localOrClusterMode
IoTDB> STOP REPAIR DATA ON CLUSTER;
```
-## 5. Query Termination
-### 5.1 Terminating Queries
+## 5. Replica Repair
+
+> This function has supported passing in a regionId list since V1.3.6,
allowing multiple regions to be processed at one time.
+
+### 5.1 Manual Expansion
+
+**Description**: Expand the specified Region to the specified DataNode.
+
+**Syntax**:
+
+```SQL
+extendRegionStatement
+ : EXTEND REGION <region_id>(, <region_id>)* TO <data_node_id>
+ ;
+```
+
+**Example**:
+
+```SQL
+IoTDB> EXTEND REGION 1,2,3 TO 3;
+```
+
+### 5.2 Manual Capacity Reduction
+
+**Description**: Remove the specified Region from the specified DataNode.
+> Note: Manual capacity reduction can only reduce the number of replicas to 1
at most, and cannot be reduced to 0.
+
+**Syntax**:
+
+```SQL
+removeRegionStatement
+ : REMOVE REGION <region_id>(, <region_id>)* FROM <data_node_id>
+ ;
+```
+
+**Example**:
+
+```SQL
+IoTDB> REMOVE REGION 1,2,3 FROM 2;
+```
+
+
+## 6. Query Termination
+
+### 6.1 Terminating Queries
**Description**: Terminates one or more running queries.
diff --git a/src/zh/UserGuide/V1.3.x/User-Manual/Maintenance-statement.md
b/src/zh/UserGuide/V1.3.x/User-Manual/Maintenance-statement.md
index ef317c17..386fae44 100644
--- a/src/zh/UserGuide/V1.3.x/User-Manual/Maintenance-statement.md
+++ b/src/zh/UserGuide/V1.3.x/User-Manual/Maintenance-statement.md
@@ -441,9 +441,51 @@ localOrClusterMode
IoTDB> STOP REPAIR DATA ON CLUSTER;
```
-## 5. 终止查询
-### 5.1 主动终止查询
+## 5. 副本修复
+
+> 该功能从 V1.3.6 起支持传入 regionId list ，一次处理多个 region。
+
+### 5.1 手动扩容
+
+**含义**：将指定 Region 扩容到指定 DataNode 上。
+
+#### 语法：
+
+```SQL
+extendRegionStatement
+ : EXTEND REGION <region_id>(, <region_id>)* TO <data_node_id>
+ ;
+```
+
+#### 示例：
+
+```SQL
+IoTDB> EXTEND REGION 1,2,3 TO 3;
+```
+
+### 5.2 手动缩容
+
+**含义**：从指定 DataNode 上移除指定 Region。
+> 注意：手动缩容至多将副本数缩减至 1 ，不能缩减至 0 。
+
+#### 语法：
+
+```SQL
+removeRegionStatement
+ : REMOVE REGION <region_id>(, <region_id>)* FROM <data_node_id>
+ ;
+```
+
+#### 示例：
+
+```SQL
+IoTDB> REMOVE REGION 1,2,3 FROM 2;
+```
+
+## 6. 终止查询
+
+### 6.1 主动终止查询
**含义**：使用该命令主动地终止查询。
diff --git a/src/zh/UserGuide/dev-1.3/User-Manual/Maintenance-statement.md
b/src/zh/UserGuide/dev-1.3/User-Manual/Maintenance-statement.md
index 4d9c7b13..386fae44 100644
--- a/src/zh/UserGuide/dev-1.3/User-Manual/Maintenance-statement.md
+++ b/src/zh/UserGuide/dev-1.3/User-Manual/Maintenance-statement.md
@@ -184,6 +184,7 @@ IoTDB> SHOW QUERIES WHERE elapsedtime > 0.003
+-----------------------------+-----------------------+----------+-----------+--------------------------------------+
```
+
### 1.5 查看分区信息
**含义**：返回当前集群的分区信息。
@@ -215,6 +216,7 @@ IoTDB> SHOW REGIONS
+--------+------------+-------+-------------+-------------+-----------+----------+----------+-------+---------------+------+-----------------------+----------+
```
+
## 2. 状态设置
### 2.1 更新配置项
@@ -353,9 +355,9 @@ localOrClusterMode
**参数解释**：
1. **identifier**
- - **含义**：指定要刷写的路径名称。
- - **可选性**：可选。如果不指定，则默认刷写所有路径。
- - **多个路径**：可以指定多个路径名称，用逗号分隔。例如：`FLUSH root.ln, root.lnm`。
+ - **含义**：指定要刷写的数据库名称。
+ - **可选性**：可选。如果不指定，则默认刷写所有数据库。
+ - **多个数据库**：可以指定多个数据库名称，用逗号分隔。例如：`FLUSH root.ln, root.lnm`。
2. **booleanValue**
- **含义**：指定刷写的内容。
- **可选性**：可选。如果不指定，则默认刷写顺序和乱序空间的内存。
@@ -439,9 +441,51 @@ localOrClusterMode
IoTDB> STOP REPAIR DATA ON CLUSTER;
```
-## 5. 终止查询
-### 5.1 主动终止查询
+## 5. 副本修复
+
+> 该功能从 V1.3.6 起支持传入 regionId list ，一次处理多个 region。
+
+### 5.1 手动扩容
+
+**含义**：将指定 Region 扩容到指定 DataNode 上。
+
+#### 语法：
+
+```SQL
+extendRegionStatement
+ : EXTEND REGION <region_id>(, <region_id>)* TO <data_node_id>
+ ;
+```
+
+#### 示例：
+
+```SQL
+IoTDB> EXTEND REGION 1,2,3 TO 3;
+```
+
+### 5.2 手动缩容
+
+**含义**：从指定 DataNode 上移除指定 Region。
+> 注意：手动缩容至多将副本数缩减至 1 ，不能缩减至 0 。
+
+#### 语法：
+
+```SQL
+removeRegionStatement
+ : REMOVE REGION <region_id>(, <region_id>)* FROM <data_node_id>
+ ;
+```
+
+#### 示例：
+
+```SQL
+IoTDB> REMOVE REGION 1,2,3 FROM 2;
+```
+
+## 6. 终止查询
+
+### 6.1 主动终止查询
**含义**：使用该命令主动地终止查询。
