> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/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 = "lg"}) => {
  const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
  return <div className={`ch-image-${normalizedSize}`}>
      <Frame>
        <img src={img} alt={alt} />
      </Frame>
    </div>;
};

<CommunityMaintainedBadge />

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

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

<Steps>
  <Step title="اجمع تفاصيل ClickHouse الخاصة بك" id="1-gather-your-clickhouse-details">
    يستخدم QStudio ‏JDBC عبر HTTP(S) للاتصال بـ ClickHouse؛ وستحتاج إلى:

    * endpoint
    * رقم المنفذ
    * اسم المستخدم
    * كلمة المرور

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

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

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

    <div className="ch-image-md">
      <Frame>
        <img src="https://mintcdn.com/private-7c7dfe99/CFFsa2agBPbviR4r/images/_snippets/cloud-connect-button.webp?fit=max&auto=format&n=CFFsa2agBPbviR4r&q=85&s=ec0a298a33ca841e947fa5e8bae47362" alt="زر Connect لخدمة ClickHouse Cloud" width="998" height="932" data-path="images/_snippets/cloud-connect-button.webp" />
      </Frame>
    </div>

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

    <div className="ch-image-md">
      <Frame>
        <img src="https://mintcdn.com/private-7c7dfe99/CFFsa2agBPbviR4r/images/_snippets/connection-details-https.webp?fit=max&auto=format&n=CFFsa2agBPbviR4r&q=85&s=cb0fbd98aa2b5b7ca484c9f53395ee07" alt="تفاصيل اتصال HTTPS لخدمة ClickHouse Cloud" width="1320" height="1184" data-path="images/_snippets/connection-details-https.webp" />
      </Frame>
    </div>

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

  <Step title="نزّل QStudio" id="2-download-qstudio">
    QStudio متاح على [https://www.timestored.com/qstudio/download/](https://www.timestored.com/qstudio/download/)
  </Step>

  <Step title="أضف قاعدة بيانات" id="3-add-a-database">
    * عند فتح QStudio لأول مرة، انقر على خيارات القائمة **Server->Add Server** أو على زر إضافة الخادم في شريط الأدوات.
    * ثم أدخل التفاصيل التالية:

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

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

    إذا اكتشف QStudio أنك لم تثبّت ClickHouse JDBC driver، فسيعرض عليك تنزيله:
  </Step>

  <Step title="استعلم من ClickHouse" id="4-query-clickhouse">
    * افتح محرر استعلامات وشغّل استعلامًا. يمكنك تشغيل الاستعلامات باستخدام:

    * Ctrl + e - يشغّل النص المحدد

    * Ctrl + Enter - يشغّل السطر الحالي

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

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

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

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