管理者回復インデックス

行データと索引データが矛盾している場合、 ADMIN RECOVER INDEXステートメントを使用して、冗長索引に基づいて整合性を回復できます。この構文はまだ外部キー制約をサポートしていないことに注意してください。

あらすじ

AdminCleanupStmt ::=
    'ADMIN' 'RECOVER' 'INDEX' TableName IndexName

例

データベース内のtblテーブルの行データとインデックスが何らかの理由で矛盾しているとします (たとえば、災害復旧シナリオでクラスター内の一部の行データが失われるなど)。

SELECT * FROM tbl;
ERROR 1105 (HY000): inconsistent index idx handle count 2 isn't equal to value count 3

ADMIN CHECK INDEX tbl idx ;
ERROR 1105 (HY000): handle &kv.CommonHandle{encoded:[]uint8{0x1, 0x0, 0x0, 0x0, 0x0, 0x0, 0x0, 0x0, 0x0, 0xf8}, colEndOffsets:[]uint16{0xa}}, index:types.Datum{k:0x5, decimal:0x0, length:0x0, i:0, collation:"utf8mb4_bin", b:[]uint8{0x0}, x:interface {}(nil)} != record:<nil>

SELECTクエリのエラー メッセージから、 tblテーブルには 3 行のデータと 2 行のインデックス データが含まれていることがわかります。これは、行データとインデックス データが一致していないことを意味します。同時に、少なくとも 1 行のデータに対応するインデックスがありません。この場合、 ADMIN RECOVER INDEXステートメントを使用して不足しているインデックスを補足できます。

ADMIN RECOVER INDEX tbl idx;

実行結果は次のとおりです。

ADMIN RECOVER INDEX tbl idx;
+-------------+------------+
| ADDED_COUNT | SCAN_COUNT |
+-------------+------------+
|           1 |          3 |
+-------------+------------+
1 row in set (0.00 sec)

ADMIN CHECK INDEXステートメントを再度実行して、データとインデックスの整合性を確認し、データが正常な状態に復元されたかどうかを確認できます。

ADMIN CHECK INDEX tbl idx;
Query OK, 0 rows affected (0.01 sec)

ノート：

レプリカが失われたためにデータとインデックスに一貫性がない場合:

• 行データと索引データの両方が失われる可能性があります。この問題に対処するには、 ADMIN CLEANUP INDEXステートメントとADMIN RECOVER INDEXステートメントを一緒に使用して、行データとインデックス データの整合性を回復します。
• ADMIN RECOVER INDEXステートメントは、常に単一のスレッドで実行されます。テーブルデータが大きい場合は、インデックスを再構築してインデックスデータを回復することをお勧めします。
• ADMIN RECOVER INDEXステートメントを実行すると、対応するテーブルまたはインデックスはロックされず、TiDB は他のセッションが同時にテーブル レコードを変更できるようにします。ただし、この場合、 ADMIN RECOVER INDEXではすべてのテーブル レコードを正しく処理できない可能性があります。したがって、 ADMIN RECOVER INDEXを実行するときは、同時にテーブル データを変更することは避けてください。
• TiDB のエンタープライズ エディションを使用している場合は、サポート エンジニアにリクエストを提出するして支援を受けることができます。

ADMIN RECOVER INDEXステートメントはアトミックではありません。実行中にステートメントが中断された場合は、成功するまで再度実行することをお勧めします。

MySQL の互換性

このステートメントは、MySQL 構文に対する TiDB 拡張です。

こちらもご覧ください

• ADMIN CHECK TABLE/INDEX
• ADMIN CLEANUP INDEX