وصّل ProbeDeck بـ ClickHouse

ProbeDeck هو عميل لنظامَي iOS وiPadOS للتحقق من سلامة خادم ClickHouse، وفحص جداول system، وتشغيل استعلامات SQL. يتصل بواجهة ClickHouse HTTP عبر شبكة الجهاز أو من خلال مضيف bastion عبر SSH؛ ولا يتطلب خادم ترحيل.

• ثبّت ProbeDeck من App Store.
• استخدم iOS أو iPadOS 17.0 أو إصدارًا أحدث.
• اسمح للجهاز بالوصول إلى نقطة نهاية ClickHouse عبر HTTP أو HTTPS من خلال شبكته أو شبكة VPN أو مضيف bastion عبر SSH.
• أنشئ مستخدم ClickHouse لديه حق الوصول إلى قواعد البيانات التي تريد الاستعلام عنها.
• امنح المستخدم صلاحية SELECT على جداول system ذات الصلة لأغراض المراقبة.

تعتمد بعض أقسام المراقبة على جداول السجل الاختيارية أو جداول النظام الأحدث. على سبيل المثال، يتطلب system.server_settings، الذي يستخدمه ProbeDeck لمعرفة حد الذاكرة المُهيأ، ClickHouse 23.3 أو إصدارًا أحدث. يضع ProbeDeck علامة «محدود» على القسم المتأثر عندما يكون مصدره غير متاح.

1. يرسل ProbeDeck طلبات SQL إلى نقطة نهاية ClickHouse عبر HTTP(S).
2. يقرأ بيانات المراقبة من جداول system باستخدام مستخدم ClickHouse المُهيأ.
3. يعرض التطبيق نتائج الاستعلام وعروض المراقبة على الجهاز. ويمكن لمضيف bastion عبر SSH تمرير اتصال HTTP(S) نفسه عندما لا يتوفر مسار مباشر إلى نقطة النهاية من الجهاز.

جمع تفاصيل الاتصال بالخدمة

في وحدة تحكم ClickHouse Cloud، افتح خدمتك، واختر Connect، ثم اختر HTTPS.

للاتصال بـ ClickHouse باستخدام HTTP(S)، تحتاج إلى المعلومات التالية:

المعلمات	الوصف
HOST and PORT	عادةً ما يكون المنفذ 8443 عند استخدام TLS، أو 8123 عند عدم استخدام TLS.
DATABASE NAME	افتراضيًا، توجد قاعدة بيانات باسم default. استخدم اسم قاعدة البيانات التي تريد الاتصال بها.
USERNAME and PASSWORD	افتراضيًا، يكون اسم المستخدم default. استخدم اسم المستخدم المناسب لحالة الاستخدام لديك.

تتوفر تفاصيل خدمة ClickHouse Cloud الخاصة بك في ClickHouse Cloud console. حدِّد خدمة ثم انقر على Connect:

اختر HTTPS. ستظهر تفاصيل الاتصال في مثال لأمر curl.

إذا كنت تستخدم ClickHouse مُدارًا ذاتيًا، فسيُحدِّد مسؤول ClickHouse لديك تفاصيل الاتصال.

إضافة اتصال في ProbeDeck

1. في شاشة اتصال، اضغط على +.
2. أدخل اسمًا للاتصال واسم المضيف من دون https://.
3. اضبط Port على 8443 وفعّل TLS.
4. أدخل اسم مستخدم قاعدة البيانات وكلمة المرور من مربع الحوار Connect. اسم قاعدة البيانات اختياري.
5. اضغط على اختبار الاتصال. يعرض ProbeDeck إصدار الخادم وزمن الرحلة ذهابًا وإيابًا بعد نجاح التحقق.
6. اضغط على حفظ.

يُصادق ProbeDeck طلبات SQL المرسلة إلى نقطة نهاية الخدمة باستخدام بيانات اعتماد قاعدة البيانات هذه. يستخدم ClickHouse Cloud مفاتيح على مستوى المؤسسة من صفحة API Keys لواجهة برمجة تطبيقات Cloud ونقاط نهاية واجهة برمجة تطبيقات الاستعلام. ولا يستخدم مسار اتصال SQL في ProbeDeck هذه المفاتيح.

فعّل SSH Tunnel في نموذج الاتصال وأدخل:

1. مضيف Bastion ومنفذ SSH (الافتراضي هو 22).
2. اسم مستخدم SSH.
3. إما كلمة مرور SSH أو مفتاحًا خاصًا.

يفتح ProbeDeck قناة SSH من نوع direct-tcpip من مضيف Bastion إلى مضيف ClickHouse ومنفذ HTTP(S) في قسم Server. عند الاتصال لأول مرة، قارن بصمة مفتاح مضيف Bastion بتنسيق SHA-256 بالقيمة التي يزوّدك بها مسؤول الخادم قبل قبولها.

يرسل ProbeDeck اسم مستخدم قاعدة البيانات وكلمة المرور في ترويسات الطلب X-ClickHouse-User و X-ClickHouse-Key. ولا يضع بيانات الاعتماد في عنوان URL.

لاستخدام TLS المتبادل، فعّل TLS Client Certificate واستورد ملف PKCS#12 (.p12) يحتوي على شهادة العميل ومفتاحه الخاص، ثم أدخل عبارة المرور الخاصة به.

عندما تعرض نقطة نهاية مستضافة ذاتيًا شهادة موقعة ذاتيًا أو شهادة صادرة عن CA خاصة، يعرض ProbeDeck بصمة SHA-256 والجهة المُصدِرة والموضوع وفترة الصلاحية. قارن البصمة بالقيمة التي يقدمها مسؤول الخادم قبل قبولها. يربط ProbeDeck هذا القرار بذلك الاتصال؛ ويؤدي تغيير الشهادة إلى إيقاف الاتصال حتى تراجعه.

يخزن ProbeDeck أسرار الاتصال ومواد المفاتيح المستوردة في سلسلة مفاتيح iOS على الجهاز.

افتح الاتصال المحفوظ واختر المراقبة. تعرض لوحة المعلومات ملخصًا للمصادر التالية:

انقر على الاستعلامات قيد التشغيل لفرز الاستعلامات النشطة حسب الوقت المنقضي، وفحص الذاكرة والصفوف المقروءة.

يستخدم هذا المثال مجموعة بيانات UK Property Price. حمّل مجموعة البيانات إلى uk_price_paid، ثم:

1. افتح الاتصال واختر البيانات.
2. افتح محرر SQL.
3. شغّل هذا الاستعلام المحدود والقراءة فقط:

SELECT
    town,
    count() AS sales,
    round(avg(price)) AS average_price
FROM uk_price_paid
GROUP BY town
ORDER BY sales DESC
LIMIT 10

يجب أن تتضمن النتيجة عشر بلدات مع عدد المعاملات ومتوسط الأسعار لكل منها.

• يعمل ProbeDeck على نظامَي iOS وiPadOS بالإصدار 17.0 أو أحدث.
• يمكن للمستخدمين المجانيين حفظ اتصال واحد في كل مرة. ويؤدي حذفه إلى إتاحة الخانة؛ بينما يتيح ProbeDeck Pro عددًا غير محدود من الاتصالات المحفوظة.
• يدعم واجهة ClickHouse عبر HTTP(S)، وليس البروتوكول الأصلي.
• يحمّل ProbeDeck نتائج SQL على صفحات تضم 200 صف، ويحدّ كل طلب بـ 10,000 صف. استخدم عبارة WHERE انتقائية وLIMIT للجداول الكبيرة.
• تعتمد إمكانية الوصول إلى Monitoring على أذونات مستخدم ClickHouse وعلى جداول السجل الاختيارية.
• يحتاج الجهاز إلى مسار للوصول إلى نقطة النهاية عبر شبكته أو VPN أو نفق SSH المدمج.
• لا يتطلب Monitoring وSQL للقراءة فقط عملية شراء داخل التطبيق. تتطلب KILL QUERY وKILL MUTATION، وعبارات الكتابة وDDL، والإجراءات التشغيلية الأخرى ProbeDeck Pro.

• اطّلع على موقع ProbeDeck الإلكتروني للحصول على تفاصيل خاصة بالمنتج.
• اطّلع على وثائق واجهة ClickHouse HTTP لمعرفة إعدادات الخادم.