Set up docs MCPالمتطلبات المسبقة
To successfully follow this guide, you’ll need the following:
- A running ClickHouse Cloud service. If you don’t have one yet, complete the ClickHouse Cloud quick start first.
يجب أيضًا أن تكون قد أكملت دليل البدء السريع مع ClickHouse Cloud، إذ ستحتاج إلى خدمة ClickHouse Cloud قائمة بالفعل للحصول على تفاصيل الاتصال منها.
ما الذي ستبنيه
في دليل البدء السريع هذا، ستتعلّم كيفية العثور على تفاصيل الاتصال الخاصة بخدمة ClickHouse Cloud لديك: اسم المضيف وأرقام المنافذ واسم المستخدم وكلمة المرور التي تحتاج إليها للاتصال من أي عميل خارجي أو أداة CLI أو تطبيق.
وبحلول النهاية، ستعرف أين تجد هذه التفاصيل في Cloud console وكيف تتحقق من الاتصال باستخدام أمر curl بسيط، لتكون جاهزًا للاتصال من أدوات مثل clickhouse-local أو clickhouse-client أو أي برنامج تشغيل لـ ClickHouse.
افتح ClickHouse Cloud console
انتقل إلى ClickHouse Cloud console وسجّل الدخول إلى حسابك.
من لوحة المعلومات الرئيسية، حدّد الخدمة التي تريد الاتصال بها. إذا كانت الخدمة في حالة idled، فانقر عليها وانتظر حتى تعود للعمل قبل المتابعة، إذ يجب أن تكون قيد التشغيل للتحقق من الاتصال في خطوة لاحقة.
اعثر على تفاصيل الاتصال الخاصة بك
انقر على خدمتك لفتح صفحة تفاصيلها، ثم انقر على زر Connect في الشريط الجانبي الأيسر:
عند النقر على هذا الزر للمرة الأولى، سيظهر مربع حوار يعرض بيانات الاعتماد الخاصة بك:
| التفاصيل | الوصف |
|---|---|
| Username | اسم المستخدم الخاص بك (غالبًا default) |
| Password | كلمة المرور التي تم إنشاؤها لخدمتك |
ستجد أيضًا قائمة منسدلة تحتوي على أمثلة جاهزة لسلاسل الاتصال لبروتوكولات وواجهات مختلفة (مثل clickhouse-client وHTTPS وJDBC وغيرها)، ويمكنك نسخها مباشرة.
ستجد أيضًا اسم المضيف الخاص بخدمتك في صفحة تفاصيل الخدمة (على سبيل المثال abc123.us-east-1.aws.clickhouse.cloud). انسخه مع بيانات الاعتماد الخاصة بك، إذ ستحتاج إليهما في الخطوات المتبقية وفي أدلة البدء السريع اللاحقة.
تعرّف على بروتوكولات الاتصال
توفّر 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 من مثال الاتصال المعروض.
الخطوات التالية
لديك الآن جميع تفاصيل الاتصال اللازمة للاتصال بخدمة ClickHouse Cloud الخاصة بك من أي أداة خارجية. وسيُستخدم اسم المضيف والمنفذ واسم المستخدم وكلمة المرور التي وجدتها هنا في بقية سلسلة أدلة البدء السريع.
اطّلع بعد ذلك على أدلة البدء السريع التالية:
أو تعمّق أكثر بالاطّلاع على الوثائق المرجعية:
