system.keeper_snapshots

جدول نظامي لا يوجد إلا عندما تُشغِّل هذه العقدة ClickHouse Keeper داخل العملية نفسها. يحتوي على صف واحد لكل لقطة Raft مخزنة على القرص يتتبّعها آلة الحالة الخاصة بـ Keeper.

الاستعلام في ClickHouse Cloud

تُخزَّن بيانات جدول النظام هذا محليًا على كل عقدة في ClickHouse Cloud. لذلك، يتطلب الحصول على رؤية كاملة لجميع البيانات استخدام الدالة clusterAllReplicas. راجع هنا لمزيد من التفاصيل.

الوصف

لا يكون هذا الجدول موجودًا إذا لم تكن هذه العقدة مُعدّة لتشغيل ClickHouse Keeper داخل العملية. ويحتوي على صف واحد لكل ملف لقطة Raft تتبّعه آلة الحالة الخاصة بـ Keeper داخل العملية، بما في ذلك اللقطات التي يجري استلامها حاليًا من العقدة القائدة.

الأعمدة

• 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) — ما إذا كان ملف اللقطة موجودًا حاليًا على القرص. تكون القيمة دائمًا true بالنسبة إلى اللقطات المكتملة (is_received = false) ما لم يُزَل الملف خارج النظام أو يصبح تالفًا؛ وقد تكون false بالنسبة إلى اللقطات قيد الاستلام (is_received = true) قبل كتابة أي بايتات.

مثال:

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