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

> 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/etDiFo_9fGSe5rMN/images/integrations/data-visualization/metabase_08.webp?fit=max&auto=format&n=etDiFo_9fGSe5rMN&q=85&s=87b54ca62deb669566b0a67ceac7e478" alt="تصور مخطط دائري في Metabase يعرض بيانات من ClickHouse" border width="1222" height="893" data-path="images/integrations/data-visualization/metabase_08.webp" />

<p />

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

  إذا لم تكن لديك مجموعة بيانات تعمل عليها، يمكنك إضافة إحدى مجموعات البيانات التجريبية. يستخدم هذا الدليل مجموعة بيانات [UK Price Paid](/docs/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/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="نزّل إضافة 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/etDiFo_9fGSe5rMN/images/integrations/data-visualization/metabase_01.webp?fit=max&auto=format&n=etDiFo_9fGSe5rMN&q=85&s=586acaa7da62b005cdc30f06f2319f11" 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/etDiFo_9fGSe5rMN/images/integrations/data-visualization/metabase_02.webp?fit=max&auto=format&n=etDiFo_9fGSe5rMN&q=85&s=42c1c15bc5fa13bbb2e3102f57fcf1ac" 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/etDiFo_9fGSe5rMN/images/integrations/data-visualization/metabase_03.webp?fit=max&auto=format&n=etDiFo_9fGSe5rMN&q=85&s=2e11e4ee4b8c466e146cf02e3aec5164" 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/etDiFo_9fGSe5rMN/images/integrations/data-visualization/metabase_04.webp?fit=max&auto=format&n=etDiFo_9fGSe5rMN&q=85&s=f868f4778e9a0a44e8f34485d3992e63" 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/etDiFo_9fGSe5rMN/images/integrations/data-visualization/metabase_06.webp?fit=max&auto=format&n=etDiFo_9fGSe5rMN&q=85&s=315caa354ba8213b40c642f3a3e1a9ca" 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/etDiFo_9fGSe5rMN/images/integrations/data-visualization/metabase_07.webp?fit=max&auto=format&n=etDiFo_9fGSe5rMN&q=85&s=e3b7c74397644bd33510044a6d24bad7" 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/etDiFo_9fGSe5rMN/images/integrations/data-visualization/metabase_08.webp?fit=max&auto=format&n=etDiFo_9fGSe5rMN&q=85&s=87b54ca62deb669566b0a67ceac7e478" 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>.
