Skip to content

Latest commit

 

History

History
113 lines (98 loc) · 6.38 KB

information-schema-processlist.md

File metadata and controls

113 lines (98 loc) · 6.38 KB
Raw
title summary aliases
PROCESSLIST
了解 information_schema 表 `PROCESSLIST`。
/docs-cn/dev/information-schema/information-schema-processlist/

PROCESSLIST

PROCESSLIST 和 SHOW PROCESSLIST 的功能一样，都是查看当前正在处理的请求。

PROCESSLIST 表比 SHOW PROCESSLIST 的结果多出下面几列：

  • DIGEST 列：显示 SQL 语句的 digest。
  • MEM 列：显示正在处理的请求已使用的内存，单位是 byte。
  • DISK 列：显示磁盘空间使用情况，单位是 byte。
  • TxnStart 列：显示事务的开始时间。
  • RESOURCE_GROUP 列：显示对应的资源组名称。
  • SESSION_ALIAS 列：显示当前连接的别名。
  • ROWS_AFFECTED 列：显示语句当前影响的行数。
  • TIDB_CPU 列：显示语句当前占用 TiDB 服务器 CPU 的时间，单位是纳秒。该列仅在开启 Top SQL 特性时显示实际值，否则始终显示为 0。
  • TIKV_CPU 列：显示语句当前占用 TiKV 服务器 CPU 的时间，单位是纳秒。
USE information_schema;
DESC processlist;
+----------------+---------------------+------+------+---------+-------+
| Field          | Type                | Null | Key  | Default | Extra |
+----------------+---------------------+------+------+---------+-------+
| ID             | bigint(21) unsigned | NO   |      | 0       |       |
| USER           | varchar(16)         | NO   |      |         |       |
| HOST           | varchar(64)         | NO   |      |         |       |
| DB             | varchar(64)         | YES  |      | NULL    |       |
| COMMAND        | varchar(16)         | NO   |      |         |       |
| TIME           | int(7)              | NO   |      | 0       |       |
| STATE          | varchar(7)          | YES  |      | NULL    |       |
| INFO           | longtext            | YES  |      | NULL    |       |
| DIGEST         | varchar(64)         | YES  |      |         |       |
| MEM            | bigint(21) unsigned | YES  |      | NULL    |       |
| DISK           | bigint(21) unsigned | YES  |      | NULL    |       |
| TxnStart       | varchar(64)         | NO   |      |         |       |
| RESOURCE_GROUP | varchar(32)         | NO   |      |         |       |
| SESSION_ALIAS  | varchar(64)         | NO   |      |         |       |
| ROWS_AFFECTED  | bigint(21) unsigned | YES  |      | NULL    |       |
| TIDB_CPU       | bigint(21)          | NO   |      | 0       |       |
| TIKV_CPU       | bigint(21)          | NO   |      | 0       |       |
+----------------+---------------------+------+------+---------+-------+
SELECT * FROM information_schema.processlist\G
*************************** 1. row ***************************
            ID: 1268776964
          USER: root
          HOST: 127.0.0.1:59922
            DB: NULL
       COMMAND: Query
          TIME: 0
         STATE: autocommit
          INFO: SELECT * FROM information_schema.processlist
        DIGEST: 4b5e7cdd5d3ed84d6c1a6d56403a3d512554b534313caf296268abdec1c9ea99
           MEM: 0
          DISK: 0
      TxnStart:
RESOURCE_GROUP: default
 SESSION_ALIAS:
 ROWS_AFFECTED: 0
      TIDB_CPU: 0
      TIKV_CPU: 0

PROCESSLIST 表各列的含义如下：

  • ID 列：客户连接 ID。
  • USER 列：执行当前 PROCESS 的用户名。
  • HOST 列：客户连接的地址。
  • DB 列：当前连接的默认数据库名。
  • COMMAND 列：当前 PROCESS 执行的命令类型。
  • TIME 列：当前 PROCESS 的已经执行的时间，单位是秒。
  • STATE 列：当前连接的状态。
  • INFO 列：正在处理的请求语句。
  • DIGEST 列：SQL 语句的 digest。
  • MEM 列：正在处理的请求已使用的内存，单位是 byte。
  • DISK 列：磁盘空间使用情况，单位是 byte。
  • TxnStart 列：显示事务的开始时间。
  • RESOURCE_GROUP 列：显示对应的资源组名称。
  • SESSION_ALIAS 列：显示当前连接的别名。
  • ROWS_AFFECTED 列：显示语句当前影响的行数。
  • TIDB_CPU 列：显示语句当前占用 TiDB 服务器 CPU 的时间，单位是纳秒。该列仅在开启 Top SQL 特性时显示实际值，否则始终显示为 0。
  • TIKV_CPU 列：显示语句当前占用 TiKV 服务器 CPU 的时间，单位是纳秒。

CLUSTER_PROCESSLIST

CLUSTER_PROCESSLIST 是 PROCESSLIST 对应的集群系统表，用于查询集群中所有 TiDB 节点的 PROCESSLIST 信息。CLUSTER_PROCESSLIST 表结构上比 PROCESSLIST 多一列 INSTANCE，表示该行数据来自的 TiDB 节点地址。

{{< copyable "sql" >}}

SELECT * FROM information_schema.cluster_processlist;
+-----------------+------------+------+-----------------+------+---------+------+------------+------------------------------------------------------+------------------------------------------------------------------+------+------+----------------------------------------+----------------+---------------+---------------+----------+----------+
| INSTANCE        | ID         | USER | HOST            | DB   | COMMAND | TIME | STATE      | INFO                                                 | DIGEST                                                           | MEM  | DISK | TxnStart                               | RESOURCE_GROUP | SESSION_ALIAS | ROWS_AFFECTED | TIDB_CPU | TIKV_CPU |
+-----------------+------------+------+-----------------+------+---------+------+------------+------------------------------------------------------+------------------------------------------------------------------+------+------+----------------------------------------+----------------+---------------+---------------+----------+----------+
| 127.0.0.1:10080 | 1268776964 | root | 127.0.0.1:59922 | NULL | Query   |    0 | autocommit | SELECT * FROM information_schema.cluster_processlist | b1e38e59fbbc3e2b35546db5c8053040db989a497ac6cd71ff8dd4394395701a |    0 |    0 | 07-29 12:39:24.282(451471727468740609) | default        |               |             0 |        0 |        0 |
+-----------------+------------+------+-----------------+------+---------+------+------------+------------------------------------------------------+------------------------------------------------------------------+------+------+----------------------------------------+----------------+---------------+---------------+----------+----------+