system.keeper_snapshots

Table système présente uniquement lorsque ce nœud exécute un in-process ClickHouse Keeper. Contient une ligne pour chaque snapshot Raft sur disque suivi par la machine à états de Keeper.

Interroger dans ClickHouse Cloud

Les données de cette table système sont stockées localement sur chaque nœud de ClickHouse Cloud. Pour obtenir une vue complète de l’ensemble des données, il faut donc utiliser la fonction clusterAllReplicas. Consultez cette page pour plus de détails.

Description

Cette table n’existe pas si ce nœud n’est pas configuré pour exécuter un ClickHouse Keeper in-process. Elle contient une ligne par fichier de snapshot Raft suivi par la machine à états du Keeper in-process, y compris les snapshots en cours de réception provenant du leader.

Colonnes

• last_log_index (UInt64) — Dernier index de journal couvert par le snapshot.
• path (String) — Chemin du fichier de snapshot sur le disque.
• disk_name (String) — Nom du disque qui stocke le snapshot.
• size_bytes (UInt64) — Taille du fichier de snapshot sur le disque.
• last_modified_at (DateTime) — Date et heure de dernière modification du fichier de snapshot.
• is_received (Bool) — true si le snapshot est en cours de réception depuis le leader. Pour ces lignes, size_bytes et last_modified_at reflètent le fichier partiel tel qu’écrit jusqu’à présent et peuvent donc être sous-estimés.
• exists_on_disk (Bool) — Indique si le fichier de snapshot est actuellement présent sur le disque. Toujours true pour les snapshots finalisés (is_received = false), sauf si le fichier a été supprimé par un processus externe ou s’il est corrompu ; peut être false pour les snapshots en cours de réception (is_received = true) avant l’écriture du moindre octet.

Exemple :

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