重要

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

データとインデックス間の不一致のトラブルシューティング

TiDB は、トランザクションADMIN CHECK [TABLE|INDEX]ステートメントを実行するときに、データとインデックス間の一貫性をチェックします。チェックで、レコードのキーと値、および対応するインデックスのキーと値が矛盾していることが判明した場合、つまり、行データを格納するキーと値のペアと、そのインデックスを格納する対応するキーと値のペアが一致しない場合 (たとえば、インデックスを増やすか、インデックスが欠落している場合)、TiDB はデータ不整合エラーを報告し、関連するエラーをエラーログに出力。

このドキュメントでは、データ不整合エラーの意味について説明し、整合性チェックをバイパスするいくつかの方法を提供します。データ整合性エラーが発生した場合は、PingCAP またはコミュニティから支持を得ますのことができます。

エラーの説明

データとインデックスの間で不一致が発生した場合、TiDB エラーメッセージをチェックして行データとインデックスデータの間でどの項目が不一致であるかを確認したり、関連するエラーログをチェックして詳細な調査を行ったりすることができます。

トランザクション実行中に報告されるエラー

このセクションでは、TiDB がトランザクションを実行するときに報告されるデータ不整合エラーをリストし、これらのエラーの意味を例とともに説明します。

エラー8133

ERROR 8133 (HY000): data inconsistency in table: t, index: k2, index-count:1 != record-count:0

このエラーは、 table tのk2インデックスについて、テーブル内のインデックスの数が 1 で、行レコードの数が 0 であることを示します。この数は矛盾しています。

エラー8138

ERROR 8138 (HY000): writing inconsistent data in table: t, expected-values:{KindString green} != record-values:{KindString GREEN}

このエラーは、トランザクションが不正な行値を書き込もうとしたことを示します。書き込まれるデータは、エンコードされた行データがエンコード前の元のデータと一致しません。

エラー 8139

ERROR 8139 (HY000): writing inconsistent data in table: t, index: i1, index-handle:4 != record-handle:3, index: tables.mutation{key:kv.Key{0x74, 0x80, 0x0, 0x0, 0x0, 0x0, 0x0, 0x0, 0x49, 0x5f, 0x69, 0x80, 0x0, 0x0, 0x0, 0x0, 0x0, 0x0, 0x1, 0x1, 0x68, 0x65, 0x6c, 0x6c, 0x6f, 0x0, 0x0, 0x0, 0xfc, 0x1, 0x68, 0x65, 0x6c, 0x6c, 0x6f, 0x0, 0x0, 0x0, 0xfc, 0x3, 0x80, 0x0, 0x0, 0x0, 0x0, 0x0, 0x0, 0x4}, flags:0x0, value:[]uint8{0x30}, indexID:1}, record: tables.mutation{key:kv.Key{0x74, 0x80, 0x0, 0x0, 0x0, 0x0, 0x0, 0x0, 0x49, 0x5f, 0x72, 0x80, 0x0, 0x0, 0x0, 0x0, 0x0, 0x0, 0x3}, flags:0xd, value:[]uint8{0x80, 0x0, 0x2, 0x0, 0x0, 0x0, 0x1, 0x2, 0x5, 0x0, 0xa, 0x0, 0x68, 0x65, 0x6c, 0x6c, 0x6f, 0x68, 0x65, 0x6c, 0x6c, 0x6f}, indexID:0}

このエラーは、書き込むデータのハンドル（つまりロウデータのキー）が不一致であることを示します。 table tのインデックスi1の場合、トランザクションによって書き込まれる行には、インデックスのキーと値のペアのハンドル 4 と、行レコードのキーと値のペアのハンドル 3 があります。この行のデータは書き込まれません。

エラー 8140

ERROR 8140 (HY000): writing inconsistent data in table: t, index: i2, col: c1, indexed-value:{KindString hellp} != record-value:{KindString hello}

このエラーは、トランザクションによって書き込まれる行のデータがインデックス内のデータと一致しないことを示します。テーブルtのインデックスi2の場合、トランザクションによって書き込まれる行には、インデックスのキーと値のペアにデータhellpがあり、レコードのキーと値のペアにデータhelloあります。この行のデータは書き込まれません。

エラー8141

ERROR 8141 (HY000): assertion failed: key: 7480000000000000405f72013300000000000000f8, assertion: NotExist, start_ts: 430590532931813377, existing start ts: 430590532931551233, existing commit ts: 430590532931551234

このエラーは、トランザクションのコミット中にアサーションが失敗したことを示します。データとインデックスが一貫していると仮定すると、TiDB はキー7480000000000000405f720133000000000000000000f8が存在しないと主張しました。トランザクションがコミットされているときに、TiDB は、 start ts 430590532931551233を使用してトランザクションによって書き込まれたキーが存在することを検出しました。 TiDB は、このキーのマルチバージョン同時実行制御 (MVCC) 履歴をログに出力します。

管理者チェックで報告されたエラー

このセクションでは、 ADMIN CHECK [TABLE|INDEX]ステートメントの実行時に TiDB で発生する可能性のあるデータ不整合エラーをリストし、これらのエラーの意味を例を示して説明します。

エラー8003

ERROR 8003 (HY000): table count 3 != index(idx) count 2

このエラーは、 ADMIN CHECKステートメントが実行されるテーブルには 3 つの行キーと値のペアがあるが、インデックスキーと値のペアは 2 つしかないことを示します。

エラー8134

ERROR 8134 (HY000): data inconsistency in table: t, index: c2, col: c2, handle: "2", index-values:"KindInt64 13" != record-values:"KindInt64 12", compare err:<nil>

このエラーは、テーブルtのインデックスc2について、列c2の値に次の矛盾があることを示します。

ハンドルが2である行のインデックスのキーと値のペアでは、列c2の値は13です。
行レコードのキーと値のペアでは、列c2の値は12です。

エラー8223

ERROR 8223 (HY000): data inconsistency in table: t2, index: i1, handle: {hello, hello}, index-values:"" != record-values:"handle: {hello, hello}, values: [KindString hello KindString hello]"

このエラーは、 index-valuesが null で、 record-values null ではないことを示します。これは、行に対応するインデックスが存在しないことを意味します。

ソリューション

データの不整合エラーが発生した場合は、自分でエラーに対処するのではなく、すぐにトラブルシューティングのために PingCAP から支持を得ますを受け取ります。アプリケーションでこのようなエラーを緊急にスキップする必要がある場合は、次の方法を使用してチェックをバイパスできます。

SQLを書き換える

データ不整合エラーが特定の SQL ステートメントでのみ発生する場合は、別の実行演算子を使用して SQL ステートメントを別の同等の形式に書き直すことで、このエラーを回避できます。

エラーチェックを無効にする

トランザクションの実行時に報告される次のエラーについては、対応するチェックをバイパスできます。

エラー 8138、8139、および 8140 のチェックをバイパスするには、 set @@tidb_enable_mutation_checker=0を設定します。
エラー 8141 のチェックをバイパスするには、 set @@tidb_txn_assertion_level=OFFを構成します。

ノート：
tidb_enable_mutation_checkerとtidb_txn_assertion_levelを無効にすると、すべての SQL ステートメントの対応するチェックがバイパスされます。

トランザクションの実行で報告される他のエラーと、 ADMIN CHECK [TABLE|INDEX]ステートメントの実行中に報告されるすべてのエラーについては、データがすでに不整合であるため、対応するチェックをバイパスできません。