首页/数据/NoSQL 速查/system.parts 查看数据分片文件
ClickHouse56 条

system.parts 查看数据分片文件

system.parts 记录每个表的活动 part 与大小、行数、分区:排查小 part 过多、磁盘占用与分区数据量时先查这里。

NoSQL 速查数据更新于 2026-10-12
关键列database、table、partition、name、active、rows、bytes_on_disk、data_compressed_bytes、marks
过滤active 表示当前生效的 part;合并中的旧 part 会以非 active 短暂保留
常用聚合按表统计 part 数量与总大小

示例

示例
SELECT
    table,
    count() AS parts,
    sum(rows) AS rows,
    formatReadableSize(sum(bytes_on_disk)) AS size
FROM system.parts
WHERE active
GROUP BY table
ORDER BY sum(bytes_on_disk) DESC
LIMIT 10;
小 part 数量持续偏高说明写入批次太碎,合并跟不上;优化方向是攒批导入而不是反复 OPTIMIZE。

易错点

  • 统计磁盘占用要加 active 条件,否则会把正在合并或待清理的 part 重复计入
  • part 名含分区与编号信息可用于手工定位,但不要依赖命名规律做业务逻辑

数据来源与参考

  • ClickHouse Docs: system.parts
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌