> ## 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.
> 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](/docs/ar/get-started/sample-datasets/uk-price-paid)، لذا يمكنك اختيارها. وهناك عدة أمثلة أخرى يمكنك الاطلاع عليها ضمن الفئة نفسها في الوثائق.
للاتصال بـ 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 لديك تفاصيل الاتصال.
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/user-docs/6.0.0/configuration/databases/) للحصول على إرشادات حول إضافة `clickhouse-connect` إلى الحاوية الخاصة بك.
2. ابدأ Superset (أو أعد تشغيله).
1. في Superset، اختر **البيانات** من القائمة العلوية ثم **قواعد البيانات** من القائمة المنسدلة. أضف قاعدة بيانات جديدة بالنقر على الزر **+ قاعدة بيانات**:
2. في الخطوة الأولى، اختر **ClickHouse Connect** كنوع قاعدة البيانات:
3. في الخطوة الثانية:
* فعّل SSL أو عطّله.
* أدخل معلومات الاتصال التي جمعتها سابقًا
* حدّد **اسم العرض**: يمكن أن يكون أي اسم تفضله. إذا كنت ستتصل بعدة قواعد بيانات ClickHouse، فاجعل الاسم أكثر وصفًا.
4. انقر على الزرين **اتصال** ثم **إنهاء** لإكمال معالج الإعداد، ومن المفترض أن تظهر قاعدة بياناتك في قائمة قواعد البيانات.
1. للتفاعل مع بيانات ClickHouse الخاصة بك باستخدام Superset، تحتاج إلى تعريف ***مجموعة بيانات***. من القائمة العلوية في Superset، اختر **البيانات**، ثم **مجموعات البيانات** من القائمة المنسدلة.
2. انقر زر إضافة مجموعة بيانات. اختر قاعدة البيانات الجديدة كمصدر البيانات، وستظهر لك الجداول المعرّفة في قاعدة بياناتك:
3. انقر زر **إضافة** أسفل نافذة الحوار، وسيظهر جدولك في قائمة مجموعات البيانات. وبذلك تصبح جاهزًا لإنشاء لوحة معلومات وتحليل بيانات ClickHouse الخاصة بك!
إذا كانت لديك خبرة سابقة مع Superset، فسيبدو لك هذا القسم مألوفًا جدًا. أما إذا كنت جديدًا على Superset، فهو... يشبه كثيرًا من أدوات التصور الرائعة الأخرى المتاحة — فالبدء به لا يستغرق وقتًا طويلًا، لكنك ستتعلم التفاصيل والفروق الدقيقة تدريجيًا مع الاستخدام.
1. تبدأ بلوحة معلومات. من القائمة العلوية في Superset، اختر **لوحات المعلومات**. انقر الزر الموجود في أعلى اليمين لإضافة لوحة معلومات جديدة. تحمل لوحة المعلومات التالية اسم **أسعار العقارات في المملكة المتحدة**:
2. لإنشاء مخطط جديد، اختر **المخططات** من القائمة العلوية وانقر الزر لإضافة مخطط جديد. ستظهر لك خيارات كثيرة. يوضح المثال التالي مخطط **مخطط دائري** باستخدام مجموعة البيانات **uk\_price\_paid** من القائمة المنسدلة **اختر مجموعة بيانات**:
3. تحتاج المخططات الدائرية في Superset إلى **بُعد** و**مقياس**، أما بقية الإعدادات فهي اختيارية. يمكنك اختيار الحقول التي تريدها للبُعد والمقياس، ويستخدم هذا المثال حقل ClickHouse `district` كبُعد و`AVG(price)` كمقياس.
5. إذا كنت تفضل المخططات الحلقية على المخططات الدائرية، فيمكنك ضبط ذلك، إلى جانب خيارات أخرى، ضمن **تخصيص**:
6. انقر زر **حفظ** لحفظ المخطط، ثم اختر **أسعار العقارات في المملكة المتحدة** من القائمة المنسدلة **إضافة إلى لوحة المعلومات**، وبعد ذلك يؤدي **حفظ والانتقال إلى لوحة المعلومات** إلى حفظ المخطط وإضافته إلى لوحة المعلومات:
7. هذا كل ما في الأمر. إن إنشاء لوحات معلومات في Superset استنادًا إلى البيانات المخزنة في ClickHouse يفتح أمامك عالمًا كاملًا من تحليلات البيانات فائقة السرعة!
