TIDB_TRX
TIDB_TRX
表提供了当前 TiDB 节点上正在执行的事务的信息。
USE INFORMATION_SCHEMA;
DESC TIDB_TRX;
输出结果如下:
+-------------------------+-----------------------------------------------------------------+------+------+---------+-------+
| Field | Type | Null | Key | Default | Extra |
+-------------------------+-----------------------------------------------------------------+------+------+---------+-------+
| ID | bigint(21) unsigned | NO | PRI | NULL | |
| START_TIME | timestamp(6) | YES | | NULL | |
| CURRENT_SQL_DIGEST | varchar(64) | YES | | NULL | |
| CURRENT_SQL_DIGEST_TEXT | text | YES | | NULL | |
| STATE | enum('Idle','Running','LockWaiting','Committing','RollingBack') | YES | | NULL | |
| WAITING_START_TIME | timestamp(6) | YES | | NULL | |
| MEM_BUFFER_KEYS | bigint(64) | YES | | NULL | |
| MEM_BUFFER_BYTES | bigint(64) | YES | | NULL | |
| SESSION_ID | bigint(21) unsigned | YES | | NULL | |
| USER | varchar(16) | YES | | NULL | |
| DB | varchar(64) | YES | | NULL | |
| ALL_SQL_DIGESTS | text | YES | | NULL | |
| RELATED_TABLE_IDS | text | YES | | NULL | |
+-------------------------+-----------------------------------------------------------------+------+------+---------+-------+
TIDB_TRX
表中各列的字段含义如下:
ID
:事务 ID,即事务的开始时间戳start_ts
。START_TIME
:事务的开始时间,即事务的start_ts
所对应的物理时间。CURRENT_SQL_DIGEST
:该事务当前正在执行的 SQL 语句的 Digest。CURRENT_SQL_DIGEST_TEXT
:该事务当前正在执行的 SQL 语句的归一化形式,即去除了参数和格式的 SQL 语句。与CURRENT_SQL_DIGEST
对应。STATE
:该事务当前所处的状态。其可能的值包括:Idle
:事务处于闲置状态,即正在等待用户输入查询。Running
:事务正在正常执行一个查询。LockWaiting
:事务处于正在等待悲观锁上锁完成的状态。需要注意的是,事务刚开始进行悲观锁上锁操作时即进入该状态,无论是否有被其它事务阻塞。Committing
:事务正在提交过程中。RollingBack
:事务正在回滚过程中。
WAITING_START_TIME
:当STATE
值为LockWaiting
时,该列显示等待的开始时间。MEM_BUFFER_KEYS
:当前事务写入内存缓冲区的 key 的个数。MEM_BUFFER_BYTES
:当前事务写入内存缓冲区的 key 和 value 的总字节数。SESSION_ID
:该事务所属的 session 的 ID。USER
:执行该事务的用户名。DB
:执行该事务的 session 当前的默认数据库名。ALL_SQL_DIGESTS
:该事务已经执行过的语句的 Digest 的列表,表示为一个 JSON 格式的字符串数组。每个事务最多记录前 50 条语句。通过TIDB_DECODE_SQL_DIGESTS
函数可以将该列的信息变换为对应的归一化 SQL 语句的列表。RELATED_TABLE_IDS
:该事务访问的表、视图等对象的 ID。
示例
查看 TIDB_TRX
表中的信息:
SELECT * FROM INFORMATION_SCHEMA.TIDB_TRX\G
输出结果如下:
*************************** 1. row ***************************
ID: 426789913200689153
START_TIME: 2021-08-04 10:51:54.883000
CURRENT_SQL_DIGEST: NULL
CURRENT_SQL_DIGEST_TEXT: NULL
STATE: Idle
WAITING_START_TIME: NULL
MEM_BUFFER_KEYS: 1
MEM_BUFFER_BYTES: 29
SESSION_ID: 7
USER: root
DB: test
ALL_SQL_DIGESTS: ["e6f07d43b5c21db0fbb9a31feac2dc599787763393dd5acbfad80e247eb02ad5","04fa858fa491c62d194faec2ab427261cc7998b3f1ccf8f6844febca504cb5e9","b83710fa8ab7df8504920e8569e48654f621cf828afbe7527fd003b79f48da9e"]
*************************** 2. row ***************************
ID: 426789921471332353
START_TIME: 2021-08-04 10:52:26.433000
CURRENT_SQL_DIGEST: 38b03afa5debbdf0326a014dbe5012a62c51957f1982b3093e748460f8b00821
CURRENT_SQL_DIGEST_TEXT: update `t` set `v` = `v` + ? where `id` = ?
STATE: LockWaiting
WAITING_START_TIME: 2021-08-04 10:52:35.106568
MEM_BUFFER_KEYS: 0
MEM_BUFFER_BYTES: 0
SESSION_ID: 9
USER: root
DB: test
ALL_SQL_DIGESTS: ["e6f07d43b5c21db0fbb9a31feac2dc599787763393dd5acbfad80e247eb02ad5","38b03afa5debbdf0326a014dbe5012a62c51957f1982b3093e748460f8b00821"]
2 rows in set (0.01 sec)
此示例的查询结果表示:当前节点有两个运行中的事务,第一个事务正在闲置状态(STATE
为 Idle
,CURRENT_SQL_DIGEST
为 NULL
),该事务已经执行过 3 条语句(ALL_SQL_DIGESTS
列表中有三条记录,分别为执行过的 3 条语句的 Digest);第二个事务正在执行一条语句并正在等锁(STATE
为 LockWaiting
,WAITING_START_TIME
显示了等锁开始的时间),该事务已经执行过两条语句,当前正在执行的语句形如 "update `t` set `v` = `v` + ? where `id` = ?"
。
SELECT id, all_sql_digests, tidb_decode_sql_digests(all_sql_digests) AS all_sqls FROM INFORMATION_SCHEMA.TIDB_TRX\G
输出结果如下:
*************************** 1. row ***************************
id: 426789913200689153
all_sql_digests: ["e6f07d43b5c21db0fbb9a31feac2dc599787763393dd5acbfad80e247eb02ad5","04fa858fa491c62d194faec2ab427261cc7998b3f1ccf8f6844febca504cb5e9","b83710fa8ab7df8504920e8569e48654f621cf828afbe7527fd003b79f48da9e"]
all_sqls: ["begin","insert into `t` values ( ... )","update `t` set `v` = `v` + ?"]
*************************** 2. row ***************************
id: 426789921471332353
all_sql_digests: ["e6f07d43b5c21db0fbb9a31feac2dc599787763393dd5acbfad80e247eb02ad5","38b03afa5debbdf0326a014dbe5012a62c51957f1982b3093e748460f8b00821"]
all_sqls: ["begin","update `t` set `v` = `v` + ? where `id` = ?"]
此查询对 TIDB_TRX
表的 ALL_SQL_DIGESTS
列调用了 TIDB_DECODE_SQL_DIGESTS
函数,将 SQL Digest 的数组通过系统内部的查询转换成归一化 SQL 语句的数组,以便于直观地获取事务历史执行过的语句的信息。但是需要注意上述查询扫描了 TIDB_TRX
全表,并对每一行都调用了 TIDB_DECODE_SQL_DIGESTS
函数;而 TIDB_DECODE_SQL_DIGESTS
函数调用的开销很大,所以如果集群中并发事务数量较多,请尽量避免这种查询。
CLUSTER_TIDB_TRX
TIDB_TRX
表仅提供单个 TiDB 节点中正在执行的事务信息。如果要查看整个集群上所有 TiDB 节点中正在执行的事务信息,需要查询 CLUSTER_TIDB_TRX
表。与 TIDB_TRX
表的查询结果相比,CLUSTER_TIDB_TRX
表的查询结果额外包含了 INSTANCE
字段。INSTANCE
字段展示了集群中各节点的 IP 地址和端口,用于区分事务所在的 TiDB 节点。
USE INFORMATION_SCHEMA;
DESC CLUSTER_TIDB_TRX;
输出结果如下:
+-------------------------+-----------------------------------------------------------------+------+------+---------+-------+
| Field | Type | Null | Key | Default | Extra |
+-------------------------+-----------------------------------------------------------------+------+------+---------+-------+
| INSTANCE | varchar(64) | YES | | NULL | |
| ID | bigint(21) unsigned | NO | PRI | NULL | |
| START_TIME | timestamp(6) | YES | | NULL | |
| CURRENT_SQL_DIGEST | varchar(64) | YES | | NULL | |
| CURRENT_SQL_DIGEST_TEXT | text | YES | | NULL | |
| STATE | enum('Idle','Running','LockWaiting','Committing','RollingBack') | YES | | NULL | |
| WAITING_START_TIME | timestamp(6) | YES | | NULL | |
| MEM_BUFFER_KEYS | bigint(64) | YES | | NULL | |
| MEM_BUFFER_BYTES | bigint(64) | YES | | NULL | |
| SESSION_ID | bigint(21) unsigned | YES | | NULL | |
| USER | varchar(16) | YES | | NULL | |
| DB | varchar(64) | YES | | NULL | |
| ALL_SQL_DIGESTS | text | YES | | NULL | |
| RELATED_TABLE_IDS | text | YES | | NULL | |
+-------------------------+-----------------------------------------------------------------+------+------+---------+-------+
14 rows in set (0.00 sec)