Documentation Home
MySQL 8.0 参考手册

13.7.3.2 CHECK TABLE 语句

CHECK TABLE tbl_name [, tbl_name] ... [option] ...

option: {
    FOR UPGRADE
  | QUICK
  | FAST
  | MEDIUM
  | EXTENDED
  | CHANGED
}

CHECK TABLE检查一个或多个表是否有错误。CHECK TABLE 还可以检查视图是否存在问题，例如视图定义中引用的表不再存在。

要检查一个表，您必须对它有一些特权。

CHECK TABLE适用于 InnoDB、 MyISAM、 ARCHIVE和 CSV表格。

CHECK TABLE在 表 上运行之前InnoDB，请参阅 InnoDB 表的 CHECK TABLE 使用说明。

CHECK TABLE支持分区表，可以ALTER TABLE ... CHECK PARTITION用来检查一个或多个分区；有关详细信息，请参阅第 13.1.9 节，“ALTER TABLE 语句”和 第 24.3.4 节，“分区维护”。

CHECK TABLE忽略未索引的虚拟生成列。

检查表输出

CHECK TABLE返回一个结果集，其列如下表所示。

柱子 价值
Table 表名
Op 总是check
Msg_type status, error, info,note或 warning
Msg_text 信息性消息

该语句可能会为每个已检查的表生成多行信息。最后一行的Msg_type 值为 ，status通常 Msg_text应为 OK。Table is already up to date表示表的存储引擎表明不需要检查表。

检查版本兼容性

该FOR UPGRADE选项检查命名表是否与当前版本的 MySQL 兼容。使用FOR UPGRADE，服务器检查每个表以确定自创建表以来表的任何数据类型或索引是否有任何不兼容的更改。如果不是，则检查成功。否则，如果可能存在不兼容性，服务器将对表运行全面检查（这可能需要一些时间）。

由于数据类型的存储格式已更改或其排序顺序已更改，可能会发生不兼容。我们的目标是避免这些更改，但有时它们是纠正比版本之间不兼容更糟糕的问题所必需的。

FOR UPGRADE发现这些不兼容性：

检查数据一致性

下表显示了可以提供的其他检查选项。这些选项被传递给存储引擎，存储引擎可能会使用或忽略它们。

类型 意义
QUICK 不要扫描行来检查不正确的链接。适用于 表InnoDB和MyISAM 视图。
FAST 仅检查未正确关闭的表。忽略 InnoDB; 仅适用于 MyISAM表和视图。
CHANGED 仅检查自上次检查以来已更改或未正确关闭的表。忽略 InnoDB; 仅适用于 MyISAM表和视图。
MEDIUM 扫描行以验证删除的链接是否有效。这还会计算行的密钥校验和，并使用计算出的密钥校验和来验证这一点。忽略 InnoDB; 仅适用于 MyISAM表和视图。
EXTENDED 对每一行的所有键进行完整的键查找。这样可以确保表是 100% 一致的，但是需要很长时间。忽略InnoDB; 仅适用于 MyISAM表和视图。

您可以组合检查选项，如以下示例所示，该示例对表进行快速检查以确定它是否已正确关闭： 

CHECK TABLE test_table FAST QUICK;
笔记

如果CHECK TABLE发现标记为 “已损坏”或“未正确关闭”的表没有问题，则CHECK TABLE 可以删除该标记。

如果表已损坏，问题很可能出在索引中，而不是数据部分。所有上述检查类型都会彻底检查索引，因此应该会发现大部分错误。

要检查您认为没问题的表，请使用无检查选项或QUICK选项。后者应该在你赶时间的时候使用，并且可以承担QUICK在数据文件中没有发现错误的非常小的风险。（在大多数情况下，在正常使用情况下，MySQL 应该会发现数据文件中有任何错误。如果发生这种情况，该表将被标记为“已损坏”，并且在修复之前无法使用。）

FAST并且CHANGED主要用于脚本（例如，从cron执行）以定期检查表。在大多数情况下，FAST优先于CHANGED. （唯一不受欢迎的情况是您怀疑在MyISAM代码中发现了错误。）

EXTENDED仅在运行正常检查但当 MySQL 尝试更新行或按键查找行时仍然从表中得到错误后使用。如果正常检查成功，则不太可能发生这种情况。

使用CHECK TABLE ... EXTENDED可能会影响查询优化器生成的执行计划。

报告的一些问题CHECK TABLE无法自动更正：

  • Found row where the auto_increment column has the value 0.

    这意味着您在表中有一行，其中 AUTO_INCREMENT索引列包含值 0。（可以 通过使用语句 AUTO_INCREMENT将列显式设置为 0 来创建列为 0 的行。）UPDATE

    这本身不是错误，但如果您决定转储表并恢复它或 ALTER TABLE对表执行操作，则可能会造成麻烦。在这种情况下，AUTO_INCREMENT列会根据 AUTO_INCREMENT列的规则更改值，这可能会导致重复键错误等问题。

    要消除警告，请执行 UPDATE语句将列设置为 0 以外的某个值。

InnoDB 表的 CHECK TABLE 使用注意事项

以下注释适用于 InnoDB表格：

  • 如果CHECK TABLE遇到损坏的页面，服务器将退出以防止错误传播（错误 #10132）。如果损坏发生在二级索引但表数据可读，运行 CHECK TABLE仍然会导致服务器退出。

  • 如果在聚集索引中 CHECK TABLE遇到损坏的DB_TRX_ID或 字段，可能会导致 访问无效的撤消日志记录，从而导致与 MVCC相关的服务器退出。 DB_ROLL_PTRCHECK TABLEInnoDB

  • 如果CHECK TABLE在表或索引中遇到错误InnoDB，它会报告错误，并且通常会将索引标记为已损坏，有时会将表标记为已损坏，从而阻止索引或表的进一步使用。此类错误包括二级索引中的条目数量不正确或链接不正确。

  • 如果CHECK TABLE在二级索引中发现不正确的条目数，它会报告错误，但不会导致服务器退出或阻止对文件的访问。

  • CHECK TABLE检查索引页面结构，然后检查每个关键条目。它不验证指向集群记录的键指针或遵循BLOB 指针的路径。

  • 当一个InnoDB表存储在它自己的 .ibd 文件中时， 文件的前 3 页.ibd包含标题信息而不是表或索引数据。该 CHECK TABLE语句不检测仅影响标头数据的不一致。要验证 InnoDB .ibd文件的全部内容，请使用innochecksum命令。

  • CHECK TABLE在大表上 运行时InnoDB，其他线程可能会在CHECK TABLE执行过程中被阻塞。为避免超时，信号量等待阈值（600 秒）被延长 2 小时（7200 秒）以进行CHECK TABLE操作。如果InnoDB 检测到信号量​​等待 240 秒或更长时间，它会开始InnoDB将监视器输出打印到错误日志中。如果锁定请求超出信号量等待阈值，InnoDB则中止进程。要完全避免信号量等待超时的可能性，请运行 CHECK TABLE QUICK而不是CHECK TABLE.

  • CHECK TABLE索引的功能InnoDB SPATIAL 包括 R-tree 有效性检查和检查以确保 R-tree 行计数与聚集索引匹配。

  • CHECK TABLE支持虚拟生成列的二级索引，这是InnoDB.

  • 从 MySQL 8.0.14 开始，InnoDB支持并行聚集索引读取，可以提高 CHECK TABLE性能。 InnoDB在操作期间读取聚集索引两次CHECK TABLE 。第二次读取可以并行执行。innodb_parallel_read_threads 会话变量必须设置为大于 1 的值才能进行并行聚集索引读取。 默认值为 4。用于执行并行聚集索引读取的实际线程数由 innodb_parallel_read_threads 设置或要扫描的索引子树数决定，以较小者为准。

MyISAM 表的 CHECK TABLE 使用注意事项

以下注释适用于 MyISAM表格：