跳到主要内容
跳到主要内容

CHECK TABLE 语句

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

特别地,它将实际文件大小与存储在服务器上的期望值进行比较。如果文件大小与存储的值不匹配,则意味着数据已损坏。这可能是由于查询执行期间系统崩溃等原因造成的。

备注

CHECK TABLE 查询可能会读取表中的所有数据并占用一些资源,导致其资源密集型。 在执行此查询之前,请考虑对性能和资源利用的潜在影响。

语法

查询的基本语法如下:

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

查询响应取决于 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 查询支持以下表引擎:

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

*Log 系列的引擎在失败时不会提供自动数据恢复。使用 CHECK TABLE 查询及时跟踪数据丢失。

示例

默认的 CHECK TABLE 查询显示表的一般检查状态:

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

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

输出:

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

输出:

请注意,如果部分不存在,查询将返回错误:

接收“损坏”结果

危险

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

删除现有的校验和文件:

输出:

如果 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 值。