ADMIN CLEANUP INDEX

ADMIN CLEANUP INDEX 语句用于在表发生行数据和索引的一致性故障时,删除表中多余的索引,使表的行数据和索引恢复一致状态。注意,该语法尚不支持外键约束

语法图

AdminCleanupStmt
ADMINCLEANUPINDEXTableNameIndexNameTABLELOCKTableNameList
TableNameList
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)

MySQL 兼容性

ADMIN CLEANUP INDEX 语句是 TiDB 对 MySQL 语法的扩展。

另请参阅