> ## 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.
> Apache Superset هي منصة مفتوحة المصدر لاستكشاف البيانات وتصورها.
# ربط Superset بـ ClickHouse
export const ClickHouseSupportedBadge = () => {
return ;
};
export const Image = ({img, alt, size = "lg"}) => {
const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
return ;
};
Apache Superset هو منصة مفتوحة المصدر لاستكشاف البيانات وتصورها، ومكتوبة بلغة بايثون. يتصل Superset بـ ClickHouse باستخدام برنامج تشغيل لبايثون توفره ClickHouse. لنرَ كيف يعمل ذلك...
## الهدف
في هذا الدليل، ستنشئ لوحة معلومات في Superset باستخدام بيانات من قاعدة بيانات ClickHouse. وستبدو لوحة المعلومات على النحو التالي:
**أضف بعض البيانات**
إذا لم تكن لديك مجموعة بيانات للعمل عليها، يمكنك إضافة إحدى المجموعات التجريبية. يستخدم هذا الدليل مجموعة بيانات [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. تثبيت برنامج التشغيل
1. يستخدم Superset برنامج التشغيل `clickhouse-connect` للاتصال بـ ClickHouse. يمكنك الاطّلاع على تفاصيل `clickhouse-connect` على [https://pypi.org/project/clickhouse-connect/](https://pypi.org/project/clickhouse-connect/)، ويمكن تثبيته باستخدام الأمر التالي:
```console theme={null}
pip install clickhouse-connect
```
**إعداد Docker Compose**
بالنسبة إلى عمليات التثبيت المستندة إلى Docker، راجع [دليل تهيئة قاعدة بيانات Superset](https://superset.apache.org/docs/configuration/databases/#clickhouse) للحصول على إرشادات حول إضافة `clickhouse-connect` إلى الحاوية.
2. شغّل Superset (أو أعد تشغيله).
## 3. وصّل Superset بـ ClickHouse
1. داخل Superset، اختر **Data** من القائمة العلوية ثم **Databases** من القائمة المنسدلة. أضِف قاعدة بيانات جديدة بالنقر على زر **+ Database**:
2. في الخطوة الأولى، اختر **ClickHouse Connect** كنوع قاعدة البيانات:
3. في الخطوة الثانية:
* اضبط SSL على التشغيل أو الإيقاف.
* أدخل معلومات الاتصال التي جمعتها سابقًا.
* حدِّد **DISPLAY NAME**: يمكن أن يكون أي اسم تفضله. وإذا كنت ستتصل بعدة قواعد بيانات ClickHouse، فاجعل الاسم أكثر وصفًا.
4. انقر على الزرين **CONNECT** ثم **FINISH** لإكمال معالج الإعداد، ومن المفترض أن تظهر قاعدة بياناتك في قائمة قواعد البيانات.
## 4. إضافة مجموعة بيانات
1. للتعامل مع بيانات ClickHouse في Superset، تحتاج إلى تعريف ***مجموعة بيانات***. من القائمة العلوية في Superset، اختر **Data**، ثم **Datasets** من القائمة المنسدلة.
2. انقر على زر إضافة مجموعة بيانات. اختر قاعدة البيانات الجديدة كمصدر بيانات، وستظهر لك الجداول المعرّفة في قاعدة البيانات:
3. انقر على زر **ADD** أسفل مربع الحوار، وسيظهر جدولك في قائمة مجموعات البيانات. وبذلك تصبح جاهزًا لإنشاء لوحة معلومات وتحليل بيانات ClickHouse!
## 5. إنشاء المخططات ولوحة معلومات في Superset
إذا كانت لديك خبرة سابقة مع Superset، فسيبدو لك هذا القسم مألوفًا جدًا. أما إذا كنت جديدًا على Superset، فهو... يشبه كثيرًا من أدوات التصور الرائعة الأخرى المتاحة — فالبدء به لا يستغرق وقتًا طويلًا، لكنك ستتعلم التفاصيل والفروق الدقيقة تدريجيًا مع الاستخدام.
1. تبدأ بلوحة معلومات. من القائمة العلوية في Superset، اختر **لوحات المعلومات**. انقر الزر الموجود في أعلى اليمين لإضافة لوحة معلومات جديدة. تحمل لوحة المعلومات التالية اسم **أسعار العقارات في المملكة المتحدة**:
2. لإنشاء مخطط جديد، اختر **المخططات** من القائمة العلوية وانقر الزر لإضافة مخطط جديد. ستظهر لك خيارات كثيرة. يوضح المثال التالي مخطط **مخطط دائري** باستخدام مجموعة البيانات **uk\_price\_paid** من القائمة المنسدلة **اختر مجموعة بيانات**:
3. تحتاج المخططات الدائرية في Superset إلى **بُعد** و**مقياس**، أما بقية الإعدادات فهي اختيارية. يمكنك اختيار الحقول التي تريدها للبُعد والمقياس، ويستخدم هذا المثال حقل ClickHouse `district` كبُعد و`AVG(price)` كمقياس.
5. إذا كنت تفضل المخططات الحلقية على المخططات الدائرية، فيمكنك ضبط ذلك، إلى جانب خيارات أخرى، ضمن **تخصيص**:
6. انقر زر **حفظ** لحفظ المخطط، ثم اختر **أسعار العقارات في المملكة المتحدة** من القائمة المنسدلة **إضافة إلى لوحة المعلومات**، وبعد ذلك يؤدي **حفظ والانتقال إلى لوحة المعلومات** إلى حفظ المخطط وإضافته إلى لوحة المعلومات:
7. هذا كل ما في الأمر. إن إنشاء لوحات معلومات في Superset استنادًا إلى البيانات المخزنة في ClickHouse يفتح أمامك عالمًا كاملًا من تحليلات البيانات فائقة السرعة!