管理者クリーンアップインデックス
ADMIN CLEANUP INDEX
ステートメントは、テーブルに不整合なデータとインデックスがある場合に、テーブルから冗長なインデックスを削除するために使用されます。この構文は外部キー制約まだサポートしていないことに注意してください。
概要
- AdminCleanupStmt
- TableNameList
AdminCleanupStmt ::=
'ADMIN' 'CLEANUP' ( 'INDEX' TableName IndexName | 'TABLE' 'LOCK' TableNameList )
TableNameList ::=
TableName ( ',' TableName )*
例
何らかの理由により、データベース内のtbl
テーブルに不整合なデータとインデックスがあるとします (たとえば、災害復旧シナリオでクラスター内の一部の行データが失われるなど)。
SELECT * FROM tbl;
ERROR 1105 (HY000): inconsistent index idx handle count 3 isn't equal to value count 2
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
テーブルには 2 行のデータと 3 行のインデックス データが含まれていることがわかります。これは、行とインデックス データが矛盾していることを意味します。同時に、少なくとも 1 つのインデックスがダングリング状態にあります。この場合、 ADMIN CLEANUP INDEX
ステートメントを使用してダングリング インデックスを削除できます。
ADMIN CLEANUP INDEX tbl idx;
実行結果は以下のとおりです。
ADMIN CLEANUP INDEX tbl idx;
+---------------+
| REMOVED_COUNT |
+---------------+
| 1 |
+---------------+
ADMIN CHECK INDEX
ステートメントを再度実行して、データとインデックスの一貫性をチェックし、データが通常の状態に復元されたかどうかを確認できます。
ADMIN CHECK INDEX tbl idx;
Query OK, 0 rows affected (0.01 sec)
注記:
レプリカの損失によりデータとインデックスが不整合になった場合:
- 行データとインデックス データの両方が失われる可能性があります。一貫性を回復するには、ステートメント
ADMIN CLEANUP INDEX
とADMIN RECOVER INDEX
一緒に使用します。ADMIN CLEANUP INDEX
ステートメントは常に 1 つのスレッドで実行されます。テーブル データが大きい場合は、インデックスを再構築してインデックス データを回復することをお勧めします。ADMIN CLEANUP INDEX
文を実行すると、対応するテーブルまたはインデックスはロックされず、TiDB は他のセッションが同時にテーブル レコードを変更することを許可します。ただし、この場合、ADMIN CLEANUP INDEX
すべてのテーブル レコードを正しく処理できない可能性があります。したがって、ADMIN CLEANUP INDEX
実行するときは、テーブル データを同時に変更しないようにしてください。- TiDB のエンタープライズ エディションを使用している場合は、サポート エンジニアにリクエストを送信するて支援を受けることができます。
ADMIN CLEANUP INDEX
ステートメントはアトミックではありません。ステートメントが実行中に中断された場合は、成功するまで再度実行することをお勧めします。
MySQL 互換性
このステートメントは、MySQL 構文に対する TiDB 拡張です。