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

> DBeaver أداة متعددة المنصات لإدارة قواعد البيانات.

# ربط DBeaver بـ ClickHouse

export const PartnerBadge = () => {
  return <div className="PartnerBadge">
            <div className="PartnerBadgeIcon">
                <svg width="16" height="16" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
                    <polyline points="12.5 9.5 10 12 6 11 2.5 8.5" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" strokeWidth="1" />
                    <polyline points="4.54 4.41 8 3.5 11.46 4.41" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" strokeWidth="1" />
                    <path d="M2.15,3.78 L0.55,6.95 A0.5,0.5 0,0,0 0.77,7.62 L2.5,8.5 L4.54,4.41 L2.82,3.55 A0.5,0.5 0,0,0 2.15,3.78 Z" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" strokeWidth="1" />
                    <path d="M13.5,8.5 L15.23,7.62 A0.5,0.5 0,0,0 15.45,6.95 L13.85,3.78 A0.5,0.5 0,0,0 13.18,3.55 L11.46,4.41 Z" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" strokeWidth="1" />
                    <path d="M11.5,4.5 L9,4.5 L6.15,7.27 A0.5,0.5 0,0,0 6.24,8.05 C7.33,8.74 8.81,8.72 10,7.5 L12.5,9.5 L13.5,8.5" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" strokeWidth="1" />
                    <polyline points="7.75 13.5 5.15 12.85 3.5 11.67" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" strokeWidth="1" />
                </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>;
};

<PartnerBadge />

يتوفر DBeaver بعدة إصدارات. في هذا الدليل، يُستخدم [DBeaver Community](https://dbeaver.io/). اطّلع على الإصدارات المختلفة والميزات المتاحة [هنا](https://dbeaver.com/edition/). يتصل DBeaver بـ ClickHouse باستخدام JDBC.

<Note>
  يُرجى استخدام DBeaver بالإصدار 23.1.0 أو أحدث لتحسين دعم أعمدة `Nullable` في ClickHouse.
</Note>

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

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

  <Step title="نزّل DBeaver" id="2-download-dbeaver">
    يتوفر DBeaver على [https://dbeaver.io/download/](https://dbeaver.io/download/)
  </Step>

  <Step title="إضافة قاعدة بيانات" id="3-add-a-database">
    * استخدم إمّا القائمة **Database > New Database Connection** أو أيقونة **New Database Connection** في **Database Navigator** لفتح مربع الحوار **Connect to a database**:

    <Image img="https://mintcdn.com/private-7c7dfe99-vortex-format/uBraLefhLowMlCJn/images/integrations/sql-clients/dbeaver-add-database.webp?fit=max&auto=format&n=uBraLefhLowMlCJn&q=85&s=d13170116cf05aa7d1e3fccaf0c2078b" size="md" border alt="إضافة قاعدة بيانات جديدة" width="642" height="385" data-path="images/integrations/sql-clients/dbeaver-add-database.webp" />

    * حدِّد **Analytical** ثم **ClickHouse**:

    * أنشئ **JDBC URL**. في علامة التبويب **Main**، اضبط **Host** و**Port** و**Username** و**Password** و**Database**:

    <Image img="https://mintcdn.com/private-7c7dfe99-vortex-format/uBraLefhLowMlCJn/images/integrations/sql-clients/dbeaver-host-port.webp?fit=max&auto=format&n=uBraLefhLowMlCJn&q=85&s=a4c5374686400679f8a3dcaf8ea28682" size="md" border alt="تعيين اسم المضيف والمنفذ والمستخدم وكلمة المرور واسم قاعدة البيانات" width="650" height="654" data-path="images/integrations/sql-clients/dbeaver-host-port.webp" />

    * افتراضيًا، تكون الخاصية **SSL > Use SSL** غير مفعّلة. إذا كنت تتصل بـ ClickHouse Cloud أو بخادم يتطلب SSL على منفذ HTTP، فقم بتمكين **SSL > Use SSL**:

    <Image img="https://mintcdn.com/private-7c7dfe99-vortex-format/uBraLefhLowMlCJn/images/integrations/sql-clients/dbeaver-use-ssl.webp?fit=max&auto=format&n=uBraLefhLowMlCJn&q=85&s=edbbf67786c20b455722dc5dcab3810c" size="md" border alt="فعّل SSL إذا لزم الأمر" width="650" height="654" data-path="images/integrations/sql-clients/dbeaver-use-ssl.webp" />

    * اختبر الاتصال:

    <Image img="https://mintcdn.com/private-7c7dfe99-vortex-format/uBraLefhLowMlCJn/images/integrations/sql-clients/dbeaver-test-connection.webp?fit=max&auto=format&n=uBraLefhLowMlCJn&q=85&s=2ea33faea2733f6d7046c9c030f6e5e1" size="md" border alt="اختبر الاتصال" width="650" height="654" data-path="images/integrations/sql-clients/dbeaver-test-connection.webp" />

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

    <Image img="https://mintcdn.com/private-7c7dfe99-vortex-format/uBraLefhLowMlCJn/images/integrations/sql-clients/dbeaver-download-driver.webp?fit=max&auto=format&n=uBraLefhLowMlCJn&q=85&s=f7354cb232680c020f61a38ceaf823b3" size="md" border alt="تنزيل برنامج تشغيل ClickHouse" width="612" height="689" data-path="images/integrations/sql-clients/dbeaver-download-driver.webp" />

    * بعد تنزيل برنامج التشغيل، اختبر الاتصال مرة أخرى بالنقر على **Test**:

    <Image img="https://mintcdn.com/private-7c7dfe99-vortex-format/uBraLefhLowMlCJn/images/integrations/sql-clients/dbeaver-test-connection.webp?fit=max&auto=format&n=uBraLefhLowMlCJn&q=85&s=2ea33faea2733f6d7046c9c030f6e5e1" size="md" border alt="اختبر الاتصال" width="650" height="654" data-path="images/integrations/sql-clients/dbeaver-test-connection.webp" />
  </Step>

  <Step title="نفّذ استعلامًا على ClickHouse" id="4-query-clickhouse">
    افتح محرر استعلامات ونفّذ استعلامًا.

    * انقر بزر الماوس الأيمن على اتصالك واختر **SQL Editor > Open SQL Script** لفتح محرر استعلامات:

    <Image img="https://mintcdn.com/private-7c7dfe99-vortex-format/uBraLefhLowMlCJn/images/integrations/sql-clients/dbeaver-sql-editor.webp?fit=max&auto=format&n=uBraLefhLowMlCJn&q=85&s=67d520acd65629a64d5df1509615b21e" size="md" border alt="افتح محرر SQL" width="636" height="162" data-path="images/integrations/sql-clients/dbeaver-sql-editor.webp" />

    * مثال على استعلام لـ `system.query_log`:

    <Image img="https://mintcdn.com/private-7c7dfe99-vortex-format/uBraLefhLowMlCJn/images/integrations/sql-clients/dbeaver-query-log-select.webp?fit=max&auto=format&n=uBraLefhLowMlCJn&q=85&s=dd7616f8b87c9366c2dfbde21b2e3900" size="md" border alt="استعلام نموذجي" width="712" height="316" data-path="images/integrations/sql-clients/dbeaver-query-log-select.webp" />
  </Step>
</Steps>

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

اطّلع على [ويكي DBeaver](https://github.com/dbeaver/dbeaver/wiki) للتعرّف على ما يتيحه DBeaver، وعلى [وثائق ClickHouse](/ar/) للتعرّف على ما يتيحه ClickHouse.