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

> Metabase هي أداة UI سهلة الاستخدام ومفتوحة المصدر لطرح الأسئلة حول بياناتك.

# توصيل Metabase بـ 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 />

Metabase هي أداة واجهة مستخدم سهلة الاستخدام ومفتوحة المصدر لطرح الأسئلة حول بياناتك. Metabase هو تطبيق Java يمكن تشغيله بسهولة عبر <a href="https://www.metabase.com/start/oss/jar" target="_blank">تنزيل ملف JAR</a> ثم تشغيله باستخدام `java -jar metabase.jar`. ويتصل Metabase بـ ClickHouse باستخدام برنامج تشغيل JDBC تقوم بتنزيله ووضعه في المجلد `plugins`:

<div id="goal">
  ## الهدف
</div>

في هذا الدليل، ستطرح بعض الأسئلة على بيانات ClickHouse باستخدام Metabase وتعرض الإجابات بصريًا. وستبدو إحدى هذه الإجابات كما يلي:

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-postgresql-tls-support/sK1EDai1DhVYGATV/images/integrations/data-visualization/metabase_08.webp?fit=max&auto=format&n=sK1EDai1DhVYGATV&q=85&s=a880fdf2411d14e858d381d8e1c69cbb" alt="تصور مخطط دائري في Metabase يعرض بيانات من ClickHouse" border width="1222" height="893" data-path="images/integrations/data-visualization/metabase_08.webp" />

<p />

<Tip>
  **أضف بعض البيانات**

  إذا لم تكن لديك مجموعة بيانات تعمل عليها، يمكنك إضافة إحدى مجموعات البيانات التجريبية. يستخدم هذا الدليل مجموعة بيانات [UK Price Paid](/ar/get-started/sample-datasets/uk-price-paid)، لذا يمكنك اختيارها. وهناك عدة مجموعات أخرى يمكنك الاطلاع عليها ضمن فئة التوثيق نفسها.
</Tip>

<Steps>
  <Step title="اجمع تفاصيل الاتصال الخاصة بك" id="1-gather-your-connection-details">
    للاتصال بـ 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-postgresql-tls-support/cTIaEq6k6KYDgBI1/images/_snippets/cloud-connect-button.webp?fit=max&auto=format&n=cTIaEq6k6KYDgBI1&q=85&s=dd441fc2272e292760011d48e81d43d4" 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-postgresql-tls-support/cTIaEq6k6KYDgBI1/images/_snippets/connection-details-https.webp?fit=max&auto=format&n=cTIaEq6k6KYDgBI1&q=85&s=878b1fe94ea520377426f69503e38994" alt="تفاصيل اتصال HTTPS لخدمة ClickHouse Cloud" width="1320" height="1184" data-path="images/_snippets/connection-details-https.webp" />
      </Frame>
    </div>

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

  <Step title="نزّل إضافة ClickHouse لـ Metabase" id="2--download-the-clickhouse-plugin-for-metabase">
    1. إذا لم يكن لديك مجلد `plugins`، فأنشئه كمجلد فرعي في الموقع الذي حفظت فيه `metabase.jar`.

    2. الإضافة عبارة عن ملف JAR باسم `clickhouse.metabase-driver.jar`. نزّل أحدث إصدار من ملف JAR من <a href="https://github.com/clickhouse/metabase-clickhouse-driver/release" target="_blank">[https://github.com/clickhouse/metabase-clickhouse-driver/releases/latest](https://github.com/clickhouse/metabase-clickhouse-driver/releases/latest)</a>

    3. احفظ `clickhouse.metabase-driver.jar` في مجلد `plugins`.

    4. شغّل Metabase (أو أعد تشغيله) حتى يتم تحميل برنامج التشغيل بشكل صحيح.

    5. افتح Metabase عبر <a href="http://localhost:3000/" target="_blank">[http://hostname:3000](http://hostname:3000)</a>. عند التشغيل الأول، سترى شاشة ترحيب وسيتعين عليك الإجابة عن مجموعة من الأسئلة. إذا طُلب منك تحديد قاعدة بيانات، فاختر "**سأضيف بياناتي لاحقًا**":
  </Step>

  <Step title="توصيل Metabase بـ ClickHouse" id="3--connect-metabase-to-clickhouse">
    1. انقر على أيقونة الترس في الزاوية العلوية اليمنى، ثم اختر **إعدادات المسؤول** للانتقال إلى <a href="http://localhost:3000/admin/settings/setup" target="_blank">صفحة إدارة Metabase</a>.

    2. انقر على **إضافة قاعدة بيانات**. أو يمكنك بدلًا من ذلك النقر على علامة التبويب **قواعد البيانات** ثم اختيار زر **إضافة قاعدة بيانات**.

    3. إذا تم تثبيت برنامج التشغيل بنجاح، فسترى **ClickHouse** في القائمة المنسدلة الخاصة بـ **نوع قاعدة البيانات**:

           <Image size="md" img="https://mintcdn.com/private-7c7dfe99-postgresql-tls-support/sK1EDai1DhVYGATV/images/integrations/data-visualization/metabase_01.webp?fit=max&auto=format&n=sK1EDai1DhVYGATV&q=85&s=03b48e138871222caa6da7c11fda5e34" alt="اختيار قاعدة البيانات في Metabase مع ظهور ClickHouse كأحد الخيارات" border width="1168" height="504" data-path="images/integrations/data-visualization/metabase_01.webp" />

    4. امنح قاعدة البيانات **اسمًا معروضًا**، وهو إعداد في Metabase، لذا يمكنك استخدام أي اسم تريده.

    5. أدخِل تفاصيل الاتصال لقاعدة بيانات ClickHouse. فعِّل اتصالًا آمنًا إذا كان ClickHouse server مُعدًّا لاستخدام SSL. على سبيل المثال:

           <Image size="md" img="https://mintcdn.com/private-7c7dfe99-postgresql-tls-support/sK1EDai1DhVYGATV/images/integrations/data-visualization/metabase_02.webp?fit=max&auto=format&n=sK1EDai1DhVYGATV&q=85&s=a7e6c412b508ef81624080feb5678a46" alt="نموذج تفاصيل الاتصال في Metabase لقاعدة بيانات ClickHouse" border width="682" height="1020" data-path="images/integrations/data-visualization/metabase_02.webp" />

    6. انقر على زر **حفظ**، وسيقوم Metabase بفحص قاعدة البيانات بحثًا عن الجداول.
  </Step>

  <Step title="تشغيل استعلام SQL" id="4-run-a-sql-query">
    1. اخرج من **إعدادات المسؤول** بالنقر على زر **Exit admin** في الزاوية العلوية اليمنى.

    2. في الزاوية العلوية اليمنى، انقر على قائمة **+ New** وستلاحظ أنه يمكنك طرح أسئلة وتشغيل استعلامات SQL وإنشاء لوحة المعلومات:

           <Image size="sm" img="https://mintcdn.com/private-7c7dfe99-postgresql-tls-support/sK1EDai1DhVYGATV/images/integrations/data-visualization/metabase_03.webp?fit=max&auto=format&n=sK1EDai1DhVYGATV&q=85&s=55dd92f43d7d1c12682e6a9666e789fd" alt="قائمة New في Metabase تعرض خيارات إنشاء أسئلة واستعلامات SQL ولوحات معلومات" border width="283" height="322" data-path="images/integrations/data-visualization/metabase_03.webp" />

    3. على سبيل المثال، إليك استعلام SQL يعمل على table باسم `uk_price_paid` ويُرجع متوسط السعر المدفوع حسب السنة من 1995 إلى 2022:

           <Image size="md" img="https://mintcdn.com/private-7c7dfe99-postgresql-tls-support/sK1EDai1DhVYGATV/images/integrations/data-visualization/metabase_04.webp?fit=max&auto=format&n=sK1EDai1DhVYGATV&q=85&s=bd321bbcde7124619fa37f39464a914c" alt="محرر SQL في Metabase يعرض استعلامًا على بيانات UK price paid" border width="674" height="1003" data-path="images/integrations/data-visualization/metabase_04.webp" />
  </Step>

  <Step title="اطرح سؤالًا" id="5-ask-a-question">
    1. انقر على **+ New** واختر **Question**. لاحظ أنه يمكنك إنشاء سؤال بدءًا من database وtable. على سبيل المثال، يُطرح السؤال التالي على table باسم `uk_price_paid` في قاعدة البيانات `default`. إليك سؤالًا بسيطًا يحسب متوسط السعر حسب البلدة ضمن مقاطعة Greater Manchester:

           <Image size="md" img="https://mintcdn.com/private-7c7dfe99-postgresql-tls-support/sK1EDai1DhVYGATV/images/integrations/data-visualization/metabase_06.webp?fit=max&auto=format&n=sK1EDai1DhVYGATV&q=85&s=785b1b1c91e37bc6b1e44bfece84faf1" alt="واجهة منشئ الأسئلة في Metabase مع بيانات أسعار UK" border width="869" height="1049" data-path="images/integrations/data-visualization/metabase_06.webp" />

    2. انقر على زر **Visualize** لعرض النتائج في شكل table.

           <Image size="md" img="https://mintcdn.com/private-7c7dfe99-postgresql-tls-support/sK1EDai1DhVYGATV/images/integrations/data-visualization/metabase_07.webp?fit=max&auto=format&n=sK1EDai1DhVYGATV&q=85&s=595291f9910e9f09127297bb513d4ac2" alt="تصور في Metabase يعرض نتائج جدولية لمتوسط الأسعار حسب البلدة" border width="1222" height="893" data-path="images/integrations/data-visualization/metabase_07.webp" />

    3. أسفل النتائج، انقر على زر **تصور** لتغيير التصور إلى مخطط شريطي (أو أي خيار آخر متاح):

           <Image size="md" img="https://mintcdn.com/private-7c7dfe99-postgresql-tls-support/sK1EDai1DhVYGATV/images/integrations/data-visualization/metabase_08.webp?fit=max&auto=format&n=sK1EDai1DhVYGATV&q=85&s=a880fdf2411d14e858d381d8e1c69cbb" alt="تصور مخطط دائري في Metabase لمتوسط الأسعار حسب البلدة في Greater Manchester" border width="1222" height="893" data-path="images/integrations/data-visualization/metabase_08.webp" />
  </Step>
</Steps>

<div id="learn-more">
  ## تعرّف على المزيد
</div>

يمكنك العثور على مزيد من المعلومات حول Metabase وكيفية إنشاء لوحات المعلومات من خلال <a href="https://www.metabase.com/docs/latest/" target="_blank">الاطلاع على وثائق Metabase</a>.
