[Doc] Add ExecState field documentation for show proc current_queries commands (#62926)

Co-authored-by: Claude <noreply@anthropic.com>
This commit is contained in:
kangkaisen 2025-09-10 18:40:15 +08:00 committed by GitHub
parent e3a2e73c2e
commit 855b911df1
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
4 changed files with 91 additions and 30 deletions

3
.gitignore vendored
View File

@ -92,3 +92,6 @@ be/tags
build/
cmake-build-debug/
CMakeLists.txt
.claude
CLAUDE.md

View File

@ -536,21 +536,40 @@ mysql> SHOW PROC '/replications';
```sql
MySQL > show proc '/current_queries';
+---------------------+---------------+--------------------------------------+--------------+----------+------+------------+--------------+-------------+---------------+----------+----------+-------------------+---------------+---------------+
| StartTime | feIp | QueryId | ConnectionId | Database | User | ScanBytes | ScanRows | MemoryUsage | DiskSpillSize | CPUTime | ExecTime | Warehouse | CustomQueryId | ResourceGroup |
+---------------------+---------------+--------------------------------------+--------------+----------+------+------------+--------------+-------------+---------------+----------+----------+-------------------+---------------+---------------+
| 2025-03-07 02:00:19 | 172.26.92.227 | ddbd69b9-fab4-11ef-8063-461f20abc3f0 | 11 | tpcds_2 | root | 120.573 MB | 5859503 rows | 296.432 MB | 0.000 B | 27.888 s | 3.153 s | default_warehouse | | rg1 |
+---------------------+---------------+--------------------------------------+--------------+----------+------+------------+--------------+-------------+---------------+----------+----------+-------------------+---------------+---------------+
+---------------------+---------------+--------------------------------------+--------------+----------+------+------------+--------------+-------------+---------------+----------+----------+-----------+-------------------+---------------+---------------+
| StartTime | feIp | QueryId | ConnectionId | Database | User | ScanBytes | ScanRows | MemoryUsage | DiskSpillSize | CPUTime | ExecTime | ExecState | Warehouse | CustomQueryId | ResourceGroup |
+---------------------+---------------+--------------------------------------+--------------+----------+------+------------+--------------+-------------+---------------+----------+----------+-----------+-------------------+---------------+---------------+
| 2025-03-07 02:00:19 | 172.26.92.227 | ddbd69b9-fab4-11ef-8063-461f20abc3f0 | 11 | tpcds_2 | root | 120.573 MB | 5859503 rows | 296.432 MB | 0.000 B | 27.888 s | 3.153 s | RUNNING | default_warehouse | | rg1 |
+---------------------+---------------+--------------------------------------+--------------+----------+------+------------+--------------+-------------+---------------+----------+----------+-----------+-------------------+---------------+---------------+
```
**Example 16: Shows the information of running queries on all FE nodes in the cluster.**
```sql
MySQL > show proc '/global_current_queries';
+---------------------+---------------+--------------------------------------+--------------+----------+------+------------+--------------+-------------+---------------+---------+----------+-------------------+---------------+---------------+
| StartTime | feIp | QueryId | ConnectionId | Database | User | ScanBytes | ScanRows | MemoryUsage | DiskSpillSize | CPUTime | ExecTime | Warehouse | CustomQueryId | ResourceGroup |
+---------------------+---------------+--------------------------------------+--------------+----------+------+------------+--------------+-------------+---------------+---------+----------+-------------------+---------------+---------------+
| 2025-03-07 02:02:47 | 172.26.92.227 | 3603d566-fab5-11ef-8063-461f20abc3f0 | 12 | tpcds_2 | root | 100.886 MB | 4899036 rows | 114.491 MB | 0.000 B | 5.700 s | 0.713 s | default_warehouse | | rg1 |
+---------------------+---------------+--------------------------------------+--------------+----------+------+------------+--------------+-------------+---------------+---------+----------+-------------------+---------------+---------------+
+---------------------+---------------+--------------------------------------+--------------+----------+------+------------+--------------+-------------+---------------+---------+----------+-----------+-------------------+---------------+---------------+
| StartTime | feIp | QueryId | ConnectionId | Database | User | ScanBytes | ScanRows | MemoryUsage | DiskSpillSize | CPUTime | ExecTime | ExecState | Warehouse | CustomQueryId | ResourceGroup |
+---------------------+---------------+--------------------------------------+--------------+----------+------+------------+--------------+-------------+---------------+---------+----------+-----------+-------------------+---------------+---------------+
| 2025-03-07 02:02:47 | 172.26.92.227 | 3603d566-fab5-11ef-8063-461f20abc3f0 | 12 | tpcds_2 | root | 100.886 MB | 4899036 rows | 114.491 MB | 0.000 B | 5.700 s | 0.713 s | RUNNING | default_warehouse | | rg1 |
+---------------------+---------------+--------------------------------------+--------------+----------+------+------------+--------------+-------------+---------------+---------+----------+-----------+-------------------+---------------+---------------+
| **Return** | **Description** |
| ------------ | ------------------------------------------------------------------- |
| StartTime | The time when the query started execution. |
| feIp | The IP address of the FE node processing the query. |
| QueryId | The unique identifier for the query. |
| ConnectionId | The connection ID associated with the query. |
| Database | The database where the query is executed. |
| User | The user who submitted the query. |
| ScanBytes | The amount of data scanned by the query. |
| ScanRows | The number of rows scanned by the query. |
| MemoryUsage | The current memory usage of the query. |
| DiskSpillSize| The amount of data spilled to disk during query execution. |
| CPUTime | The total CPU time consumed by the query. |
| ExecTime | The total execution time of the query. |
| ExecState | The execution state of the query. Valid values: `RUNNING`, `PENDING`. |
| Warehouse | The compute warehouse processing the query. |
| CustomQueryId| Custom query identifier if specified. |
| ResourceGroup| The resource group assigned to the query. |
```

View File

@ -537,20 +537,40 @@ mysql> SHOW PROC '/replications';
```sql
MySQL > show proc '/current_queries';
+---------------------+---------------+--------------------------------------+--------------+----------+------+------------+--------------+-------------+---------------+----------+----------+-------------------+---------------+---------------+
| StartTime | feIp | QueryId | ConnectionId | Database | User | ScanBytes | ScanRows | MemoryUsage | DiskSpillSize | CPUTime | ExecTime | Warehouse | CustomQueryId | ResourceGroup |
+---------------------+---------------+--------------------------------------+--------------+----------+------+------------+--------------+-------------+---------------+----------+----------+-------------------+---------------+---------------+
| 2025-03-07 02:00:19 | 172.26.92.227 | ddbd69b9-fab4-11ef-8063-461f20abc3f0 | 11 | tpcds_2 | root | 120.573 MB | 5859503 rows | 296.432 MB | 0.000 B | 27.888 s | 3.153 s | default_warehouse | | rg1 |
+---------------------+---------------+--------------------------------------+--------------+----------+------+------------+--------------+-------------+---------------+----------+----------+-------------------+---------------+---------------+
+---------------------+---------------+--------------------------------------+--------------+----------+------+------------+--------------+-------------+---------------+----------+----------+-----------+-------------------+---------------+---------------+
| StartTime | feIp | QueryId | ConnectionId | Database | User | ScanBytes | ScanRows | MemoryUsage | DiskSpillSize | CPUTime | ExecTime | ExecState | Warehouse | CustomQueryId | ResourceGroup |
+---------------------+---------------+--------------------------------------+--------------+----------+------+------------+--------------+-------------+---------------+----------+----------+-----------+-------------------+---------------+---------------+
| 2025-03-07 02:00:19 | 172.26.92.227 | ddbd69b9-fab4-11ef-8063-461f20abc3f0 | 11 | tpcds_2 | root | 120.573 MB | 5859503 rows | 296.432 MB | 0.000 B | 27.888 s | 3.153 s | RUNNING | default_warehouse | | rg1 |
+---------------------+---------------+--------------------------------------+--------------+----------+------+------------+--------------+-------------+---------------+----------+----------+-----------+-------------------+---------------+---------------+
```
**例 16: クラスター内のすべての FE ノードで実行中のクエリの情報を表示します。**
```sql
MySQL > show proc '/global_current_queries';
+---------------------+---------------+--------------------------------------+--------------+----------+------+------------+--------------+-------------+---------------+---------+----------+-------------------+---------------+---------------+
| StartTime | feIp | QueryId | ConnectionId | Database | User | ScanBytes | ScanRows | MemoryUsage | DiskSpillSize | CPUTime | ExecTime | Warehouse | CustomQueryId | ResourceGroup |
+---------------------+---------------+--------------------------------------+--------------+----------+------+------------+--------------+-------------+---------------+---------+----------+-------------------+---------------+---------------+
| 2025-03-07 02:02:47 | 172.26.92.227 | 3603d566-fab5-11ef-8063-461f20abc3f0 | 12 | tpcds_2 | root | 100.886 MB | 4899036 rows | 114.491 MB | 0.000 B | 5.700 s | 0.713 s | default_warehouse | | rg1 |
+---------------------+---------------+--------------------------------------+--------------+----------+------+------------+--------------+-------------+---------------+---------+----------+-------------------+---------------+---------------+
+---------------------+---------------+--------------------------------------+--------------+----------+------+------------+--------------+-------------+---------------+---------+----------+-----------+-------------------+---------------+---------------+
| StartTime | feIp | QueryId | ConnectionId | Database | User | ScanBytes | ScanRows | MemoryUsage | DiskSpillSize | CPUTime | ExecTime | ExecState | Warehouse | CustomQueryId | ResourceGroup |
+---------------------+---------------+--------------------------------------+--------------+----------+------+------------+--------------+-------------+---------------+---------+----------+-----------+-------------------+---------------+---------------+
| 2025-03-07 02:02:47 | 172.26.92.227 | 3603d566-fab5-11ef-8063-461f20abc3f0 | 12 | tpcds_2 | root | 100.886 MB | 4899036 rows | 114.491 MB | 0.000 B | 5.700 s | 0.713 s | RUNNING | default_warehouse | | rg1 |
+---------------------+---------------+--------------------------------------+--------------+----------+------+------------+--------------+-------------+---------------+---------+----------+-----------+-------------------+---------------+---------------+
| **戻り値** | **説明** |
| ---------------- | ----------------------------------------------------------- |
| StartTime | クエリの実行開始時刻。 |
| feIp | クエリを処理するFEードのIPアドレス。 |
| QueryId | クエリの一意識別子。 |
| ConnectionId | クエリに関連付けられた接続ID。 |
| Database | クエリが実行されるデータベース。 |
| User | クエリを送信したユーザー。 |
| ScanBytes | クエリによってスキャンされたデータ量。 |
| ScanRows | クエリによってスキャンされた行数。 |
| MemoryUsage | クエリの現在のメモリ使用量。 |
| DiskSpillSize | クエリ実行中にディスクに書き込まれたデータ量。 |
| CPUTime | クエリによって消費された総CPU時間。 |
| ExecTime | クエリの総実行時間。 |
| ExecState | クエリの実行状態。有効な値:`RUNNING`(実行中)、`PENDING`(待機中)。 |
| Warehouse | クエリを処理するコンピュートウェアハウス。 |
| CustomQueryId | カスタムクエリ識別子(指定された場合)。 |
| ResourceGroup | クエリに割り当てられたリソースグループ。 |
```

View File

@ -536,21 +536,40 @@ mysql> SHOW PROC '/replications';
```sql
MySQL > show proc '/current_queries';
+---------------------+---------------+--------------------------------------+--------------+----------+------+------------+--------------+-------------+---------------+----------+----------+-------------------+---------------+---------------+
| StartTime | feIp | QueryId | ConnectionId | Database | User | ScanBytes | ScanRows | MemoryUsage | DiskSpillSize | CPUTime | ExecTime | Warehouse | CustomQueryId | ResourceGroup |
+---------------------+---------------+--------------------------------------+--------------+----------+------+------------+--------------+-------------+---------------+----------+----------+-------------------+---------------+---------------+
| 2025-03-07 02:00:19 | 172.26.92.227 | ddbd69b9-fab4-11ef-8063-461f20abc3f0 | 11 | tpcds_2 | root | 120.573 MB | 5859503 rows | 296.432 MB | 0.000 B | 27.888 s | 3.153 s | default_warehouse | | rg1 |
+---------------------+---------------+--------------------------------------+--------------+----------+------+------------+--------------+-------------+---------------+----------+----------+-------------------+---------------+---------------+
+---------------------+---------------+--------------------------------------+--------------+----------+------+------------+--------------+-------------+---------------+----------+----------+-----------+-------------------+---------------+---------------+
| StartTime | feIp | QueryId | ConnectionId | Database | User | ScanBytes | ScanRows | MemoryUsage | DiskSpillSize | CPUTime | ExecTime | ExecState | Warehouse | CustomQueryId | ResourceGroup |
+---------------------+---------------+--------------------------------------+--------------+----------+------+------------+--------------+-------------+---------------+----------+----------+-----------+-------------------+---------------+---------------+
| 2025-03-07 02:00:19 | 172.26.92.227 | ddbd69b9-fab4-11ef-8063-461f20abc3f0 | 11 | tpcds_2 | root | 120.573 MB | 5859503 rows | 296.432 MB | 0.000 B | 27.888 s | 3.153 s | RUNNING | default_warehouse | | rg1 |
+---------------------+---------------+--------------------------------------+--------------+----------+------+------------+--------------+-------------+---------------+----------+----------+-----------+-------------------+---------------+---------------+
```
**示例十六查询当前集群所有FE节点正在执行的查询信息。**
```sql
MySQL > show proc '/global_current_queries';
+---------------------+---------------+--------------------------------------+--------------+----------+------+------------+--------------+-------------+---------------+---------+----------+-------------------+---------------+---------------+
| StartTime | feIp | QueryId | ConnectionId | Database | User | ScanBytes | ScanRows | MemoryUsage | DiskSpillSize | CPUTime | ExecTime | Warehouse | CustomQueryId | ResourceGroup |
+---------------------+---------------+--------------------------------------+--------------+----------+------+------------+--------------+-------------+---------------+---------+----------+-------------------+---------------+---------------+
| 2025-03-07 02:02:47 | 172.26.92.227 | 3603d566-fab5-11ef-8063-461f20abc3f0 | 12 | tpcds_2 | root | 100.886 MB | 4899036 rows | 114.491 MB | 0.000 B | 5.700 s | 0.713 s | default_warehouse | | rg1 |
+---------------------+---------------+--------------------------------------+--------------+----------+------+------------+--------------+-------------+---------------+---------+----------+-------------------+---------------+---------------+
+---------------------+---------------+--------------------------------------+--------------+----------+------+------------+--------------+-------------+---------------+---------+----------+-----------+-------------------+---------------+---------------+
| StartTime | feIp | QueryId | ConnectionId | Database | User | ScanBytes | ScanRows | MemoryUsage | DiskSpillSize | CPUTime | ExecTime | ExecState | Warehouse | CustomQueryId | ResourceGroup |
+---------------------+---------------+--------------------------------------+--------------+----------+------+------------+--------------+-------------+---------------+---------+----------+-----------+-------------------+---------------+---------------+
| 2025-03-07 02:02:47 | 172.26.92.227 | 3603d566-fab5-11ef-8063-461f20abc3f0 | 12 | tpcds_2 | root | 100.886 MB | 4899036 rows | 114.491 MB | 0.000 B | 5.700 s | 0.713 s | RUNNING | default_warehouse | | rg1 |
+---------------------+---------------+--------------------------------------+--------------+----------+------+------------+--------------+-------------+---------------+---------+----------+-----------+-------------------+---------------+---------------+
| **返回值** | **说明** |
| --------------- | -------------------------------------------------------------- |
| StartTime | 查询开始执行的时间。 |
| feIp | 处理查询的FE节点IP地址。 |
| QueryId | 查询的唯一标识符。 |
| ConnectionId | 与查询关联的连接ID。 |
| Database | 执行查询的数据库。 |
| User | 提交查询的用户。 |
| ScanBytes | 查询扫描的数据量。 |
| ScanRows | 查询扫描的行数。 |
| MemoryUsage | 查询当前的内存使用量。 |
| DiskSpillSize | 查询执行过程中溢出到磁盘的数据量。 |
| CPUTime | 查询消耗的总CPU时间。 |
| ExecTime | 查询的总执行时间。 |
| ExecState | 查询的执行状态。有效值:`RUNNING`(运行中)、`PENDING`(等待中)。 |
| Warehouse | 处理查询的计算仓库。 |
| CustomQueryId | 自定义查询标识符(如果指定)。 |
| ResourceGroup | 分配给查询的资源组。 |
```