如何高效查询ClickHouse MergeTree表的当前损坏分片数量？

要避免CHECK TABLE全量扫描数据的开销，直接查询ClickHouse的系统元数据表就能快速获取损坏parts的数量，完全不需要扫描表内实际数据。

核心查询语句 #

针对本地表

SELECT count(*) AS broken_parts_count
FROM system.parts
WHERE table = '你的表名' 
  AND database = '你的数据库名'
  AND is_broken = 1

针对集群环境的分布式表

如果是集群部署，可通过system.cluster_parts一次性查询所有节点的损坏parts：

SELECT count(*) AS broken_parts_count
FROM system.cluster_parts
WHERE table = '你的表名' 
  AND database = '你的数据库名'
  AND is_broken = 1

为什么这个方法高效？ #

system.parts和system.cluster_parts是ClickHouse维护的系统元数据表，存储了所有表分片（parts）的元信息，包括是否损坏的标记（is_broken字段）。查询这些表只读取元数据，速度极快，完全不会触发全表数据扫描，非常适合用于监控告警。

预防Suspiciously many broken parts错误的建议 #

• 设置监控告警：基于上面的查询配置阈值告警，比如当损坏parts数量超过5时触发告警，提前介入处理
• 排查根因：损坏parts通常由磁盘故障、磁盘空间不足、写入过程中断、硬件错误等导致，先定位问题根源再处理
• 处理损坏parts：确认数据可丢弃后，用ALTER TABLE 你的数据库名.你的表名 DROP PART '损坏的分片名';删除损坏分片；部分场景下可尝试DETACH PART再ATTACH PART修复，但成功率不高
• 优化写入流程：确保写入链路稳定，避免中途中断；启用幂等写入；调整parts合并策略（如merge_tree的merge_with_ttl_timeout等参数）减少异常分片产生

内容的提问来源于stack exchange，提问作者Pierre Louis