跳到主要内容
版本：Nightly

PROCESS_LIST

PROCESS_LIST 表提供了 GreptimeDB 集群中所有正在运行的查询的视图。

NOTE

PROCESS_LIST表特意选择了一个与 MySQL 的 PROCESSLIST 不同的名称，因为它们的列并不相通。

USE INFORMATION_SCHEMA;
DESC PROCESS_LIST;

输出如下：

+-----------------+----------------------+------+------+---------+---------------+
| Column          | Type                 | Key  | Null | Default | Semantic Type |
+-----------------+----------------------+------+------+---------+---------------+
| id              | String               |      | NO   |         | FIELD         |
| catalog         | String               |      | NO   |         | FIELD         |
| schemas         | String               |      | NO   |         | FIELD         |
| query           | String               |      | NO   |         | FIELD         |
| client          | String               |      | NO   |         | FIELD         |
| frontend        | String               |      | NO   |         | FIELD         |
| start_timestamp | TimestampMillisecond |      | NO   |         | FIELD         |
| elapsed_time    | DurationMillisecond  |      | NO   |         | FIELD         |
+-----------------+----------------------+------+------+---------+---------------+

PROCESS_LIST 表中的字段描述如下：

  • id: 查询的 ID。
  • catalog: 查询的 catalog 名称。
  • schemas: 客户端发出查询时所处的 schema 名称。
  • query: 查询语句。
  • client: 客户端信息，包括客户端地址和使用的协议。
  • frontend: 查询正在运行的 frontend 实例。
  • start_timestamp: 查询的开始时间戳。
  • elapsed_time: 查询已运行多长时间。
NOTE

你还可以使用 SHOW [FULL] PROCESSLIST 语句作为直接查询 INFORMATION_SCHEMA.PROCESS_LIST 表的替代方法。

终止一个查询

当从 PROCESS_LIST 表中识别到正在运行的查询时，你可以使用 KILL <PROCESS_ID> 语句终止该查询，其中 <PROCESS_ID> 是 PROCESS_LIST 表中的 id 字段。

mysql> select * from process_list;
+-----------------------+----------+--------------------+----------------------------+------------------------+---------------------+----------------------------+-----------------+
| id                    | catalog  | schemas            | query                      | client                 | frontend            | start_timestamp            | elapsed_time    |
+-----------------------+----------+--------------------+----------------------------+------------------------+---------------------+----------------------------+-----------------+
| 112.40.36.208/7 | greptime | public | SELECT * FROM some_very_large_table | mysql[127.0.0.1:34692] | 112.40.36.208:4001 | 2025-06-30 07:04:11.118000 | 00:00:12.002000 |
+-----------------------+----------+--------------------+----------------------------+------------------------+---------------------+----------------------------+-----------------+

KILL '112.40.36.208/7';
Query OK, 1 row affected (0.00 sec)