system.keeper_snapshots

Tabla del sistema que solo existe cuando este nodo ejecuta un ClickHouse Keeper en el mismo proceso. Contiene una fila por cada instantánea de Raft almacenada en disco de la que hace seguimiento la máquina de estados de Keeper.

Consultas en ClickHouse Cloud

Los datos de esta tabla del sistema se almacenan localmente en cada nodo de ClickHouse Cloud. Por lo tanto, para obtener una vista completa de todos los datos, es necesario usar la función clusterAllReplicas. Consulta aquí para más detalles.

Descripción

Esta tabla no existe si este nodo no está configurado para ejecutar ClickHouse Keeper en el mismo proceso. Contiene una fila por cada archivo de instantánea de Raft gestionado por la máquina de estados de Keeper que se ejecuta en el mismo proceso, incluidas las instantáneas que se están recibiendo actualmente del líder.

Columnas

• last_log_index (UInt64) — Último índice de log cubierto por la instantánea.
• path (String) — Ruta del archivo de instantánea en el disco.
• disk_name (String) — Nombre del disco que almacena la instantánea.
• size_bytes (UInt64) — Tamaño del archivo de instantánea en disco.
• last_modified_at (DateTime) — Fecha y hora de la última modificación del archivo de instantánea.
• is_received (Bool) — true si la instantánea se está recibiendo actualmente desde el líder. Para esas filas, size_bytes y last_modified_at reflejan el archivo parcial tal como se ha escrito hasta el momento y pueden indicar un valor inferior al real.
• exists_on_disk (Bool) — Indica si el archivo de instantánea está presente actualmente en disco. Siempre es true para las instantáneas finalizadas (is_received = false), a menos que el archivo se haya eliminado fuera de banda o esté corrupto; puede ser false para las instantáneas que se están recibiendo (is_received = true) antes de que se haya escrito ningún byte.

Ejemplo:

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