CHECK TABLE 语句

在 ClickHouse 中，CHECK TABLE 查询用于对特定表或其分区进行验证检查。它通过验证校验和和其他内部数据结构来确保数据的完整性。

具体而言，它比较实际文件大小与存储在服务器上的期望值。如果文件大小与存储的值不匹配，则表示数据已损坏。这可能是由于查询执行期间系统崩溃等原因造成的。

危险

CHECK TABLE 查询可能会读取表中的所有数据并占用一些资源，使其资源密集型。 在执行此查询之前，请考虑对性能和资源利用的潜在影响。 此查询不会改善系统的性能，如果您不确定自己在做什么，请勿执行该查询。

语法

查询的基本语法如下：

• table_name：指定要检查的表的名称。
• partition_expression：（可选）如果要检查表的特定分区，可以使用此表达式指定该分区。
• part_name：（可选）如果要检查表中的特定部分，可以添加字符串文本以指定部分名称。
• FORMAT format：（可选）允许您指定结果的输出格式。
• SETTINGS：（可选）允许额外的设置。
  • check_query_single_value_result：（可选）此设置允许您在详细结果（0）或汇总结果（1）之间切换。
  • 还可以应用其他设置。如果您不需要结果的确定顺序，可以将 max_threads 设置为大于 1 的值以加快查询。

查询响应取决于 check_query_single_value_result 设置的值。 在 check_query_single_value_result = 1 的情况下，仅返回一个带有单一行的 result 列。该行中的值为 1，如果完整性检查通过，若数据损坏则为 0。

当 check_query_single_value_result = 0 时，查询将返回以下列：

• part_path：指示数据部分的路径或文件名。
• is_passed：如果此部分检查成功，则返回 1，否则返回 0。
• message：与检查相关的任何其他消息，例如错误或成功消息。

CHECK TABLE 查询支持以下表引擎：

• Log
• TinyLog
• StripeLog
• MergeTree family

在其他表引擎的表上执行会导致 NOT_IMPLEMENTED 异常。

*Log 家族的引擎在故障时不提供自动数据恢复。请使用 CHECK TABLE 查询及时跟踪数据丢失。

示例

默认情况下，CHECK TABLE 查询显示一般的表检查状态：

如果您想查看每个单独数据部分的检查状态，可以使用 check_query_single_value_result 设置。

此外，要检查表的特定分区，您可以使用 PARTITION 关键字。

输出：

同样，您可以使用 PART 关键字检查表的特定部分。

输出：

请注意，当部分不存在时，查询会返回错误：

接收 'Corrupted' 结果

危险

免责声明：此处描述的过程，包括直接从数据目录手动操作或删除文件，仅适用于实验或开发环境。请勿在生产服务器上尝试，因为这可能导致数据丢失或其他意外后果。

移除现有的校验和文件：

如果 checksums.txt 文件丢失，则可以恢复。它将在针对特定分区执行 CHECK TABLE 命令期间被重新计算和重写，并且状态仍将报告为 'is_passed = 1'。

您可以通过使用 CHECK ALL TABLES 查询一次性检查所有现有的 (Replicated)MergeTree 表。

如果数据已损坏

如果表已损坏，您可以将非损坏的数据复制到另一个表。为此：

1. 创建一个与损坏表结构相同的新表。为此执行查询 CREATE TABLE <new_table_name> AS <damaged_table_name>。
2. 将 max_threads 值设置为 1，以便在单个线程中处理下一个查询。为此运行查询 SET max_threads = 1。
3. 执行查询 INSERT INTO <new_table_name> SELECT * FROM <damaged_table_name>。该请求将非损坏数据从损坏表复制到另一个表。仅复制损坏部分前的数据。
4. 重启 clickhouse-client 以重置 max_threads 值。