system.keeper_snapshots

仅当此节点运行进程内 ClickHouse Keeper 时，此系统表才会存在。该表为 Keeper 状态机跟踪的每个磁盘上的 Raft 快照各包含一行。

在 ClickHouse Cloud 中查询

此系统表中的数据分别保存在 ClickHouse Cloud 各节点的本地。因此，如需查看所有数据的完整情况，需要使用 clusterAllReplicas 函数。更多详情请参见此处。

说明

如果此节点未配置为运行进程内 ClickHouse Keeper，则此表不存在。对于进程内 Keeper 状态机跟踪的每个 Raft 快照文件，此表中都有一行，包括当前正在从 leader 接收的快照。

列

• last_log_index (UInt64) — 快照所涵盖的最后日志索引。
• path (String) — 磁盘上快照文件的路径。
• disk_name (String) — 存储该快照的磁盘名称。
• size_bytes (UInt64) — 磁盘上快照文件的大小。
• last_modified_at (日期时间) — 快照文件的最后修改时间。
• is_received (Bool) — 如果当前正在从 leader 接收该快照，则为 true。对于这类行，size_bytes 和 last_modified_at 反映的是截至目前已写入的部分文件，因此其值可能偏小。
• exists_on_disk (Bool) — 快照文件当前是否存在于磁盘上。对于已完成的快照 (is_received = false) ，除非文件被带外删除或已损坏，否则始终为 true；对于正在接收的快照 (is_received = true) ，在尚未写入任何字节前可能为 false。

示例：

SELECT * FROM system.keeper_snapshots ORDER BY last_log_index;

┌─last_log_index─┬─path──────────────────────────┬─disk_name─┬─size_bytes─┬────last_modified_at─┬─is_received─┬─exists_on_disk─┐
│           1000 │ snapshot_1000.bin.zstd        │ default   │      32468 │ 2026-05-22 14:00:00 │ false       │ true           │
│           2000 │ snapshot_2000.bin.zstd        │ default   │      48217 │ 2026-05-22 14:15:00 │ false       │ true           │
└────────────────┴───────────────────────────────┴───────────┴────────────┴─────────────────────┴─────────────┴────────────────┘