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

> استعلم بكفاءة عن مجموعات بيانات ضخمة جدًا، مع التحليل والنمذجة في بيئة دفتر بيانات مألوفة.

# توصيل ClickHouse بـ Deepnote

export const CommunityMaintainedBadge = () => {
  return <div className="CommunityMaintainedBadge">
            <div className="CommunityMaintainedIcon">
            <svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" fill="currentColor" viewBox="0 0 256 256">
                <path d="M244.8,150.4a8,8,0,0,1-11.2-1.6A51.6,51.6,0,0,0,192,128a8,8,0,0,1-7.37-4.89,8,8,0,0,1,0-6.22A8,8,0,0,1,192,112a24,24,0,1,0-23.24-30,8,8,0,1,1-15.5-4A40,40,0,1,1,219,117.51a67.94,67.94,0,0,1,27.43,21.68A8,8,0,0,1,244.8,150.4ZM190.92,212a8,8,0,1,1-13.84,8,57,57,0,0,0-98.16,0,8,8,0,1,1-13.84-8,72.06,72.06,0,0,1,33.74-29.92,48,48,0,1,1,58.36,0A72.06,72.06,0,0,1,190.92,212ZM128,176a32,32,0,1,0-32-32A32,32,0,0,0,128,176ZM72,120a8,8,0,0,0-8-8A24,24,0,1,1,87.24,82a8,8,0,1,0,15.5-4A40,40,0,1,0,37,117.51,67.94,67.94,0,0,0,9.6,139.19a8,8,0,1,0,12.8,9.61A51.6,51.6,0,0,1,64,128,8,8,0,0,0,72,120Z"></path>
            </svg>
        </div>
            تتم صيانته من قِبل المجتمع
        </div>;
};

export const Image = ({img, alt, size}) => {
  return <Frame>
      <img src={img} alt={alt} />
    </Frame>;
};

يُعد <a href="https://www.deepnote.com/" target="_blank">Deepnote</a> دفتر بيانات تعاونيًا صُمّم لتمكين الفرق من اكتشاف الرؤى ومشاركتها. وإلى جانب توافقه مع Jupyter، فهو يعمل في السحابة ويوفّر لك مكانًا مركزيًا موحدًا للتعاون والعمل بكفاءة على مشاريع علم البيانات.

يفترض هذا الدليل أن لديك بالفعل حسابًا على Deepnote وأن لديك مثيل ClickHouse قيد التشغيل.

<div id="interactive-example">
  ## مثال تفاعلي
</div>

إذا كنت ترغب في استكشاف مثال تفاعلي لإجراء استعلامات على ClickHouse من دفاتر البيانات في Deepnote، فانقر الزر أدناه لتشغيل مشروع قالب متصل بـ [ClickHouse playground](/ar/get-started/sample-datasets/playground).

[<img src="https://deepnote.com/buttons/launch-in-deepnote.svg" alt="تشغيل في Deepnote" width="32" />](https://deepnote.com/launch?template=ClickHouse%20and%20Deepnote)

<div id="connect-to-clickhouse">
  ## الاتصال بـ ClickHouse
</div>

1. من داخل Deepnote، اختر قسم "Integrations" وانقر على بطاقة ClickHouse.

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/5u7Mhe0xzzPTUaXM/images/integrations/data-visualization/deepnote_01.png?fit=max&auto=format&n=5u7Mhe0xzzPTUaXM&q=85&s=20277d313e9548276e1fd6879bd99127" alt="بطاقة تكامل ClickHouse" border width="3024" height="1368" data-path="images/integrations/data-visualization/deepnote_01.png" />

2. أدخِل تفاصيل الاتصال الخاصة بمثيل ClickHouse لديك:

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

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

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

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/Qke-GQkmVyWEhvPu/images/_snippets/cloud-connect-button.png?fit=max&auto=format&n=Qke-GQkmVyWEhvPu&q=85&s=a41d53ce6c46ccccb2855331a8dcc841" size="md" alt="زر Connect لخدمة ClickHouse Cloud" border width="998" height="932" data-path="images/_snippets/cloud-connect-button.png" />

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

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/Qke-GQkmVyWEhvPu/images/_snippets/connection-details-https.png?fit=max&auto=format&n=Qke-GQkmVyWEhvPu&q=85&s=0377c34215bd524b359c0d20dd96bed3" size="md" alt="تفاصيل اتصال HTTPS لخدمة ClickHouse Cloud" border width="1320" height="1184" data-path="images/_snippets/connection-details-https.png" />

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

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/5u7Mhe0xzzPTUaXM/images/integrations/data-visualization/deepnote_02.png?fit=max&auto=format&n=5u7Mhe0xzzPTUaXM&q=85&s=45c78b3502ff31743440f48ea9e8b567" alt="مربع حوار تفاصيل ClickHouse" border width="1827" height="1061" data-path="images/integrations/data-visualization/deepnote_02.png" />

***ملاحظة:*** إذا كان اتصالك بـ ClickHouse محميًا باستخدام IP Access List، فقد تحتاج إلى السماح لعناوين IP الخاصة بـ Deepnote. اقرأ المزيد عن ذلك في [وثائق Deepnote](https://docs.deepnote.com/integrations/authorize-connections-from-deepnote-ip-addresses).

3. تهانينا! لقد نجحت الآن في دمج ClickHouse مع Deepnote.

<div id="using-clickhouse-integration">
  ## استخدام تكامل ClickHouse.
</div>

1. ابدأ بالاتصال بـ تكامل ClickHouse الموجود على يمين الـ دفتر بيانات.

   <Image size="lg" img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/5u7Mhe0xzzPTUaXM/images/integrations/data-visualization/deepnote_03.png?fit=max&auto=format&n=5u7Mhe0xzzPTUaXM&q=85&s=6634d0161b4e5283a8f8f8e9354963fd" alt="ClickHouse details dialog" border width="3008" height="1086" data-path="images/integrations/data-visualization/deepnote_03.png" />

2. أنشئ الآن block جديدًا من نوع ClickHouse استعلام، ثم نفّذ استعلام على الـ database. ستُحفَظ نتائج الاستعلام كـ DataFrame وتُخزَّن في المتغير المحدد في block الـ SQL.

3. يمكنك أيضًا تحويل أي [كتلة SQL](https://docs.deepnote.com/features/sql-cells) حالية إلى block من نوع ClickHouse.