system.keeper_snapshots

Tabela de sistema que existe apenas quando este nó executa um ClickHouse Keeper in-process. Contém uma linha para cada snapshot Raft em disco rastreado pela máquina de estados do Keeper.

Consultas no ClickHouse Cloud

Os dados nesta tabela de sistema são mantidos localmente em cada nó do ClickHouse Cloud. Portanto, para obter uma visão completa de todos os dados, é necessário usar a função clusterAllReplicas. Consulte aqui para mais detalhes.

Descrição

Esta tabela não existe se este nó não estiver configurado para executar um ClickHouse Keeper in-process. Ela contém uma linha para cada arquivo de snapshot do Raft acompanhado pela máquina de estados do Keeper in-process, incluindo snapshots que estão sendo recebidos no momento do líder.

Colunas

• last_log_index (UInt64) — Último índice de log abrangido pelo snapshot.
• path (String) — Caminho do arquivo de snapshot no disco.
• disk_name (String) — Nome do disco que armazena o snapshot.
• size_bytes (UInt64) — Tamanho do arquivo de snapshot no disco.
• last_modified_at (DateTime) — Hora da última modificação do arquivo de snapshot.
• is_received (Bool) — true se o snapshot estiver sendo recebido no momento do líder. Para essas linhas, size_bytes e last_modified_at refletem o arquivo parcial conforme foi gravado até agora e podem indicar um valor menor que o real.
• exists_on_disk (Bool) — Indica se o arquivo de snapshot está presente no disco no momento. Sempre true para snapshots finalizados (is_received = false), a menos que o arquivo tenha sido removido externamente ou esteja corrompido; pode ser false para snapshots em recebimento (is_received = true) antes que qualquer byte seja gravado.

Exemplo:

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