احصل على تفاصيل اتصالك بـ Cloud

التحليلات اللحظيةمستودعات البياناتالرصدAI/MLCloud

المتطلبات المسبقة

To successfully follow this guide, you’ll need the following:

A running ClickHouse Cloud service. If you don’t have one yet, complete the Create your first Cloud service quickstart first.

يجب أيضًا أن تكون قد أكملت دليل البدء السريع إنشاء أول خدمة لك على ClickHouse Cloud، إذ ستحتاج إلى خدمة ClickHouse Cloud قائمة بالفعل للحصول على تفاصيل الاتصال منها.

ما الذي ستبنيه

في دليل البدء السريع هذا، ستتعلّم كيفية العثور على تفاصيل الاتصال الخاصة بخدمة ClickHouse Cloud لديك: اسم المضيف وأرقام المنافذ واسم المستخدم وكلمة المرور التي تحتاج إليها للاتصال من أي عميل خارجي أو أداة CLI أو تطبيق. وبحلول النهاية، ستعرف أين تجد هذه التفاصيل في Cloud console وكيف تتحقق من الاتصال باستخدام أمر curl بسيط، لتكون جاهزًا للاتصال من أدوات مثل clickhouse-local أو clickhouse-client أو أي برنامج تشغيل لـ ClickHouse.

افتح ClickHouse Cloud console

انتقل إلى ClickHouse Cloud console وسجّل الدخول إلى حسابك.من لوحة المعلومات الرئيسية، حدّد الخدمة التي تريد الاتصال بها. إذا كانت الخدمة في حالة idled، فانقر عليها وانتظر حتى تعود للعمل قبل المتابعة، إذ يجب أن تكون قيد التشغيل للتحقق من الاتصال في خطوة لاحقة.

اعثر على تفاصيل الاتصال الخاصة بك

انقر على خدمتك لفتح صفحة تفاصيلها، ثم انقر على زر Connect في الشريط الجانبي الأيسر:

زر Connect في ClickHouse Cloud console (الوضع الفاتح)

زر Connect في ClickHouse Cloud console (الوضع الداكن)

عند النقر على هذا الزر للمرة الأولى، سيظهر مربع حوار يعرض بيانات الاعتماد الخاصة بك:

التفاصيل	الوصف
Username	اسم المستخدم الخاص بك (غالبًا `default`)
Password	كلمة المرور التي تم إنشاؤها لخدمتك

ستجد أيضًا قائمة منسدلة تحتوي على أمثلة جاهزة لسلاسل الاتصال لبروتوكولات وواجهات مختلفة (مثل clickhouse-client وHTTPS وJDBC وغيرها)، ويمكنك نسخها مباشرة.

نزّل ملف بيانات الاعتماد أو انسخ كلمة المرور واحفظها في مكان آمن. بعد إغلاق مربع الحوار هذا، لن تتمكن من رؤية كلمة المرور مرة أخرى.

ستجد أيضًا اسم المضيف الخاص بخدمتك في صفحة تفاصيل الخدمة (على سبيل المثال abc123.us-east-1.aws.clickhouse.cloud). انسخه مع بيانات الاعتماد الخاصة بك، إذ ستحتاج إليهما في الخطوات المتبقية وفي أدلة البدء السريع اللاحقة.

إذا فقدت كلمة المرور، يمكنك إعادة تعيينها من علامة التبويب Settings الخاصة بخدمتك في Cloud console.

تعرّف على بروتوكولات الاتصال

توفّر ClickHouse Cloud بروتوكولين رئيسيين للشبكة، لكل منهما منفذه الخاص:

البروتوكول الأصلي (المنفذ 9440) - بروتوكول ثنائي يُستخدم بواسطة clickhouse-client وclickhouse-local ومعظم برامج التشغيل الخاصة باللغات. وهو الخيار الأسرع ويدعم جميع ميزات ClickHouse. ويتطلب استخدام TLS على Cloud.
بروتوكول HTTPS (المنفذ 8443) - واجهة تعتمد على HTTP ومفيدة لعملاء REST وcurl والأدوات المستندة إلى الويب وبرامج التشغيل التي تفضّل HTTP. ويتطلب أيضًا TLS على Cloud.

يتطلب كلا البروتوكولين تشفير TLS عند الاتصال بـ ClickHouse Cloud، ولا يمكنك الاتصال عبر plaintext. تتعامل معظم الأدوات مع هذا تلقائيًا عند تحديد المنفذ الصحيح، لكن قد تحتاج إلى تمرير الراية --secure أو تعيين ssl=true حسب العميل.في معظم أدلة البدء السريع ومسارات عمل CLI في هذه السلسلة، ستستخدم البروتوكول الأصلي على المنفذ 9440.

احفظ تفاصيل الاتصال لإعادة استخدامها

ستستخدم تفاصيل الاتصال هذه كثيرًا عبر أدلة البدء السريع. ولتجنب إعادة كتابتها في كل مرة، يمكنك تصديرها كمتغيرات بيئة في جلسة الطرفية لديك:

export CLICKHOUSE_HOST=YOUR_HOST.clickhouse.cloud
export CLICKHOUSE_USER=default
export CLICKHOUSE_PASSWORD=YOUR_PASSWORD

استبدل القيم باسم المضيف الفعلي واسم المستخدم وكلمة المرور. وإذا كنت ستتصل بخدمة Cloud الخاصة بك باستخدام clickhouse-client أو clickhouse-local، فاحصل على اسم المضيف باختيار ‘Native’ من القائمة المنسدلة المجاورة لعبارة “Connect with:”. انسخ اسم المضيف الذي يظهر بعد --host من مثال الاتصال المعروض.

تظل متغيرات البيئة هذه متاحة فقط خلال جلسة الطرفية الحالية. لا تخزّن كلمات المرور في ملفات تهيئة shell (.bashrc, .zshrc) ولا تُدرجها في نظام التحكم في الإصدارات.

الخطوات التالية

لديك الآن جميع تفاصيل الاتصال اللازمة للاتصال بخدمة ClickHouse Cloud الخاصة بك من أي أداة خارجية. وسيُستخدم اسم المضيف والمنفذ واسم المستخدم وكلمة المرور التي وجدتها هنا في بقية سلسلة أدلة البدء السريع. اطّلع بعد ذلك على أدلة البدء السريع التالية:

أو تعمّق أكثر بالاطّلاع على الوثائق المرجعية:

ClickHouse Academy — Master ClickHouse with expert-designed training for every skill level — Check out the ClickHouse academy for on-demand and live training

جميع أدلة البدء السريع

​المتطلبات المسبقة

​ما الذي ستبنيه

​افتح ClickHouse Cloud console

​اعثر على تفاصيل الاتصال الخاصة بك

​تعرّف على بروتوكولات الاتصال

​احفظ تفاصيل الاتصال لإعادة استخدامها

​الخطوات التالية

المتطلبات المسبقة

ما الذي ستبنيه

افتح ClickHouse Cloud console

اعثر على تفاصيل الاتصال الخاصة بك

تعرّف على بروتوكولات الاتصال

احفظ تفاصيل الاتصال لإعادة استخدامها

الخطوات التالية