Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs
49.6kGet Started

system.keeper_snapshots

View as MarkdownEdit this pageReport an issueSet up docs MCP

说明

如果此节点未配置为运行进程内 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           │
└────────────────┴───────────────────────────────┴───────────┴────────────┴─────────────────────┴─────────────┴────────────────┘
Navigation