重要

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

行き詰まり

DEADLOCKSテーブルには、現在の TiDB ノードで最近発生したいくつかのデッドロックエラーの情報が表示されます。

USE INFORMATION_SCHEMA;
DESC deadlocks;

出力は次のようになります。

+-------------------------+---------------------+------+------+---------+-------+
| Field                   | Type                | Null | Key  | Default | Extra |
+-------------------------+---------------------+------+------+---------+-------+
| DEADLOCK_ID             | bigint(21)          | NO   |      | NULL    |       |
| OCCUR_TIME              | timestamp(6)        | YES  |      | NULL    |       |
| RETRYABLE               | tinyint(1)          | NO   |      | NULL    |       |
| TRY_LOCK_TRX_ID         | bigint(21) unsigned | NO   |      | NULL    |       |
| CURRENT_SQL_DIGEST      | varchar(64)         | YES  |      | NULL    |       |
| CURRENT_SQL_DIGEST_TEXT | text                | YES  |      | NULL    |       |
| KEY                     | text                | YES  |      | NULL    |       |
| KEY_INFO                | text                | YES  |      | NULL    |       |
| TRX_HOLDING_LOCK        | bigint(21) unsigned | NO   |      | NULL    |       |
+-------------------------+---------------------+------+------+---------+-------+

DEADLOCKSテーブルでは、複数の行を使用して同じデッドロックイベントが表示され、各行にはデッドロックイベントに関係するトランザクションの 1 つに関する情報が表示されます。TiDB ノードが複数のデッドロックエラーを記録する場合、各エラーはDEADLOCK_ID列を使用して区別されます。同じDEADLOCK_IDは同じデッドロックイベントを示します。7 DEADLOCK_IDグローバルな一意性を保証せず、永続化されないことに注意してください。同じ結果セット内の同じデッドロックイベントのみが表示されます。

DEADLOCKS表の各列フィールドの意味は次のとおりです。

DEADLOCK_ID : デッドロックイベントの ID。テーブル内に複数のデッドロックエラーが存在する場合、この列を使用して、異なるデッドロックエラーに属する行を区別できます。
OCCUR_TIME : デッドロックエラーが発生した時刻。
RETRYABLE : デッドロックエラーを再試行できるかどうか。再試行可能なデッドロックエラーの説明については、セクション再試行可能なデッドロックエラーを参照してください。
TRY_LOCK_TRX_ID : ロックを取得しようとするトランザクションの ID。この ID はトランザクションのstart_tsでもあります。
CURRENT_SQL_DIGEST : ロック取得トランザクションで現在実行されている SQL ステートメントのダイジェスト。
CURRENT_SQL_DIGEST_TEXT : ロック取得トランザクションで現在実行されている SQL ステートメントの正規化された形式。
KEY : トランザクションがロックしようとしたブロックされたキー。このフィールドの値は、16 進文字列の形式で表示されます。
KEY_INFO : KEYの詳細情報。4 KEY_INFOセクションを参照してください。
TRX_HOLDING_LOCK : 現在キーのロックを保持し、ブロックを引き起こしているトランザクションの ID。この ID はトランザクションのstart_tsでもあります。

DEADLOCKSテーブルに記録できるデッドロックイベントの最大数を調整するには、TiDB 構成ファイルのpessimistic-txn.deadlock-history-capacity構成を調整します。デフォルトでは、最新の 10 件のデッドロックイベントの情報がテーブルに記録されます。

最近の 10 件のデッドロックイベントの情報がDEADLOCKSテーブルに記録されます。

警告

プロセス権限を持つユーザーのみがこのテーブルを照会できます。
CURRENT_SQL_DIGEST列目の情報（SQLダイジェスト）は、正規化されたSQL文から計算されたハッシュ値です。3列目の情報は、文サマリーテーブルから内部的に照会されるため、対応する文が内部CURRENT_SQL_DIGEST_TEXTに見つからない可能性があります。SQLダイジェストと文サマリーテーブルの詳細については、ステートメント要約表を参照してください。

`KEY_INFO`

KEY_INFO列目にはKEY列目の詳細情報が表示されます。情報は JSON 形式で表示されます。各フィールドの説明は次のとおりです。

"db_id" : キーが属するスキーマの ID。
"db_name" : キーが属するスキーマの名前。
"table_id" : キーが属するテーブルの ID。
"table_name" : キーが属するテーブルの名前。
"partition_id" : キーが配置されているパーティションの ID。
"partition_name" : キーが配置されているパーティションの名前。
"handle_type" : 行キー（つまり、データ行を格納するキー）のハンドルタイプ。可能な値は次のとおりです。
- "int" : ハンドルタイプは int です。つまり、ハンドルは行 ID です。
- "common" : ハンドルタイプは int64 ではありません。このタイプは、クラスター化インデックスが有効な場合に非 int 主キーに表示されます。
- "unknown" : ハンドルタイプは現在サポートされていません。
"handle_value" : ハンドル値。
"index_id" : インデックスキー（インデックスを格納するキー）が属するインデックス ID。
"index_name" : インデックスキーが属するインデックスの名前。
"index_values" : インデックスキー内のインデックス値。

上記のフィールドのうち、フィールドの情報が該当しないか現在利用できない場合は、そのフィールドはクエリ結果で省略されます。たとえば、行キー情報にはindex_id 、 index_name 、 index_valuesが含まれません。インデックスキーにはhandle_typeとhandle_value含まれません。非パーティションテーブルにはpartition_idとpartition_nameが表示されません。削除されたテーブルのキー情報ではtable_name 、 db_id 、 db_name 、 index_nameなどのスキーマ情報を取得できず、テーブルがパーティションテーブルであるかどうかを区別できません。

注記：
キーがパーティショニングが有効になっているテーブルから取得され、クエリ中に何らかの理由 (たとえば、キーが属するテーブルが削除されている) によりキーが属するスキーマの情報をクエリできない場合、キーが属するパーティションの ID がtable_idフィールドに表示されることがあります。これは、TiDB が複数の独立したテーブルのキーをエンコードするのと同じ方法で、異なるパーティションのキーをエンコードするためです。したがって、スキーマ情報が欠落している場合、TiDB はキーがパーティション化されていないテーブルに属しているか、テーブルの 1 つのパーティションに属しているかを確認できません。

再試行可能なデッドロックエラー

注記：
このセクションはTiDB Cloudには適用されません。

注記：
DEADLOCKSテーブルは、デフォルトでは再試行可能なデッドロックエラーの情報を収集しません。テーブルで再試行可能なデッドロックエラー情報を収集する場合は、TiDB 構成ファイルでpessimistic-txn.deadlock-history-collect-retryableの値を調整できます。

トランザクション A がトランザクション B によって既に保持されているロックによってブロックされ、トランザクション B が現在のトランザクション A によって保持されているロックによって直接的または間接的にブロックされると、デッドロックエラーが発生します。このデッドロックでは、次の 2 つのケースが考えられます。

ケース 1:トランザクションB は、トランザクション A の開始後、トランザクション A がブロックされる前に実行されたステートメントによって生成されたロックによって (直接的または間接的に) ブロックされる可能性があります。
ケース 2:トランザクションB も、トランザクション A で現在実行されているステートメントによってブロックされる可能性があります。

ケース 1 では、TiDB はトランザクション A のクライアントにデッドロックエラーを報告し、トランザクションを終了します。

ケース 2 では、トランザクション A で現在実行中のステートメントが TiDB で自動的に再試行されます。たとえば、トランザクション A が次のステートメントを実行するとします。

UPDATE t SET v = v + 1 WHERE id = 1 OR id = 2;

トランザクションB は次の 2 つのステートメントを連続して実行します。

UPDATE t SET v = 4 WHERE id = 2;
UPDATE t SET v = 2 WHERE id = 1;

次に、トランザクション A がid = 1とid = 2で 2 つの行をロックし、 2 つのトランザクションが次の順序で実行されるとします。

トランザクションA はid = 1で行をロックします。
トランザクションB は最初のステートメントを実行し、行をid = 2でロックします。
トランザクションB は 2 番目のステートメントを実行し、トランザクション A によってブロックされているid = 1行をロックしようとします。
トランザクションA はid = 2で行をロックしようとしますが、トランザクション B によってブロックされ、デッドロックが発生します。

この場合、他のトランザクションをブロックするトランザクション A のステートメントが現在実行中のステートメントでもあるため、現在のステートメントの悲観的ロックを解決して (トランザクション B の実行を継続できるように)、現在のステートメントを再試行できます。TiDB は、内部的にキーハッシュを使用して、これが当てはまるかどうかを判断します。

再試行可能なデッドロックが発生した場合、内部の自動再試行ではトランザクションエラーが発生しないため、クライアントには透過的です。ただし、この状況が頻繁に発生すると、パフォーマンスに影響が出る可能性があります。この状況が発生すると、TiDB ログにsingle statement deadlock, retry statement表示されます。

例1

テーブル定義と初期データが次のとおりであると仮定します。

CREATE TABLE t (id int primary key, v int);
INSERT INTO t VALUES (1, 10), (2, 20);

2 つのトランザクションが次の順序で実行されます。

トランザクション1	トランザクション2	説明
`UPDATE t SET v = 11 WHERE id = 1;`
	`UPDATE t SET v = 21 WHERE id = 2;`
`UPDATE t SET v = 12 WHERE id = 2;`		トランザクション1 はブロックされます。
	`UPDATE t SET v = 22 WHERE id = 1;`	トランザクション2 はデッドロックエラーを報告します。

次に、トランザクション 2 がデッドロックエラーを報告します。この時点で、テーブルDEADLOCKSをクエリします。

SELECT * FROM INFORMATION_SCHEMA.DEADLOCKS;

期待される出力は次のとおりです。

+-------------+----------------------------+-----------+--------------------+------------------------------------------------------------------+-----------------------------------------+----------------------------------------+----------------------------------------------------------------------------------------------------+--------------------+
| DEADLOCK_ID | OCCUR_TIME                 | RETRYABLE | TRY_LOCK_TRX_ID    | CURRENT_SQL_DIGEST                                               | CURRENT_SQL_DIGEST_TEXT                 | KEY                                    | KEY_INFO                                                                                           | TRX_HOLDING_LOCK   |
+-------------+----------------------------+-----------+--------------------+------------------------------------------------------------------+-----------------------------------------+----------------------------------------+----------------------------------------------------------------------------------------------------+--------------------+
|           1 | 2021-08-05 11:09:03.230341 |         0 | 426812829645406216 | 22230766411edb40f27a68dadefc63c6c6970d5827f1e5e22fc97be2c4d8350d | update `t` set `v` = ? where `id` = ? ; | 7480000000000000355F728000000000000002 | {"db_id":1,"db_name":"test","table_id":53,"table_name":"t","handle_type":"int","handle_value":"2"} | 426812829645406217 |
|           1 | 2021-08-05 11:09:03.230341 |         0 | 426812829645406217 | 22230766411edb40f27a68dadefc63c6c6970d5827f1e5e22fc97be2c4d8350d | update `t` set `v` = ? where `id` = ? ; | 7480000000000000355F728000000000000001 | {"db_id":1,"db_name":"test","table_id":53,"table_name":"t","handle_type":"int","handle_value":"1"} | 426812829645406216 |
+-------------+----------------------------+-----------+--------------------+------------------------------------------------------------------+-----------------------------------------+----------------------------------------+----------------------------------------------------------------------------------------------------+--------------------+

DEADLOCKSテーブルに 2 行のデータが生成されます。両方の行のDEADLOCK_IDフィールドは1です。これは、両方の行の情報が同じデッドロックエラーに属していることを意味します。最初の行は、 "7480000000000000355F728000000000000002"のキーで、 ID "426812829645406216"のトランザクションが ID "426812829645406217"のトランザクションによってブロックされていることを示しています。2 番目の行は、 "7480000000000000355F728000000000000001"のキーで、 ID "426812829645406217"のトランザクションが ID 426812829645406216のトランザクションによってブロックされていることを示しています。これにより相互ブロックが発生し、デッドロックが形成されます。

例2

DEADLOCKSテーブルをクエリして次の結果が得られたとします。

+-------------+----------------------------+-----------+--------------------+------------------------------------------------------------------+-----------------------------------------+----------------------------------------+----------------------------------------------------------------------------------------------------+--------------------+
| DEADLOCK_ID | OCCUR_TIME                 | RETRYABLE | TRY_LOCK_TRX_ID    | CURRENT_SQL_DIGEST                                               | CURRENT_SQL_DIGEST_TEXT                 | KEY                                    | KEY_INFO                                                                                           | TRX_HOLDING_LOCK   |
+-------------+----------------------------+-----------+--------------------+------------------------------------------------------------------+-----------------------------------------+----------------------------------------+----------------------------------------------------------------------------------------------------+--------------------+
|           1 | 2021-08-05 11:09:03.230341 |         0 | 426812829645406216 | 22230766411edb40f27a68dadefc63c6c6970d5827f1e5e22fc97be2c4d8350d | update `t` set `v` = ? where `id` = ? ; | 7480000000000000355F728000000000000002 | {"db_id":1,"db_name":"test","table_id":53,"table_name":"t","handle_type":"int","handle_value":"2"} | 426812829645406217 |
|           1 | 2021-08-05 11:09:03.230341 |         0 | 426812829645406217 | 22230766411edb40f27a68dadefc63c6c6970d5827f1e5e22fc97be2c4d8350d | update `t` set `v` = ? where `id` = ? ; | 7480000000000000355F728000000000000001 | {"db_id":1,"db_name":"test","table_id":53,"table_name":"t","handle_type":"int","handle_value":"1"} | 426812829645406216 |
|           2 | 2021-08-05 11:09:21.252154 |         0 | 426812832017809412 | 22230766411edb40f27a68dadefc63c6c6970d5827f1e5e22fc97be2c4d8350d | update `t` set `v` = ? where `id` = ? ; | 7480000000000000355F728000000000000002 | {"db_id":1,"db_name":"test","table_id":53,"table_name":"t","handle_type":"int","handle_value":"2"} | 426812832017809413 |
|           2 | 2021-08-05 11:09:21.252154 |         0 | 426812832017809413 | 22230766411edb40f27a68dadefc63c6c6970d5827f1e5e22fc97be2c4d8350d | update `t` set `v` = ? where `id` = ? ; | 7480000000000000355F728000000000000003 | {"db_id":1,"db_name":"test","table_id":53,"table_name":"t","handle_type":"int","handle_value":"3"} | 426812832017809414 |
|           2 | 2021-08-05 11:09:21.252154 |         0 | 426812832017809414 | 22230766411edb40f27a68dadefc63c6c6970d5827f1e5e22fc97be2c4d8350d | update `t` set `v` = ? where `id` = ? ; | 7480000000000000355F728000000000000001 | {"db_id":1,"db_name":"test","table_id":53,"table_name":"t","handle_type":"int","handle_value":"1"} | 426812832017809412 |
+-------------+----------------------------+-----------+--------------------+------------------------------------------------------------------+-----------------------------------------+----------------------------------------+----------------------------------------------------------------------------------------------------+--------------------+

前のクエリ結果のDEADLOCK_ID列目は、最初の 2 行がデッドロックエラーの情報を表し、互いに待機する 2 つのトランザクションがデッドロックを形成していることを示しています。次の 3 行が別のデッドロックエラーの情報を表し、サイクルで待機する 3 つのトランザクションがデッドロックを形成しています。

クラスターデッドロック

CLUSTER_DEADLOCKSテーブルは、クラスター全体の各 TiDB ノードの最近のデッドロックエラーに関する情報を返します。これは、各ノードのDEADLOCKSテーブルの情報を組み合わせたものです。5 CLUSTER_DEADLOCKS異なる TiDB ノードを区別するために、ノードの IP アドレスとポートを表示する追加のINSTANCE列も含まれています。

DEADLOCK_IDではグローバルな一意性が保証されないため、 CLUSTER_DEADLOCKSテーブルのクエリ結果では、結果セット内の異なるデッドロックエラーの情報を区別するためにINSTANCEとDEADLOCK_ID一緒に使用する必要があることに注意してください。

USE INFORMATION_SCHEMA;
DESC CLUSTER_DEADLOCKS;

出力は次のようになります。

+-------------------------+---------------------+------+------+---------+-------+
| Field                   | Type                | Null | Key  | Default | Extra |
+-------------------------+---------------------+------+------+---------+-------+
| INSTANCE                | varchar(64)         | YES  |      | NULL    |       |
| DEADLOCK_ID             | bigint(21)          | NO   |      | NULL    |       |
| OCCUR_TIME              | timestamp(6)        | YES  |      | NULL    |       |
| RETRYABLE               | tinyint(1)          | NO   |      | NULL    |       |
| TRY_LOCK_TRX_ID         | bigint(21) unsigned | NO   |      | NULL    |       |
| CURRENT_SQL_DIGEST      | varchar(64)         | YES  |      | NULL    |       |
| CURRENT_SQL_DIGEST_TEXT | text                | YES  |      | NULL    |       |
| KEY                     | text                | YES  |      | NULL    |       |
| KEY_INFO                | text                | YES  |      | NULL    |       |
| TRX_HOLDING_LOCK        | bigint(21) unsigned | NO   |      | NULL    |       |
+-------------------------+---------------------+------+------+---------+-------+

行き詰まり

KEY_INFO

再試行可能なデッドロック エラー

例1

例2

クラスターデッドロック

このページは役に立ちましたか？

`KEY_INFO`

再試行可能なデッドロックエラー