> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-8c05c8a2.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

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

> تعرّف على كيفية العثور على اسم المضيف والمنفذ وبيانات الاعتماد لخدمة ClickHouse Cloud الخاصة بك، حتى تتمكن من الاتصال بها من العملاء الخارجيين وأدوات CLI والتطبيقات.

<a href="/ar/get-started/quickstarts/home"><Badge size="lg" color="gray" icon="arrow-left">جميع أدلة البدء السريع</Badge></a>

<div className="mt-2 flex flex-wrap gap-2">
  <Badge size="lg" color="blue">التحليلات اللحظية</Badge>
  <Badge size="lg" color="blue">مستودعات البيانات</Badge>
  <Badge size="lg" color="blue">الرصد</Badge>
  <Badge size="lg" color="blue">AI/ML</Badge>
  <Badge size="lg" color="orange">Cloud</Badge>
</div>

<div id="prerequisites">
  ## المتطلبات المسبقة
</div>

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](/get-started/quickstarts/create-your-first-service-on-cloud) quickstart first.

يجب أيضًا أن تكون قد أكملت دليل البدء السريع [إنشاء أول خدمة لك على ClickHouse Cloud](/ar/get-started/quickstarts/create-your-first-service-on-cloud)، إذ ستحتاج إلى خدمة ClickHouse Cloud قائمة بالفعل للحصول على تفاصيل الاتصال منها.

<div id="what-youll-build">
  ## ما الذي ستبنيه
</div>

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

<Steps titleSize="h3">
  <Step>
    ### افتح ClickHouse Cloud console

    انتقل إلى [ClickHouse Cloud console](https://console.clickhouse.cloud/) وسجّل الدخول إلى حسابك.

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

  <Step>
    ### اعثر على تفاصيل الاتصال الخاصة بك

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

    <img className="block dark:hidden w-2/3 mx-auto" src="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/51i4N09qYnRiav8Z/images/get-started/quickstarts/connect-light.png?fit=max&auto=format&n=51i4N09qYnRiav8Z&q=85&s=d46d401b5e708d1c059793bd6e2dd053" alt="زر Connect في ClickHouse Cloud console (الوضع الفاتح)" width="1050" height="964" data-path="images/get-started/quickstarts/connect-light.png" />

    <img className="hidden dark:block w-2/3 mx-auto" src="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/51i4N09qYnRiav8Z/images/get-started/quickstarts/connect-dark.png?fit=max&auto=format&n=51i4N09qYnRiav8Z&q=85&s=e4dfd3542fb4477fbb781861190a5634" alt="زر Connect في ClickHouse Cloud console (الوضع الداكن)" width="1034" height="960" data-path="images/get-started/quickstarts/connect-dark.png" />

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

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

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

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

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

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

  <Step>
    ### تعرّف على بروتوكولات الاتصال

    توفّر 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**.
  </Step>

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

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

    ```bash theme={null}
    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` من مثال الاتصال المعروض.

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

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

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

اطّلع بعد ذلك على أدلة البدء السريع التالية:

* [إدراج البيانات باستخدام clickhouse-client](/ar/get-started/quickstarts/insert-data-using-clickhouse-client)
* [أنشئ أول جدول MergeTree](/ar/get-started/quickstarts/create-your-first-mergetree-table)

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

* [الواجهة الأصلية (TCP)](/ar/concepts/features/interfaces/tcp)
* [واجهة HTTP](/ar/concepts/features/interfaces/http)

<Frame caption="Check out the ClickHouse academy for on-demand and live training">
  <a href="https://learn.clickhouse.com/" target="_blank">
    <img src="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/GaEHa-fd8w_5w7tQ/images/academy.png?fit=max&auto=format&n=GaEHa-fd8w_5w7tQ&q=85&s=46be2d7327e98b07a2a4b1a422642a30" alt="ClickHouse Academy — Master ClickHouse with expert-designed training for every skill level" width="560" noZoom data-path="images/academy.png" />
  </a>
</Frame>

<div className="mt-8">
  <a href="/ar/get-started/quickstarts/home"><Badge size="lg" color="gray" icon="arrow-left">جميع أدلة البدء السريع</Badge></a>
</div>