system.keeper_snapshots 시스템 테이블

system.keeper_snapshots 는 인프로세스(in-process) ClickHouse Keeper를 실행하도록 이 노드가 구성된 경우에만 존재하는 테이블이에요. 인프로세스 Keeper 상태 머신이 추적하는 Raft 스냅샷 파일마다 하나의 행을 포함하며, 현재 리더로부터 받는 중인 스냅샷도 포함돼요.

출처: 문서

본문

ClickHouse Cloud에서의 조회 — 이 시스템 테이블의 데이터는 ClickHouse Cloud에서 각 노드에 로컬로 저장돼요. 따라서 모든 데이터의 완전한 뷰를 얻으려면 clusterAllReplicas 함수가 필요해요. 자세한 내용은 여기 를 참고하세요.

Description

이 테이블은 이 노드가 인프로세스 ClickHouse Keeper를 실행하도록 구성된 경우에만 존재해요. 인프로세스 Keeper 상태 머신이 추적하는 Raft 스냅샷 파일마다 하나의 행을 포함하며, 현재 리더로부터 받는 중인 스냅샷도 포함돼요.

Columns

last_log_index (UInt64) — 스냅샷이 다루는 마지막 로그 인덱스예요.
path (String) — 디스크의 스냅샷 파일 경로예요.
disk_name (String) — 스냅샷을 저장하는 디스크의 이름이에요.
size_bytes (UInt64) — 디스크의 스냅샷 파일 크기예요.
last_modified_at (DateTime) — 스냅샷 파일의 마지막 수정 시간이에요.
is_received (Bool) — 스냅샷이 현재 리더로부터 받는 중이면 true예요. 이러한 행의 경우 size_bytes 와 last_modified_at 은 지금까지 쓰인 부분 파일을 반영하므로 과소 보고할 수 있어요.
exists_on_disk (Bool) — 스냅샷 파일이 현재 디스크에 있는지 여부예요. 확정된 스냅샷(is_received = false)의 경우 파일이 대역 외로 제거되거나 손상되지 않는 한 항상 true예요. 받는 중인 스냅샷(is_received = true)은 바이트가 쓰이기 전에는 false일 수 있어요.

Examples

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           │
└────────────────┴───────────────────────────────┴───────────┴────────────┴─────────────────────┴─────────────┴────────────────┘