> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-detect-table-modification.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
> Metabase هي أداة UI سهلة الاستخدام ومفتوحة المصدر لطرح الأسئلة حول بياناتك.
# توصيل Metabase بـ ClickHouse
export const PartnerBadge = () => {
return ;
};
export const Image = ({img, alt, size = "lg"}) => {
const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
return ;
};
Metabase هي أداة واجهة مستخدم سهلة الاستخدام ومفتوحة المصدر لطرح الأسئلة حول بياناتك. Metabase هو تطبيق Java يمكن تشغيله بسهولة عبر تنزيل ملف JAR ثم تشغيله باستخدام `java -jar metabase.jar`. ويتصل Metabase بـ ClickHouse باستخدام برنامج تشغيل JDBC تقوم بتنزيله ووضعه في المجلد `plugins`:
## الهدف
في هذا الدليل، ستطرح بعض الأسئلة على بيانات ClickHouse باستخدام Metabase وتعرض الإجابات بصريًا. وستبدو إحدى هذه الإجابات كما يلي:
**أضف بعض البيانات**
إذا لم تكن لديك مجموعة بيانات تعمل عليها، يمكنك إضافة إحدى مجموعات البيانات التجريبية. يستخدم هذا الدليل مجموعة بيانات [UK Price Paid](/ar/get-started/sample-datasets/uk-price-paid)، لذا يمكنك اختيارها. وهناك عدة مجموعات أخرى يمكنك الاطلاع عليها ضمن فئة التوثيق نفسها.
## 1. اجمع تفاصيل الاتصال
للاتصال بـ ClickHouse باستخدام HTTP(S)، تحتاج إلى المعلومات التالية:
| المعلمات | الوصف |
| ------------------------- | --------------------------------------------------------------------------------------------- |
| `HOST` and `PORT` | عادةً ما يكون المنفذ 8443 عند استخدام TLS، أو 8123 عند عدم استخدام TLS. |
| `DATABASE NAME` | افتراضيًا، توجد قاعدة بيانات باسم `default`. استخدم اسم قاعدة البيانات التي تريد الاتصال بها. |
| `USERNAME` and `PASSWORD` | افتراضيًا، يكون اسم المستخدم `default`. استخدم اسم المستخدم المناسب لحالة الاستخدام لديك. |
تتوفر تفاصيل خدمة ClickHouse Cloud الخاصة بك في ClickHouse Cloud console.
حدِّد خدمة ثم انقر على **Connect**:
اختر **HTTPS**. ستظهر تفاصيل الاتصال في مثال لأمر `curl`.
إذا كنت تستخدم ClickHouse مُدارًا ذاتيًا، فسيُحدِّد مسؤول ClickHouse لديك تفاصيل الاتصال.
## 2. نزّل المكوّن الإضافي لـ ClickHouse في Metabase
1. إذا لم يكن لديك مجلد `plugins`، فأنشئه كمجلد فرعي في الموقع الذي حفظت فيه `metabase.jar`.
2. المكوّن الإضافي عبارة عن ملف JAR باسم `clickhouse.metabase-driver.jar`. نزّل أحدث إصدار من ملف JAR من [https://github.com/clickhouse/metabase-clickhouse-driver/releases/latest](https://github.com/clickhouse/metabase-clickhouse-driver/releases/latest)
3. احفظ `clickhouse.metabase-driver.jar` في مجلد `plugins`.
4. شغّل Metabase (أو أعد تشغيله) لكي يتم تحميل برنامج التشغيل بشكل صحيح.
5. افتح Metabase على [http://hostname:3000](http://hostname:3000). عند التشغيل لأول مرة، ستظهر لك شاشة ترحيب وسيتعيّن عليك الإجابة عن مجموعة من الأسئلة. إذا طُلب منك اختيار قاعدة بيانات، فاختر "**سأضيف بياناتي لاحقًا**":
## 3. توصيل Metabase بـ ClickHouse
1. انقر على أيقونة الترس في الزاوية العلوية اليمنى، ثم اختر **إعدادات المسؤول** للانتقال إلى صفحة إدارة Metabase.
2. انقر على **إضافة قاعدة بيانات**. أو يمكنك بدلًا من ذلك النقر على علامة التبويب **قواعد البيانات** ثم اختيار زر **إضافة قاعدة بيانات**.
3. إذا تم تثبيت برنامج التشغيل بنجاح، فسترى **ClickHouse** في القائمة المنسدلة الخاصة بـ **نوع قاعدة البيانات**:
4. امنح قاعدة البيانات **اسمًا معروضًا**، وهو إعداد في Metabase، لذا يمكنك استخدام أي اسم تريده.
5. أدخِل تفاصيل الاتصال لقاعدة بيانات ClickHouse. فعِّل اتصالًا آمنًا إذا كان ClickHouse server مُعدًّا لاستخدام SSL. على سبيل المثال:
6. انقر على زر **حفظ**، وسيقوم Metabase بفحص قاعدة البيانات بحثًا عن الجداول.
## 4. تشغيل استعلام SQL
1. اخرج من **إعدادات المسؤول** بالنقر على زر **Exit admin** في الزاوية العلوية اليمنى.
2. في الزاوية العلوية اليمنى، انقر على قائمة **+ New** ولاحظ أنه يمكنك طرح أسئلة وتشغيل استعلامات SQL وإنشاء لوحة معلومات:
3. على سبيل المثال، إليك استعلام SQL يُشغَّل على جدول باسم `uk_price_paid` ويُرجع متوسط السعر المدفوع حسب السنة من 1995 إلى 2022:
## 5. اطرح سؤالًا
1. انقر على **+ New** وحدد **Question**. لاحظ أنه يمكنك إنشاء سؤال بدءًا من قاعدة بيانات وجدول. على سبيل المثال، يوجَّه السؤال التالي إلى جدول باسم `uk_price_paid` في قاعدة البيانات `default`. إليك سؤالًا بسيطًا يحسب متوسط السعر حسب المدينة، ضمن مقاطعة Greater Manchester:
2. انقر على زر **Visualize** لرؤية النتائج في عرض جدولي.
3. أسفل النتائج، انقر على زر **تصور** لتغيير التصور إلى مخطط شريطي (أو أي خيار آخر من الخيارات المتاحة):
## تعرّف على المزيد
يمكنك العثور على مزيد من المعلومات حول Metabase وكيفية إنشاء لوحات المعلومات من خلال الاطلاع على وثائق Metabase.