重要

現在表示されているページは、TiDBのアーカイブされたドキュメント (非更新) です。TiDBをご利用の場合、最新のLTS (Long Term Support) バージョンの使用を推奨します。

重要

このページは英語版のページを機械翻訳しています。原文はこちらからご覧ください。

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    |       |
+-------------------------+-----------------------------------------------------------------+------+------+---------+-------+

TIDB_TRXテーブルの各列フィールドの意味は次のとおりです。

ID : トランザクションのstart_ts (開始タイムスタンプ) であるトランザクション ID。
START_TIME : トランザクションの開始時間。トランザクションのstart_tsに対応する物理時間です。
CURRENT_SQL_DIGEST : トランザクションで現在実行中の SQL ステートメントのダイジェスト。
CURRENT_SQL_DIGEST_TEXT : トランザクションによって現在実行されている SQL ステートメントの正規化された形式、つまり、引数と形式のない SQL ステートメント。 CURRENT_SQL_DIGESTに相当します。
STATE : トランザクションの現在の状態。可能な値は次のとおりです。
- Idle : トランザクションはアイドル状態です。つまり、ユーザーがクエリを入力するのを待っています。
- Running : トランザクションはクエリを実行しています。
- LockWaiting : トランザクションはペシミスティックロックの取得を待機しています。トランザクションは、他のトランザクションによってブロックされているかどうかに関係なく、悲観的ロック操作の開始時にこの状態になることに注意してください。
- Committing : トランザクションはコミット中です。
- RollingBack : トランザクションはロールバック中です。
WAITING_START_TIME : STATEの値がLockWaitingの場合、この列は待機の開始時刻を示します。
MEM_BUFFER_KEYS : 現在のトランザクションによってメモリバッファに書き込まれたキーの数。
MEM_BUFFER_BYTES : 現在のトランザクションによってメモリバッファに書き込まれたキー値バイトの総数。
SESSION_ID : このトランザクションが属するセッションの ID。
USER : トランザクションを実行するユーザーの名前。
DB : トランザクションが実行されるセッションの現在のデフォルトデータベース名。
ALL_SQL_DIGESTS : トランザクションによって実行されたステートメントのダイジェストリスト。リストは、JSON 形式の文字列配列として表示されます。各トランザクションは、最大で最初の 50 ステートメントを記録します。 TIDB_DECODE_SQL_DIGESTS関数を使用すると、この列の情報を対応する正規化された SQL ステートメントのリストに変換できます。

ノート：
この表の完全な情報を取得できるのは、処理する特権を持つユーザーだけです。 PROCESS 権限を持たないユーザーは、現在のユーザーが実行したトランザクションの情報のみをクエリできます。
CURRENT_SQL_DIGEST列目とALL_SQL_DIGESTS列目の情報(SQLダイジェスト)は、正規化されたSQL文から計算されたハッシュ値です。 CURRENT_SQL_DIGEST_TEXT列の情報とTIDB_DECODE_SQL_DIGESTS関数から返された結果は、ステートメントの要約テーブルから内部的に照会されるため、対応するステートメントが内部的に見つからない可能性があります。 SQL ダイジェストとステートメント要約表の詳細な説明については、ステートメント要約表を参照してください。
TIDB_DECODE_SQL_DIGESTSの関数呼び出しのオーバーヘッドは高くなっています。多数のトランザクションの履歴 SQL ステートメントをクエリするために関数が呼び出されると、クエリに時間がかかる場合があります。クラスタが大規模で多数の同時トランザクションがある場合は、 TIDB_TRXのテーブル全体をクエリする際にALL_SQL_DIGEST列でこの関数を直接使用しないでください。これは、 select *, tidb_decode_sql_digests(all_sql_digests) from tidb_trxのような SQL ステートメントを避けることを意味します。
現在、 TIDB_TRXテーブルは TiDB 内部トランザクションの情報の表示をサポートしていません。

例

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)

この例のクエリ結果から、現在のノードには 2 つの進行中のトランザクションがあることがわかります。 1 つのトランザクションがアイドル状態 ( STATEはIdleはNULL ) で、このトランザクションは 3 CURRENT_SQL_DIGESTのステートメントを実行しました ( ALL_SQL_DIGESTSリストには、実行された 3 つの SQL ステートメントのダイジェストである 3 つのレコードがあります)。別のトランザクションがステートメントを実行し、ロックを待機しています ( STATEはLockWaitingはWAITING_START_TIME中のロックの開始時刻を示します)。トランザクションは 2 つのステートメントを実行しました。現在実行中のステートメントは"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 ダイジェスト配列を正規化された 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;

mysql> 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    |       |
+-------------------------+-----------------------------------------------------------------+------+------+---------+-------+