Skip to content

Update show queries columns in docs #1180

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
HTHou merged 1 commit into from
Jul 9, 2026
Merged

Update show queries columns in docs #1180

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
13 changes: 8 additions & 5 deletions src/UserGuide/Master/Table/Reference/System-Tables_apache.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -191,17 +191,20 @@ IoTDB> select * from information_schema.regions
| `elapsed_time` | FLOAT | ATTRIBUTE | Query execution duration (in seconds) |
| `statement` | STRING | ATTRIBUTE | SQL statement of the query |
| `user` | STRING | ATTRIBUTE | User who initiated the query |
| `wait_time_in_server` | FLOAT | ATTRIBUTE | Cumulative time that the client request waits in the server for results to be returned, in seconds (supported since V2.0.10) |
| `client_ip` | STRING | ATTRIBUTE | IP address of the client that initiated the query (supported since V2.0.10) |
| `timeout` | INT64 | ATTRIBUTE | Timeout of the query, in ms (supported since V2.0.10) |

* For regular users, the query results only display the queries executed by themselves; for administrators, all queries are displayed.
* Query Example:

```SQL
IoTDB> select * from information_schema.queries
+-----------------------+-----------------------------+-----------+------------+----------------------------------------+----+
| query_id| start_time|datanode_id|elapsed_time| statement|user|
+-----------------------+-----------------------------+-----------+------------+----------------------------------------+----+
|20250331_023242_00011_1|2025-03-31T10:32:42.360+08:00| 1| 0.025|select * from information_schema.queries|root|
+-----------------------+-----------------------------+-----------+------------+----------------------------------------+----+
+-----------------------+-----------------------------+-----------+------------+----------------------------------------+----+-------------------+---------+-------+
| query_id| start_time|datanode_id|elapsed_time| statement|user|wait_time_in_server|client_ip|timeout|
+-----------------------+-----------------------------+-----------+------------+----------------------------------------+----+-------------------+---------+-------+
|20260601_032216_00018_1|2026-06-01T11:22:16.815+08:00| 1| 0.014|select * from information_schema.queries|root| 0.0158324|127.0.0.1| 60000|
+-----------------------+-----------------------------+-----------+------------+----------------------------------------+----+-------------------+---------+-------+
```

### 2.5 COLUMNS
Expand Down
12 changes: 6 additions & 6 deletions src/UserGuide/Master/Table/SQL-Manual/SQL-Maintenance-Statements_apache.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -459,12 +459,12 @@ showQueriesStatement
**Example:**

```SQL
IoTDB> SHOW QUERIES WHERE elapsed_time > 30
+-----------------------+-----------------------------+-----------+------------+------------+----+
| query_id| start_time|datanode_id|elapsed_time| statement|user|
+-----------------------+-----------------------------+-----------+------------+------------+----+
|20250108_101015_00000_1|2025-01-08T18:10:15.935+08:00| 1| 32.283|show queries|root|
+-----------------------+-----------------------------+-----------+------------+------------+----+
IoTDB> SHOW QUERIES WHERE elapsed_time > 0.003
+-----------------------+-----------------------------+-----------+------------+---------------------------------------+----+-------------------+---------+-------+
| query_id| start_time|datanode_id|elapsed_time| statement|user|wait_time_in_server|client_ip|timeout|
+-----------------------+-----------------------------+-----------+------------+---------------------------------------+----+-------------------+---------+-------+
|20260601_032051_00016_1|2026-06-01T11:20:51.130+08:00| 1| 0.017|SHOW QUERIES WHERE elapsed_time > 0.003|root| 0.0190219|127.0.0.1| 60000|
+-----------------------+-----------------------------+-----------+------------+---------------------------------------+----+-------------------+---------+-------+
```

### 5.2 Terminate Queries
Expand Down
15 changes: 9 additions & 6 deletions src/UserGuide/Master/Table/User-Manual/Maintenance-commands_apache.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -289,21 +289,24 @@ showQueriesStatement
- **elapsed_time**: Time elapsed since the query started (in seconds).
- **statement**: The SQL statement being executed.
- **user**: The user who initiated the query.
- **wait_time_in_server**: Cumulative time that the client request waits in the server for results to be returned, in seconds (supported since V2.0.10).
- **client_ip**: IP address of the client that initiated the query (supported since V2.0.10).
- **timeout**: Timeout of the query, in ms (supported since V2.0.10).

**Example**:

```SQL
IoTDB> SHOW QUERIES WHERE elapsed_time > 30;
IoTDB> SHOW QUERIES WHERE elapsed_time > 0.003
```

**Result**:

```Plain
+-----------------------+-----------------------------+-----------+------------+------------+----+
| query_id| start_time|datanode_id|elapsed_time| statement|user|
+-----------------------+-----------------------------+-----------+------------+------------+----+
|20250108_101015_00000_1|2025-01-08T18:10:15.935+08:00| 1| 32.283|show queries|root|
+-----------------------+-----------------------------+-----------+------------+------------+----+
+-----------------------+-----------------------------+-----------+------------+---------------------------------------+----+-------------------+---------+-------+
| query_id| start_time|datanode_id|elapsed_time| statement|user|wait_time_in_server|client_ip|timeout|
+-----------------------+-----------------------------+-----------+------------+---------------------------------------+----+-------------------+---------+-------+
|20260601_032051_00016_1|2026-06-01T11:20:51.130+08:00| 1| 0.017|SHOW QUERIES WHERE elapsed_time > 0.003|root| 0.0190219|127.0.0.1| 60000|
+-----------------------+-----------------------------+-----------+------------+---------------------------------------+----+-------------------+---------+-------+
```


Expand Down
13 changes: 8 additions & 5 deletions src/UserGuide/Master/Tree/User-Manual/Maintenance-commands_apache.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -195,6 +195,9 @@ showQueriesStatement
- **datanodeid**: ID of the DataNode executing the query.
- **elapsedtime**: Time elapsed since the query started (in seconds).
- **statement**: The SQL statement being executed.
- **WaitTimeInServer**: Cumulative time that the client request waits in the server for results to be returned, in seconds (supported since V2.0.10).
- **ClientIp**: IP address of the client that initiated the query (supported since V2.0.10).
- **Timeout**: Timeout of the query, in ms (supported since V2.0.10).

**Example**:

Expand All @@ -205,11 +208,11 @@ IoTDB> SHOW QUERIES WHERE elapsedtime > 0.003
**Result**:

```SQL
+-----------------------------+-----------------------+----------+-----------+--------------------------------------+
| Time| QueryId|DataNodeId|ElapsedTime| Statement|
+-----------------------------+-----------------------+----------+-----------+--------------------------------------+
|2025-05-09T15:16:01.293+08:00|20250509_071601_00015_1| 1| 0.006|SHOW QUERIES WHERE elapsedtime > 0.003|
+-----------------------------+-----------------------+----------+-----------+--------------------------------------+
+-----------------------------+-----------------------+----------+-----------+--------------------------------------+----------------+---------+-------+
| Time| QueryId|DataNodeId|ElapsedTime| Statement|WaitTimeInServer| ClientIp|Timeout|
+-----------------------------+-----------------------+----------+-----------+--------------------------------------+----------------+---------+-------+
|2026-06-01T11:13:39.057+08:00|20260601_031339_00003_1| 1| 0.074|SHOW QUERIES WHERE elapsedtime > 0.003| 0.0736961|127.0.0.1| 60000|
+-----------------------------+-----------------------+----------+-----------+--------------------------------------+----------------+---------+-------+
```

### 1.6 Viewing Region Information
Expand Down
13 changes: 8 additions & 5 deletions src/UserGuide/latest-Table/Reference/System-Tables_apache.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -191,17 +191,20 @@ IoTDB> select * from information_schema.regions
| `elapsed_time` | FLOAT | ATTRIBUTE | Query execution duration (in seconds) |
| `statement` | STRING | ATTRIBUTE | SQL statement of the query |
| `user` | STRING | ATTRIBUTE | User who initiated the query |
| `wait_time_in_server` | FLOAT | ATTRIBUTE | Cumulative time that the client request waits in the server for results to be returned, in seconds (supported since V2.0.10) |
| `client_ip` | STRING | ATTRIBUTE | IP address of the client that initiated the query (supported since V2.0.10) |
| `timeout` | INT64 | ATTRIBUTE | Timeout of the query, in ms (supported since V2.0.10) |

* For regular users, the query results only display the queries executed by themselves; for administrators, all queries are displayed.
* Query Example:

```SQL
IoTDB> select * from information_schema.queries
+-----------------------+-----------------------------+-----------+------------+----------------------------------------+----+
| query_id| start_time|datanode_id|elapsed_time| statement|user|
+-----------------------+-----------------------------+-----------+------------+----------------------------------------+----+
|20250331_023242_00011_1|2025-03-31T10:32:42.360+08:00| 1| 0.025|select * from information_schema.queries|root|
+-----------------------+-----------------------------+-----------+------------+----------------------------------------+----+
+-----------------------+-----------------------------+-----------+------------+----------------------------------------+----+-------------------+---------+-------+
| query_id| start_time|datanode_id|elapsed_time| statement|user|wait_time_in_server|client_ip|timeout|
+-----------------------+-----------------------------+-----------+------------+----------------------------------------+----+-------------------+---------+-------+
|20260601_032216_00018_1|2026-06-01T11:22:16.815+08:00| 1| 0.014|select * from information_schema.queries|root| 0.0158324|127.0.0.1| 60000|
+-----------------------+-----------------------------+-----------+------------+----------------------------------------+----+-------------------+---------+-------+
```

### 2.5 COLUMNS
Expand Down
12 changes: 6 additions & 6 deletions src/UserGuide/latest-Table/SQL-Manual/SQL-Maintenance-Statements_apache.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -459,12 +459,12 @@ showQueriesStatement
**Example:**

```SQL
IoTDB> SHOW QUERIES WHERE elapsed_time > 30
+-----------------------+-----------------------------+-----------+------------+------------+----+
| query_id| start_time|datanode_id|elapsed_time| statement|user|
+-----------------------+-----------------------------+-----------+------------+------------+----+
|20250108_101015_00000_1|2025-01-08T18:10:15.935+08:00| 1| 32.283|show queries|root|
+-----------------------+-----------------------------+-----------+------------+------------+----+
IoTDB> SHOW QUERIES WHERE elapsed_time > 0.003
+-----------------------+-----------------------------+-----------+------------+---------------------------------------+----+-------------------+---------+-------+
| query_id| start_time|datanode_id|elapsed_time| statement|user|wait_time_in_server|client_ip|timeout|
+-----------------------+-----------------------------+-----------+------------+---------------------------------------+----+-------------------+---------+-------+
|20260601_032051_00016_1|2026-06-01T11:20:51.130+08:00| 1| 0.017|SHOW QUERIES WHERE elapsed_time > 0.003|root| 0.0190219|127.0.0.1| 60000|
+-----------------------+-----------------------------+-----------+------------+---------------------------------------+----+-------------------+---------+-------+
```

### 5.2 Terminate Queries
Expand Down
15 changes: 9 additions & 6 deletions src/UserGuide/latest-Table/User-Manual/Maintenance-commands_apache.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -289,21 +289,24 @@ showQueriesStatement
- **elapsed_time**: Time elapsed since the query started (in seconds).
- **statement**: The SQL statement being executed.
- **user**: The user who initiated the query.
- **wait_time_in_server**: Cumulative time that the client request waits in the server for results to be returned, in seconds (supported since V2.0.10).
- **client_ip**: IP address of the client that initiated the query (supported since V2.0.10).
- **timeout**: Timeout of the query, in ms (supported since V2.0.10).

**Example**:

```SQL
IoTDB> SHOW QUERIES WHERE elapsed_time > 30;
IoTDB> SHOW QUERIES WHERE elapsed_time > 0.003
```

**Result**:

```Plain
+-----------------------+-----------------------------+-----------+------------+------------+----+
| query_id| start_time|datanode_id|elapsed_time| statement|user|
+-----------------------+-----------------------------+-----------+------------+------------+----+
|20250108_101015_00000_1|2025-01-08T18:10:15.935+08:00| 1| 32.283|show queries|root|
+-----------------------+-----------------------------+-----------+------------+------------+----+
+-----------------------+-----------------------------+-----------+------------+---------------------------------------+----+-------------------+---------+-------+
| query_id| start_time|datanode_id|elapsed_time| statement|user|wait_time_in_server|client_ip|timeout|
+-----------------------+-----------------------------+-----------+------------+---------------------------------------+----+-------------------+---------+-------+
|20260601_032051_00016_1|2026-06-01T11:20:51.130+08:00| 1| 0.017|SHOW QUERIES WHERE elapsed_time > 0.003|root| 0.0190219|127.0.0.1| 60000|
+-----------------------+-----------------------------+-----------+------------+---------------------------------------+----+-------------------+---------+-------+
```


Expand Down
13 changes: 8 additions & 5 deletions src/UserGuide/latest/User-Manual/Maintenance-commands_apache.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -195,6 +195,9 @@ showQueriesStatement
- **datanodeid**: ID of the DataNode executing the query.
- **elapsedtime**: Time elapsed since the query started (in seconds).
- **statement**: The SQL statement being executed.
- **WaitTimeInServer**: Cumulative time that the client request waits in the server for results to be returned, in seconds (supported since V2.0.10).
- **ClientIp**: IP address of the client that initiated the query (supported since V2.0.10).
- **Timeout**: Timeout of the query, in ms (supported since V2.0.10).

**Example**:

Expand All @@ -205,11 +208,11 @@ IoTDB> SHOW QUERIES WHERE elapsedtime > 0.003
**Result**:

```SQL
+-----------------------------+-----------------------+----------+-----------+--------------------------------------+
| Time| QueryId|DataNodeId|ElapsedTime| Statement|
+-----------------------------+-----------------------+----------+-----------+--------------------------------------+
|2025-05-09T15:16:01.293+08:00|20250509_071601_00015_1| 1| 0.006|SHOW QUERIES WHERE elapsedtime > 0.003|
+-----------------------------+-----------------------+----------+-----------+--------------------------------------+
+-----------------------------+-----------------------+----------+-----------+--------------------------------------+----------------+---------+-------+
| Time| QueryId|DataNodeId|ElapsedTime| Statement|WaitTimeInServer| ClientIp|Timeout|
+-----------------------------+-----------------------+----------+-----------+--------------------------------------+----------------+---------+-------+
|2026-06-01T11:13:39.057+08:00|20260601_031339_00003_1| 1| 0.074|SHOW QUERIES WHERE elapsedtime > 0.003| 0.0736961|127.0.0.1| 60000|
+-----------------------------+-----------------------+----------+-----------+--------------------------------------+----------------+---------+-------+
```

### 1.6 Viewing Region Information
Expand Down
13 changes: 8 additions & 5 deletions src/zh/UserGuide/Master/Table/Reference/System-Tables_apache.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -191,17 +191,20 @@ IoTDB> select * from information_schema.regions
| elapsed\_time | FLOAT | ATTRIBUTE | 查询执行耗时，单位是秒 |
| statement | STRING | ATTRIBUTE | 查询sql |
| user | STRING | ATTRIBUTE | 发起查询的用户 |
| wait\_time\_in\_server | FLOAT | ATTRIBUTE | 客户端请求在 server 等待结果返回的累计耗时，单位 s（V2.0.10 起支持） |
| client\_ip | STRING | ATTRIBUTE | 发起查询的客户端 ip（V2.0.10 起支持） |
| timeout | INT64 | ATTRIBUTE | 该查询的超时时间，单位 ms（V2.0.10 起支持） |

* 普通用户查询结果仅显示自身执行的查询；管理员显示全部。
* 查询示例：

```SQL
IoTDB> select * from information_schema.queries
+-----------------------+-----------------------------+-----------+------------+----------------------------------------+----+
| query_id| start_time|datanode_id|elapsed_time| statement|user|
+-----------------------+-----------------------------+-----------+------------+----------------------------------------+----+
|20250331_023242_00011_1|2025-03-31T10:32:42.360+08:00| 1| 0.025|select * from information_schema.queries|root|
+-----------------------+-----------------------------+-----------+------------+----------------------------------------+----+
+-----------------------+-----------------------------+-----------+------------+----------------------------------------+----+-------------------+---------+-------+
| query_id| start_time|datanode_id|elapsed_time| statement|user|wait_time_in_server|client_ip|timeout|
+-----------------------+-----------------------------+-----------+------------+----------------------------------------+----+-------------------+---------+-------+
|20260601_032216_00018_1|2026-06-01T11:22:16.815+08:00| 1| 0.014|select * from information_schema.queries|root| 0.0158324|127.0.0.1| 60000|
+-----------------------+-----------------------------+-----------+------------+----------------------------------------+----+-------------------+---------+-------+
```

### 2.5 COLUMNS 表
Expand Down
12 changes: 6 additions & 6 deletions src/zh/UserGuide/Master/Table/SQL-Manual/SQL-Maintenance-Statements_apache.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -458,12 +458,12 @@ showQueriesStatement
**示例：**

```SQL
IoTDB> SHOW QUERIES WHERE elapsed_time > 30
+-----------------------+-----------------------------+-----------+------------+------------+----+
| query_id| start_time|datanode_id|elapsed_time| statement|user|
+-----------------------+-----------------------------+-----------+------------+------------+----+
|20250108_101015_00000_1|2025-01-08T18:10:15.935+08:00| 1| 32.283|show queries|root|
+-----------------------+-----------------------------+-----------+------------+------------+----+
IoTDB> SHOW QUERIES WHERE elapsed_time > 0.003
+-----------------------+-----------------------------+-----------+------------+---------------------------------------+----+-------------------+---------+-------+
| query_id| start_time|datanode_id|elapsed_time| statement|user|wait_time_in_server|client_ip|timeout|
+-----------------------+-----------------------------+-----------+------------+---------------------------------------+----+-------------------+---------+-------+
|20260601_032051_00016_1|2026-06-01T11:20:51.130+08:00| 1| 0.017|SHOW QUERIES WHERE elapsed_time > 0.003|root| 0.0190219|127.0.0.1| 60000|
+-----------------------+-----------------------------+-----------+------------+---------------------------------------+----+-------------------+---------+-------+
```

### 5.2 主动终止查询
Expand Down
Loading
Loading