system.keeper_snapshots

이 노드에서 인프로세스 ClickHouse Keeper를 실행하는 경우에만 존재하는 시스템 테이블입니다. Keeper 상태 머신이 추적하는 디스크의 각 Raft 스냅샷마다 1개의 행이 있습니다.

ClickHouse Cloud에서 쿼리하기

이 시스템 테이블의 데이터는 ClickHouse Cloud의 각 노드에 로컬로 저장됩니다. 따라서 전체 데이터를 모두 확인하려면 clusterAllReplicas 함수를 사용해야 합니다. 자세한 내용은 여기를 참조하십시오.

설명

이 노드가 인프로세스 ClickHouse Keeper를 실행하도록 구성되지 않은 경우 이 테이블은 존재하지 않습니다. 이 테이블에는 현재 리더로부터 수신 중인 스냅샷을 포함해, 인프로세스 Keeper 상태 머신이 추적하는 각 Raft 스냅샷 파일마다 1개의 행이 있습니다.

컬럼

• 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일 수 있습니다.

예시:

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