system.keeper_cluster

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

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

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

الوصف

لا يكون هذا الجدول موجودًا إذا لم تكن هذه العقدة مُهيأة لتشغيل ClickHouse Keeper ضمن العملية. ويحتوي على صف واحد لكل عضو في عنقود Raft، جامعًا بين طوبولوجيا العنقود الثابتة (من إعدادات Raft) وموضع السجل الخاص بالعقدة المحلية نفسها.

تملأ كل عقدة قيمة last_log_index واحدة فقط — وهي الصف المطابق لـ server_id الخاص بها. ولا تُعرض هنا مواضع سجلات العقد الأخرى لأنها لا تُتتبَّع إلا على القائد، كما أن هذا العرض ليس متماثلًا على مستوى العنقود.

الأعمدة

• server_id (Int32) — معرّف خادم Raft لعضو العنقود هذا.
• host (String) — المضيف المستخرَج من نقطة النهاية (البادئة التي تسبق آخر نقطتين).
• endpoint (String) — نقطة نهاية Raft الخام كما هي مُعدّة (host:port).
• is_observer (Bool) — تكون القيمة true إذا كان هذا العضو مراقبًا غير مُصوّت، ومُعدًّا عبر <can_become_leader>false</can_become_leader>.
• priority (Int32) — أولوية Raft لهذا العضو؛ وتُفضَّل القيم الأعلى أثناء انتخاب القائد.
• is_leader (Bool) — تكون القيمة true إذا كان هذا العضو هو قائد Raft الحالي.
• is_self (Bool) — تكون القيمة true إذا كان هذا الصف يصف عقدة Keeper المحلية.
• last_log_index (Nullable(UInt64)) — أعلى فهرس سجل في مخزن سجلات Raft المحلي على هذه العقدة. لا تُعبَّأ هذه القيمة إلا في الصف المطابق للعقدة الحالية (is_self = true)؛ وتكون NULL في الصفوف الأخرى.

مثال:

SELECT * FROM system.keeper_cluster ORDER BY server_id;

┌─server_id─┬─host──┬─endpoint───┬─is_observer─┬─priority─┬─is_leader─┬─is_self─┬─last_log_index─┐
│         1 │ node1 │ node1:9234 │ false       │        3 │ true      │ true    │             42 │
│         2 │ node2 │ node2:9234 │ false       │        2 │ false     │ false   │           ᴺᵁᴸᴸ │
│         3 │ node3 │ node3:9234 │ true        │        1 │ false     │ false   │           ᴺᵁᴸᴸ │
└───────────┴───────┴────────────┴─────────────┴──────────┴───────────┴─────────┴────────────────┘