Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -822,9 +822,51 @@ localOrClusterMode
IoTDB> STOP REPAIR DATA ON CLUSTER;
```

## 5. Query Termination
## 5. Replica Repair

### 5.1 Terminating Queries
> Since V2.0.11, this feature supports passing in a regionId list to process multiple regions at once.

### 5.1 Manual Scale-Out

**Description**: Extends the specified Regions 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 Scale-In

**Description**: Removes the specified Regions from the specified DataNode.

> Note: Manual scale-in can reduce the number of replicas to 1 at most, and cannot reduce it 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.

Expand Down Expand Up @@ -858,8 +900,9 @@ Terminate all queries:
IoTDB> KILL ALL QUERIES;
```

## 6. Query Debugging
### 6.1 DEBUG SQL
## 7. Query Debugging

### 7.1 DEBUG SQL

**Definition**: Add the `DEBUG` keyword at the beginning of an SQL query statement. During execution, debug logs will be output, including the underlying file scan information involved in the query.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -588,9 +588,51 @@ localOrClusterMode
IoTDB> STOP REPAIR DATA ON CLUSTER;
```

## 5. Query Termination
## 5. Replica Repair

### 5.1 Terminating Queries
> Since V2.0.11, this feature supports passing in a regionId list to process multiple regions at once.

### 5.1 Manual Scale-Out

**Description**: Extends the specified Regions 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 Scale-In

**Description**: Removes the specified Regions from the specified DataNode.

> Note: Manual scale-in can reduce the number of replicas to 1 at most, and cannot reduce it 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.

Expand Down Expand Up @@ -624,9 +666,9 @@ Terminate all queries:
IoTDB> KILL ALL QUERIES;
```

## 6. Query Debugging
## 7. Query Debugging

### 6.1 DEBUG SQL
### 7.1 DEBUG SQL

**Definition**: Add the `DEBUG` keyword at the beginning of an SQL query statement. During execution, debug logs will be output, including underlying file scan information involved in the query.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -822,9 +822,51 @@ localOrClusterMode
IoTDB> STOP REPAIR DATA ON CLUSTER;
```

## 5. Query Termination
## 5. Replica Repair

### 5.1 Terminating Queries
> Since V2.0.11, this feature supports passing in a regionId list to process multiple regions at once.

### 5.1 Manual Scale-Out

**Description**: Extends the specified Regions 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 Scale-In

**Description**: Removes the specified Regions from the specified DataNode.

> Note: Manual scale-in can reduce the number of replicas to 1 at most, and cannot reduce it 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.

Expand Down Expand Up @@ -858,8 +900,9 @@ Terminate all queries:
IoTDB> KILL ALL QUERIES;
```

## 6. Query Debugging
### 6.1 DEBUG SQL
## 7. Query Debugging

### 7.1 DEBUG SQL

**Definition**: Add the `DEBUG` keyword at the beginning of an SQL query statement. During execution, debug logs will be output, including the underlying file scan information involved in the query.

Expand Down
50 changes: 46 additions & 4 deletions src/UserGuide/latest/User-Manual/Maintenance-commands_apache.md
Original file line number Diff line number Diff line change
Expand Up @@ -588,9 +588,51 @@ localOrClusterMode
IoTDB> STOP REPAIR DATA ON CLUSTER;
```

## 5. Query Termination
## 5. Replica Repair

### 5.1 Terminating Queries
> Since V2.0.11, this feature supports passing in a regionId list to process multiple regions at once.

### 5.1 Manual Scale-Out

**Description**: Extends the specified Regions 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 Scale-In

**Description**: Removes the specified Regions from the specified DataNode.

> Note: Manual scale-in can reduce the number of replicas to 1 at most, and cannot reduce it 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.

Expand Down Expand Up @@ -624,9 +666,9 @@ Terminate all queries:
IoTDB> KILL ALL QUERIES;
```

## 6. Query Debugging
## 7. Query Debugging

### 6.1 DEBUG SQL
### 7.1 DEBUG SQL

**Definition**: Add the `DEBUG` keyword at the beginning of an SQL query statement. During execution, debug logs will be output, including underlying file scan information involved in the query.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -847,9 +847,51 @@ localOrClusterMode
IoTDB> STOP REPAIR DATA ON CLUSTER;
```

## 5. 终止查询
## 5. 副本修复

### 5.1 主动终止查询
> 该功能从 V2.0.11 起支持传入 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 主动终止查询

**含义**:使用该命令主动地终止查询。

Expand Down Expand Up @@ -878,9 +920,9 @@ IoTDB> KILL QUERY 20250108_101015_00000_1; -- 终止指定query
IoTDB> KILL ALL QUERIES; -- 终止所有query
```

## 6. 调试查询
## 7. 调试查询

### 6.1 DEBUG SQL
### 7.1 DEBUG SQL


**​含义:​**在 SQL 查询语句开头添加 debug 关键字,执行时将输出 debug 日志,包括涉及到的底层文件 scan 信息。
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -611,9 +611,51 @@ localOrClusterMode
IoTDB> STOP REPAIR DATA ON CLUSTER;
```

## 5. 终止查询
## 5. 副本修复

### 5.1 主动终止查询
> 该功能从 V2.0.11 起支持传入 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 主动终止查询

**含义**:使用该命令主动地终止查询。

Expand Down Expand Up @@ -643,9 +685,9 @@ IoTDB> KILL ALL QUERIES; -- 终止所有query
```


## 6. 调试查询
## 7. 调试查询

### 6.1 DEBUG SQL
### 7.1 DEBUG SQL


**​含义:​**在 SQL 查询语句开头添加 debug 关键字,执行时将输出 debug 日志,包括涉及到的底层文件 scan 信息。
Expand Down
Loading