Skip to content

Commit acc1301

Browse files
authored
add show regions ton maintenance statements (#866)
1 parent 36bd425 commit acc1301

File tree

16 files changed

+509
-0
lines changed

16 files changed

+509
-0
lines changed

src/UserGuide/Master/Table/SQL-Manual/SQL-Maintenance-Statements.md

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -194,6 +194,38 @@ IoTDB> SHOW CURRENT_TIMESTAMP
194194
+-----------------------------+
195195
```
196196

197+
198+
### 1.8 Viewing Region Information
199+
200+
**Description**: Displays regions' information of the current cluster.
201+
202+
**Syntax**:
203+
204+
```SQL
205+
showRegionsStatement
206+
: SHOW REGIONS
207+
;
208+
```
209+
210+
**Example**:
211+
212+
```SQL
213+
IoTDB> SHOW REGIONS
214+
```
215+
216+
**Result**:
217+
218+
```SQL
219+
+--------+------------+-------+----------+-------------+-----------+----------+----------+-------+---------------+------+-----------------------+----------+
220+
|RegionId| Type| Status| Database|SeriesSlotNum|TimeSlotNum|DataNodeId|RpcAddress|RpcPort|InternalAddress| Role| CreateTime|TsFileSize|
221+
+--------+------------+-------+----------+-------------+-----------+----------+----------+-------+---------------+------+-----------------------+----------+
222+
| 6|SchemaRegion|Running|tcollector| 670| 0| 1| 0.0.0.0| 6667| 127.0.0.1|Leader|2025-08-01T17:37:01.194| |
223+
| 7| DataRegion|Running|tcollector| 335| 335| 1| 0.0.0.0| 6667| 127.0.0.1|Leader|2025-08-01T17:37:01.196| 169.85 KB|
224+
| 8| DataRegion|Running|tcollector| 335| 335| 1| 0.0.0.0| 6667| 127.0.0.1|Leader|2025-08-01T17:37:01.198| 161.63 KB|
225+
+--------+------------+-------+----------+-------------+-----------+----------+----------+-------+---------------+------+-----------------------+----------+
226+
```
227+
228+
197229
## 2. Status Configuration
198230

199231
### 2.1 Set Connection Tree/Table Model

src/UserGuide/Master/Table/User-Manual/Maintenance-commands.md

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -306,6 +306,38 @@ IoTDB> SHOW QUERIES WHERE elapsed_time > 30;
306306
+-----------------------+-----------------------------+-----------+------------+------------+----+
307307
```
308308

309+
310+
### 1.9 Viewing Region Information
311+
312+
**Description**: Displays regions' information of the current cluster.
313+
314+
**Syntax**:
315+
316+
```SQL
317+
showRegionsStatement
318+
: SHOW REGIONS
319+
;
320+
```
321+
322+
**Example**:
323+
324+
```SQL
325+
IoTDB> SHOW REGIONS
326+
```
327+
328+
**Result**:
329+
330+
```SQL
331+
+--------+------------+-------+----------+-------------+-----------+----------+----------+-------+---------------+------+-----------------------+----------+
332+
|RegionId| Type| Status| Database|SeriesSlotNum|TimeSlotNum|DataNodeId|RpcAddress|RpcPort|InternalAddress| Role| CreateTime|TsFileSize|
333+
+--------+------------+-------+----------+-------------+-----------+----------+----------+-------+---------------+------+-----------------------+----------+
334+
| 6|SchemaRegion|Running|tcollector| 670| 0| 1| 0.0.0.0| 6667| 127.0.0.1|Leader|2025-08-01T17:37:01.194| |
335+
| 7| DataRegion|Running|tcollector| 335| 335| 1| 0.0.0.0| 6667| 127.0.0.1|Leader|2025-08-01T17:37:01.196| 169.85 KB|
336+
| 8| DataRegion|Running|tcollector| 335| 335| 1| 0.0.0.0| 6667| 127.0.0.1|Leader|2025-08-01T17:37:01.198| 161.63 KB|
337+
+--------+------------+-------+----------+-------------+-----------+----------+----------+-------+---------------+------+-----------------------+----------+
338+
```
339+
340+
309341
## 2. Status Setting
310342

311343
### 2.1 Setting the Connected Model

src/UserGuide/Master/Tree/User-Manual/Maintenance-commands.md

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -213,6 +213,38 @@ IoTDB> SHOW QUERIES WHERE elapsedtime > 0.003
213213
```
214214

215215

216+
### 1.6 Viewing Region Information
217+
218+
**Description**: Displays regions' information of the current cluster.
219+
220+
**Syntax**:
221+
222+
```SQL
223+
showRegionsStatement
224+
: SHOW REGIONS
225+
;
226+
```
227+
228+
**Example**:
229+
230+
```SQL
231+
IoTDB> SHOW REGIONS
232+
```
233+
234+
**Result**:
235+
236+
```SQL
237+
+--------+------------+-------+-------------+-------------+-----------+----------+----------+-------+---------------+------+-----------------------+----------+
238+
|RegionId| Type| Status| Database|SeriesSlotNum|TimeSlotNum|DataNodeId|RpcAddress|RpcPort|InternalAddress| Role| CreateTime|TsFileSize|
239+
+--------+------------+-------+-------------+-------------+-----------+----------+----------+-------+---------------+------+-----------------------+----------+
240+
| 9|SchemaRegion|Running|root.__system| 21| 0| 1| 0.0.0.0| 6667| 127.0.0.1|Leader|2025-08-01T17:37:01.555| |
241+
| 10| DataRegion|Running|root.__system| 21| 21| 1| 0.0.0.0| 6667| 127.0.0.1|Leader|2025-08-01T17:37:01.556| 8.27 KB|
242+
| 65|SchemaRegion|Running| root.ln| 1| 0| 1| 0.0.0.0| 6667| 127.0.0.1|Leader|2025-08-25T14:46:50.113| |
243+
| 66| DataRegion|Running| root.ln| 1| 1| 1| 0.0.0.0| 6667| 127.0.0.1|Leader|2025-08-25T14:46:50.425| 524 B|
244+
+--------+------------+-------+-------------+-------------+-----------+----------+----------+-------+---------------+------+-----------------------+----------+
245+
```
246+
247+
216248
## 2. Status Setting
217249

218250
### 2.1 Setting the Connected Model

src/UserGuide/V1.3.x/User-Manual/Maintenance-commands.md

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -185,6 +185,38 @@ IoTDB> SHOW QUERIES WHERE elapsedtime > 0.003
185185
```
186186

187187

188+
### 1.5 Viewing Region Information
189+
190+
**Description**: Displays regions' information of the current cluster.
191+
192+
**Syntax**:
193+
194+
```SQL
195+
showRegionsStatement
196+
: SHOW REGIONS
197+
;
198+
```
199+
200+
**Example**:
201+
202+
```SQL
203+
IoTDB> SHOW REGIONS
204+
```
205+
206+
**Result**:
207+
208+
```SQL
209+
+--------+------------+-------+-------------+-------------+-----------+----------+----------+-------+---------------+------+-----------------------+----------+
210+
|RegionId| Type| Status| Database|SeriesSlotNum|TimeSlotNum|DataNodeId|RpcAddress|RpcPort|InternalAddress| Role| CreateTime|TsFileSize|
211+
+--------+------------+-------+-------------+-------------+-----------+----------+----------+-------+---------------+------+-----------------------+----------+
212+
| 9|SchemaRegion|Running|root.__system| 21| 0| 1| 0.0.0.0| 6667| 127.0.0.1|Leader|2025-08-01T17:37:01.555| |
213+
| 10| DataRegion|Running|root.__system| 21| 21| 1| 0.0.0.0| 6667| 127.0.0.1|Leader|2025-08-01T17:37:01.556| 8.27 KB|
214+
| 65|SchemaRegion|Running| root.ln| 1| 0| 1| 0.0.0.0| 6667| 127.0.0.1|Leader|2025-08-25T14:46:50.113| |
215+
| 66| DataRegion|Running| root.ln| 1| 1| 1| 0.0.0.0| 6667| 127.0.0.1|Leader|2025-08-25T14:46:50.425| 524 B|
216+
+--------+------------+-------+-------------+-------------+-----------+----------+----------+-------+---------------+------+-----------------------+----------+
217+
```
218+
219+
188220
## 2. Status Setting
189221

190222
### 2.1 Updating Configuration Items

src/UserGuide/dev-1.3/User-Manual/Maintenance-commands.md

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -185,6 +185,38 @@ IoTDB> SHOW QUERIES WHERE elapsedtime > 0.003
185185
```
186186

187187

188+
### 1.5 Viewing Region Information
189+
190+
**Description**: Displays regions' information of the current cluster.
191+
192+
**Syntax**:
193+
194+
```SQL
195+
showRegionsStatement
196+
: SHOW REGIONS
197+
;
198+
```
199+
200+
**Example**:
201+
202+
```SQL
203+
IoTDB> SHOW REGIONS
204+
```
205+
206+
**Result**:
207+
208+
```SQL
209+
+--------+------------+-------+-------------+-------------+-----------+----------+----------+-------+---------------+------+-----------------------+----------+
210+
|RegionId| Type| Status| Database|SeriesSlotNum|TimeSlotNum|DataNodeId|RpcAddress|RpcPort|InternalAddress| Role| CreateTime|TsFileSize|
211+
+--------+------------+-------+-------------+-------------+-----------+----------+----------+-------+---------------+------+-----------------------+----------+
212+
| 9|SchemaRegion|Running|root.__system| 21| 0| 1| 0.0.0.0| 6667| 127.0.0.1|Leader|2025-08-01T17:37:01.555| |
213+
| 10| DataRegion|Running|root.__system| 21| 21| 1| 0.0.0.0| 6667| 127.0.0.1|Leader|2025-08-01T17:37:01.556| 8.27 KB|
214+
| 65|SchemaRegion|Running| root.ln| 1| 0| 1| 0.0.0.0| 6667| 127.0.0.1|Leader|2025-08-25T14:46:50.113| |
215+
| 66| DataRegion|Running| root.ln| 1| 1| 1| 0.0.0.0| 6667| 127.0.0.1|Leader|2025-08-25T14:46:50.425| 524 B|
216+
+--------+------------+-------+-------------+-------------+-----------+----------+----------+-------+---------------+------+-----------------------+----------+
217+
```
218+
219+
188220
## 2. Status Setting
189221

190222
### 2.1 Updating Configuration Items

src/UserGuide/latest-Table/SQL-Manual/SQL-Maintenance-Statements.md

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -194,6 +194,38 @@ IoTDB> SHOW CURRENT_TIMESTAMP
194194
+-----------------------------+
195195
```
196196

197+
198+
### 1.8 Viewing Region Information
199+
200+
**Description**: Displays regions' information of the current cluster.
201+
202+
**Syntax**:
203+
204+
```SQL
205+
showRegionsStatement
206+
: SHOW REGIONS
207+
;
208+
```
209+
210+
**Example**:
211+
212+
```SQL
213+
IoTDB> SHOW REGIONS
214+
```
215+
216+
**Result**:
217+
218+
```SQL
219+
+--------+------------+-------+----------+-------------+-----------+----------+----------+-------+---------------+------+-----------------------+----------+
220+
|RegionId| Type| Status| Database|SeriesSlotNum|TimeSlotNum|DataNodeId|RpcAddress|RpcPort|InternalAddress| Role| CreateTime|TsFileSize|
221+
+--------+------------+-------+----------+-------------+-----------+----------+----------+-------+---------------+------+-----------------------+----------+
222+
| 6|SchemaRegion|Running|tcollector| 670| 0| 1| 0.0.0.0| 6667| 127.0.0.1|Leader|2025-08-01T17:37:01.194| |
223+
| 7| DataRegion|Running|tcollector| 335| 335| 1| 0.0.0.0| 6667| 127.0.0.1|Leader|2025-08-01T17:37:01.196| 169.85 KB|
224+
| 8| DataRegion|Running|tcollector| 335| 335| 1| 0.0.0.0| 6667| 127.0.0.1|Leader|2025-08-01T17:37:01.198| 161.63 KB|
225+
+--------+------------+-------+----------+-------------+-----------+----------+----------+-------+---------------+------+-----------------------+----------+
226+
```
227+
228+
197229
## 2. Status Configuration
198230

199231
### 2.1 Set Connection Tree/Table Model

src/UserGuide/latest-Table/User-Manual/Maintenance-commands.md

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -307,6 +307,37 @@ IoTDB> SHOW QUERIES WHERE elapsed_time > 30;
307307
```
308308

309309

310+
### 1.9 Viewing Region Information
311+
312+
**Description**: Displays regions' information of the current cluster.
313+
314+
**Syntax**:
315+
316+
```SQL
317+
showRegionsStatement
318+
: SHOW REGIONS
319+
;
320+
```
321+
322+
**Example**:
323+
324+
```SQL
325+
IoTDB> SHOW REGIONS
326+
```
327+
328+
**Result**:
329+
330+
```SQL
331+
+--------+------------+-------+----------+-------------+-----------+----------+----------+-------+---------------+------+-----------------------+----------+
332+
|RegionId| Type| Status| Database|SeriesSlotNum|TimeSlotNum|DataNodeId|RpcAddress|RpcPort|InternalAddress| Role| CreateTime|TsFileSize|
333+
+--------+------------+-------+----------+-------------+-----------+----------+----------+-------+---------------+------+-----------------------+----------+
334+
| 6|SchemaRegion|Running|tcollector| 670| 0| 1| 0.0.0.0| 6667| 127.0.0.1|Leader|2025-08-01T17:37:01.194| |
335+
| 7| DataRegion|Running|tcollector| 335| 335| 1| 0.0.0.0| 6667| 127.0.0.1|Leader|2025-08-01T17:37:01.196| 169.85 KB|
336+
| 8| DataRegion|Running|tcollector| 335| 335| 1| 0.0.0.0| 6667| 127.0.0.1|Leader|2025-08-01T17:37:01.198| 161.63 KB|
337+
+--------+------------+-------+----------+-------------+-----------+----------+----------+-------+---------------+------+-----------------------+----------+
338+
```
339+
340+
310341
## 2. Status Setting
311342

312343
### 2.1 Setting the Connected Model

src/UserGuide/latest/User-Manual/Maintenance-commands.md

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -212,6 +212,37 @@ IoTDB> SHOW QUERIES WHERE elapsedtime > 0.003
212212
+-----------------------------+-----------------------+----------+-----------+--------------------------------------+
213213
```
214214

215+
### 1.6 Viewing Region Information
216+
217+
**Description**: Displays regions' information of the current cluster.
218+
219+
**Syntax**:
220+
221+
```SQL
222+
showRegionsStatement
223+
: SHOW REGIONS
224+
;
225+
```
226+
227+
**Example**:
228+
229+
```SQL
230+
IoTDB> SHOW REGIONS
231+
```
232+
233+
**Result**:
234+
235+
```SQL
236+
+--------+------------+-------+-------------+-------------+-----------+----------+----------+-------+---------------+------+-----------------------+----------+
237+
|RegionId| Type| Status| Database|SeriesSlotNum|TimeSlotNum|DataNodeId|RpcAddress|RpcPort|InternalAddress| Role| CreateTime|TsFileSize|
238+
+--------+------------+-------+-------------+-------------+-----------+----------+----------+-------+---------------+------+-----------------------+----------+
239+
| 9|SchemaRegion|Running|root.__system| 21| 0| 1| 0.0.0.0| 6667| 127.0.0.1|Leader|2025-08-01T17:37:01.555| |
240+
| 10| DataRegion|Running|root.__system| 21| 21| 1| 0.0.0.0| 6667| 127.0.0.1|Leader|2025-08-01T17:37:01.556| 8.27 KB|
241+
| 65|SchemaRegion|Running| root.ln| 1| 0| 1| 0.0.0.0| 6667| 127.0.0.1|Leader|2025-08-25T14:46:50.113| |
242+
| 66| DataRegion|Running| root.ln| 1| 1| 1| 0.0.0.0| 6667| 127.0.0.1|Leader|2025-08-25T14:46:50.425| 524 B|
243+
+--------+------------+-------+-------------+-------------+-----------+----------+----------+-------+---------------+------+-----------------------+----------+
244+
```
245+
215246

216247
## 2. Status Setting
217248

src/zh/UserGuide/Master/Table/SQL-Manual/SQL-Maintenance-Statements.md

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -194,6 +194,38 @@ IoTDB> SHOW CURRENT_TIMESTAMP
194194
+-----------------------------+
195195
```
196196

197+
198+
### 1.8 查看分区信息
199+
200+
**含义**:返回当前集群的分区信息。
201+
202+
#### 语法:
203+
204+
```SQL
205+
showRegionsStatement
206+
: SHOW REGIONS
207+
;
208+
```
209+
210+
#### 示例:
211+
212+
```SQL
213+
IoTDB> SHOW REGIONS
214+
```
215+
216+
执行结果如下:
217+
218+
```SQL
219+
+--------+------------+-------+----------+-------------+-----------+----------+----------+-------+---------------+------+-----------------------+----------+
220+
|RegionId| Type| Status| Database|SeriesSlotNum|TimeSlotNum|DataNodeId|RpcAddress|RpcPort|InternalAddress| Role| CreateTime|TsFileSize|
221+
+--------+------------+-------+----------+-------------+-----------+----------+----------+-------+---------------+------+-----------------------+----------+
222+
| 6|SchemaRegion|Running|tcollector| 670| 0| 1| 0.0.0.0| 6667| 127.0.0.1|Leader|2025-08-01T17:37:01.194| |
223+
| 7| DataRegion|Running|tcollector| 335| 335| 1| 0.0.0.0| 6667| 127.0.0.1|Leader|2025-08-01T17:37:01.196| 169.85 KB|
224+
| 8| DataRegion|Running|tcollector| 335| 335| 1| 0.0.0.0| 6667| 127.0.0.1|Leader|2025-08-01T17:37:01.198| 161.63 KB|
225+
+--------+------------+-------+----------+-------------+-----------+----------+----------+-------+---------------+------+-----------------------+----------+
226+
```
227+
228+
197229
## 2. 状态设置
198230

199231
### 2.1 设置连接的树/表模型

src/zh/UserGuide/Master/Table/User-Manual/Maintenance-statement.md

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -306,6 +306,38 @@ IoTDB> SHOW QUERIES WHERE elapsed_time > 30
306306
+-----------------------+-----------------------------+-----------+------------+------------+----+
307307
```
308308

309+
310+
### 1.9 查看分区信息
311+
312+
**含义**:返回当前集群的分区信息。
313+
314+
#### 语法:
315+
316+
```SQL
317+
showRegionsStatement
318+
: SHOW REGIONS
319+
;
320+
```
321+
322+
#### 示例:
323+
324+
```SQL
325+
IoTDB> SHOW REGIONS
326+
```
327+
328+
执行结果如下:
329+
330+
```SQL
331+
+--------+------------+-------+----------+-------------+-----------+----------+----------+-------+---------------+------+-----------------------+----------+
332+
|RegionId| Type| Status| Database|SeriesSlotNum|TimeSlotNum|DataNodeId|RpcAddress|RpcPort|InternalAddress| Role| CreateTime|TsFileSize|
333+
+--------+------------+-------+----------+-------------+-----------+----------+----------+-------+---------------+------+-----------------------+----------+
334+
| 6|SchemaRegion|Running|tcollector| 670| 0| 1| 0.0.0.0| 6667| 127.0.0.1|Leader|2025-08-01T17:37:01.194| |
335+
| 7| DataRegion|Running|tcollector| 335| 335| 1| 0.0.0.0| 6667| 127.0.0.1|Leader|2025-08-01T17:37:01.196| 169.85 KB|
336+
| 8| DataRegion|Running|tcollector| 335| 335| 1| 0.0.0.0| 6667| 127.0.0.1|Leader|2025-08-01T17:37:01.198| 161.63 KB|
337+
+--------+------------+-------+----------+-------------+-----------+----------+----------+-------+---------------+------+-----------------------+----------+
338+
```
339+
340+
309341
## 2. 状态设置
310342

311343
### 2.1 设置连接的模型

0 commit comments

Comments
 (0)