> ## 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.

> QStudio أداة SQL مجانية.

# توصيل QStudio بـ ClickHouse

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>;
};

QStudio هي واجهة رسومية مجانية لـ SQL، تتيح تشغيل نصوص SQL البرمجية، واستعراض الجداول بسهولة، وإنشاء المخططات وتصدير النتائج. وهي تعمل على جميع أنظمة التشغيل ومع أي قاعدة بيانات.

يتصل QStudio بـ ClickHouse باستخدام JDBC.

<div id="1-gather-your-clickhouse-details">
  ## 1. اجمع معلومات ClickHouse الخاصة بك
</div>

يستخدم QStudio بروتوكول JDBC عبر HTTP(S) للاتصال بـ 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 لديك تفاصيل الاتصال.

<div id="2-download-qstudio">
  ## 2. تنزيل QStudio
</div>

يتوفر QStudio على الرابط [https://www.timestored.com/qstudio/download/](https://www.timestored.com/qstudio/download/)

<div id="3-add-a-database">
  ## 3. إضافة قاعدة بيانات
</div>

* عند فتح QStudio لأول مرة، انقر على خيارات القائمة **Server->Add Server** أو على زر إضافة خادم في شريط الأدوات.
* ثم أدخِل التفاصيل التالية:

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/amY-JDMREAaO7mx6/images/integrations/sql-clients/qstudio-add-connection.png?fit=max&auto=format&n=amY-JDMREAaO7mx6&q=85&s=fdd1a841afe95f9a2953062f361dbf94" size="lg" border alt="شاشة إعداد اتصال قاعدة بيانات QStudio تعرض إعدادات اتصال ClickHouse" width="701" height="601" data-path="images/integrations/sql-clients/qstudio-add-connection.png" />

1. نوع الخادم: Clickhouse.com
2. ملاحظة: في حقل Host، يجب أن تُدرج https\://
   Host: [https://abc.def.clickhouse.cloud](https://abc.def.clickhouse.cloud)
   Port: 8443
3. اسم المستخدم: default
   كلمة المرور: `XXXXXXXXXXX`
4. انقر على Add

إذا اكتشف QStudio أن برنامج تشغيل ClickHouse JDBC غير مثبّت لديك، فسيعرض تنزيله لك:

<div id="4-query-clickhouse">
  ## 4. تنفيذ استعلامات على ClickHouse
</div>

* افتح محرر الاستعلامات ونفّذ استعلامًا. يمكنك تنفيذ الاستعلامات باستخدام:

* Ctrl + e - ينفّذ النص المحدد

* Ctrl + Enter - ينفّذ السطر الحالي

* مثال على استعلام:

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/amY-JDMREAaO7mx6/images/integrations/sql-clients/qstudio-running-query.png?fit=max&auto=format&n=amY-JDMREAaO7mx6&q=85&s=78ebcb051210cd96ad6fed7858d42e1d" size="lg" border alt="واجهة QStudio تعرض تنفيذ استعلام SQL نموذجي على قاعدة بيانات ClickHouse" width="1283" height="721" data-path="images/integrations/sql-clients/qstudio-running-query.png" />

<div id="next-steps">
  ## الخطوات التالية
</div>

اطّلع على [QStudio](https://www.timestored.com/qstudio) للتعرّف على إمكانات QStudio، وعلى [وثائق ClickHouse](/ar/) للتعرّف على إمكانات ClickHouse.