منفذ الاستبطان

عندما يتعطل clickhouse-server أثناء بدء التشغيل أو الإيقاف، لا تقبل المنافذ العادية الاتصالات، ولا يمكن الاستعلام من الخادم عمّا يفعله.

منفذ الاستبطان هو مستمع TCP للبروتوكول الأصلي يبدأ قبل أن يبدأ الخادم بإرفاق الجداول، ولا يتوقف إلا بعد اكتمال فصل الجداول. خلال هذه الفترات، يمكن للمشغّل الاتصال به باستخدام clickhouse-client القياسي وتشغيل استعلامات مثل SHOW PROCESSLIST، أو SELECT * FROM system.stack_trace، أو SYSTEM INSTRUMENT ADD 'QueryMetricLog::startQuery' SLEEP ENTRY 0.5.

منفذ الاستبطان هو نقطة نهاية لـ بروتوكول قابل للتركيب موسومة بـ <introspection>true</introspection>. لا يُهيَّأ أي منفذ للاستبطان افتراضيًا:

<protocols>
    <introspection_native>
        <type>tcp</type>
        <introspection>true</introspection>
        <description>introspection native protocol (tcp)</description>
        <host>127.0.0.1</host>
        <port>9010</port>
    </introspection_native>

    <introspection_native_secure>
        <type>tls</type>
        <impl>introspection_native</impl>
        <introspection>true</introspection>
        <description>secure introspection native protocol (tcp_secure)</description>
        <host>127.0.0.1</host>
        <port>9011</port>
    </introspection_native_secure>
</protocols>

بما أنه نقطة نهاية عادية لبروتوكول قابل للتركيب، فهو يدعم كل ما تدعمه نقطة النهاية: host وport وdescription وقائمة السماح networks وdefault_database، وإحاطته بطبقتي tls وproxy1.

العلامة introspection هي خاصية لنقطة النهاية — أي الإدخال الذي يحمل port — ولا تُورَّث عبر مراجع impl، لذا يمكن مشاركة طبقة بين نقطة نهاية للاستبطان وأخرى عادية.

يجب أن تنتهي المكدسة بطبقة tcp، لأن الدلالات المذكورة أدناه ينفذها معالج البروتوكول الأصلي. عند بدء التشغيل، يُرفض تمييز نقطة نهاية تحتوي مكدستها على طبقة http أو mysql أو postgres أو prometheus أو interserver، ويُصدر الخطأ INVALID_CONFIG_PARAMETER، بدلًا من إنشاء منفذ يتوقف عن الاستجابة عند اشتداد الحاجة إليه.

• الاستعلامات المقبولة هي SELECT وSHOW وDESCRIBE وEXPLAIN وEXISTS وKILL QUERY وSYSTEM وSET وUSE. ويُرفض كل ما عدا ذلك، بما في ذلك استعلامات DDL والاستعلامات التي تعدّل البيانات، بالخطأ QUERY_IS_PROHIBITED، لأن المنفذ يكون مفتوحًا بينما يكون الخادم إما لم يكتمل إنشاؤه بعد أو قيد الإيقاف.
• يُرفض SYSTEM RELOAD CONFIG وSYSTEM RELOAD USERS بالخطأ QUERY_IS_PROHIBITED إلى أن يبدأ الخادم بالكامل، لأن إعادة تحميل التهيئة أثناء بدء التشغيل قد تُخلّ بترتيب التهيئة.
• تتجاوز الاستعلامات على هذه المنافذ max_concurrent_queries ومجدول أعباء العمل، كما يفعل SHOW PROCESSLIST.
• تُخدَم الاتصالات بواسطة تجمع خيوط مخصص، لذلك لا يؤثر استنفاد تجمع الاتصالات العادي في هذه المنافذ. ويُحدَّد حجم هذا التجمع بواسطة max_connections.
• تُقبل الاتصالات حتى عندما يرفض الخادم الاتصالات العادية بسبب الحمل الزائد على CPU.
• تُطبَّق المصادقة والتخويل بالكامل كالمعتاد: لا يمنح الاتصال بهذا المنفذ أي حقوق وصول إضافية. لكنه يرفع حدود التزامن المذكورة أعلاه، لذا اربطه بعنوان لا يمكن الوصول إليه إلا من قِبل المشغّلين.
• لا تخضع هذه المنافذ لـSYSTEM START LISTEN / SYSTEM STOP LISTEN (بما في ذلك ALL وCUSTOM) ولا يُعاد تهيئتها عند إعادة تحميل التهيئة.