> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-fbfa8bee.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
> Lightdash هي أداة BI حديثة مفتوحة المصدر ومبنية على dbt، تتيح للفرق استكشاف البيانات وتصورها من ClickHouse عبر طبقة دلالية. تعرّف على كيفية ربط Lightdash بـ ClickHouse للحصول على تحليلات سريعة ومحكومة ومدعومة بـ dbt.
# Lightdash
export const PartnerBadge = () => {
return ;
};
export const Image = ({img, alt, size}) => {
return
;
};
Lightdash هي **منصة ذكاء أعمال قائمة على الذكاء الاصطناعي أولًا** ومصممة لفرق البيانات الحديثة، إذ تجمع بين انفتاح dbt وأداء ClickHouse. ومن خلال ربط ClickHouse بـ Lightdash، تحصل الفرق على **تجربة تحليلات ذاتية الخدمة مدعومة بالذكاء الاصطناعي** ومرتكزة على الطبقة الدلالية في dbt، بحيث تُجاب كل الأسئلة باستخدام مقاييس محكومة ومتسقة.
يحب المطورون Lightdash بفضل معماريتها المفتوحة، ونماذج YAML الخاضعة للتحكم في الإصدارات، وعمليات التكامل التي تلائم سير عملهم مباشرةً — من GitHub إلى IDE.
تجمع هذه الشراكة بين **سرعة ClickHouse** و**تجربة المطور التي تقدمها Lightdash**، مما يجعل استكشاف الرؤى وتصورها وأتمتتها بالذكاء الاصطناعي أسهل من أي وقت مضى.
## أنشئ لوحة معلومات تفاعلية باستخدام Lightdash وClickHouse
في هذا الدليل، سترى كيف يتصل **Lightdash** بـ **ClickHouse** لاستكشاف نماذج dbt لديك وإنشاء لوحات معلومات تفاعلية.
يوضح المثال أدناه لوحة معلومات مكتملة تستند إلى بيانات من ClickHouse.
### اجمع تفاصيل الاتصال
عند إعداد الاتصال بين Lightdash وClickHouse، ستحتاج إلى التفاصيل التالية:
* **Host:** العنوان الذي تعمل عليه قاعدة بيانات ClickHouse
* **User:** اسم مستخدم قاعدة بيانات ClickHouse
* **Password:** كلمة مرور قاعدة بيانات ClickHouse
* **DB name:** اسم قاعدة بيانات ClickHouse
* **Schema:** المخطط الافتراضي الذي يستخدمه dbt لتجميع مشروعك وتشغيله (ستجده في `profiles.yml`)
* **Port:** منفذ واجهة ClickHouse عبر HTTPS (الافتراضي: `8443`)
* **Secure:** فعّل هذا الخيار لاستخدام HTTPS/SSL لإجراء اتصالات آمنة
* **Retries:** عدد المرات التي يعيد فيها Lightdash محاولة تنفيذ استعلامات ClickHouse الفاشلة (الافتراضي: `3`)
* **Start of week:** اختر اليوم الذي يبدأ فيه أسبوع التقارير؛ ويكون الإعداد الافتراضي وفقًا لإعداد المستودع لديك
للاتصال بـ 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 لديك تفاصيل الاتصال.
***
### قم بتهيئة ملف تعريف dbt لـ ClickHouse
في Lightdash، تستند الاتصالات إلى **مشروع dbt** الحالي لديك.
للاتصال بـ ClickHouse، تأكد من أن ملفك المحلي `~/.dbt/profiles.yml` يتضمن إعداد target صالحًا لـ ClickHouse.
على سبيل المثال:
### أنشئ مشروع Lightdash متصلًا بـ ClickHouse
بمجرد تهيئة ملف تعريف dbt لاستخدام ClickHouse، ستحتاج أيضًا إلى ربط **مشروع dbt** الخاص بك بـ Lightdash.
ولأن هذه العملية هي نفسها في جميع مستودعات البيانات، فلن نتناولها هنا بالتفصيل — يمكنك اتباع دليل Lightdash الرسمي لاستيراد مشروع dbt:
[استيراد مشروع dbt → توثيق Lightdash](https://docs.lightdash.com/get-started/setup-lightdash/connect-project#2-import-a-dbt-project?utm_source=clickhouse\&utm_medium=partner\&utm_campaign=integration_docs)
بعد ربط مشروع dbt الخاص بك، سيكتشف Lightdash تلقائيًا تهيئة ClickHouse من ملف `profiles.yml`. وبمجرد نجاح اختبار الاتصال، ستتمكن من البدء في استكشاف نماذج dbt وإنشاء لوحات المعلومات المدعومة من ClickHouse.
***
### استكشف بيانات ClickHouse في Lightdash
بمجرد الاتصال، يزامن Lightdash تلقائيًا نماذج dbt الخاصة بك ويعرض ما يلي:
* **الأبعاد** و**المقاييس** المعرّفة في YAML
* **منطق الطبقة الدلالية**، مثل المقاييس وعمليات الربط وعمليات الاستكشاف
* **لوحات المعلومات** التي تعمل باستعلامات ClickHouse اللحظية
يمكنك الآن إنشاء لوحات معلومات، ومشاركة الرؤى، وحتى استخدام **Ask AI** لإنشاء تصورات مباشرةً استنادًا إلى ClickHouse — من دون الحاجة إلى كتابة SQL يدويًا.
***
### تحديد المقاييس والأبعاد في Lightdash
في Lightdash، تُعرَّف جميع **المقاييس** و**الأبعاد** مباشرةً في ملفات `.yml` الخاصة بنماذج dbt. وهذا يجعل منطق الأعمال لديك خاضعًا للتحكم في الإصدارات، ومتسقًا، وشفافًا بالكامل.
يضمن تعريف هذه العناصر في YAML أن يستخدم فريقك التعريفات نفسها في مختلف لوحات المعلومات والتحليلات. على سبيل المثال، يمكنك إنشاء مقاييس قابلة لإعادة الاستخدام مثل `total_order_count` أو `total_revenue` أو `avg_order_value` إلى جانب نماذج dbt مباشرةً، من دون الحاجة إلى تكرارها في واجهة المستخدم.
لمعرفة المزيد حول كيفية تعريف هذه العناصر، راجع أدلة Lightdash التالية:
* [كيفية إنشاء المقاييس](https://docs.lightdash.com/guides/how-to-create-metrics?utm_source=clickhouse\&utm_medium=partner\&utm_campaign=integration_docs)
* [كيفية إنشاء الأبعاد](https://docs.lightdash.com/guides/how-to-create-dimensions?utm_source=clickhouse\&utm_medium=partner\&utm_campaign=integration_docs)
***
### استعلم عن بياناتك من الجداول
بمجرد ربط مشروع dbt الخاص بك بـ Lightdash ومزامنته معه، يمكنك البدء في استكشاف البيانات مباشرةً من **الجداول** (أو "الاستكشافات").
يمثّل كل جدول نموذجًا في dbt، ويتضمّن المقاييس والأبعاد التي عرّفتها في YAML.
تتكوّن صفحة **Explore** من خمسة أقسام رئيسية:
1. **الأبعاد والمقاييس** — جميع الحقول المتاحة في الجدول المحدد
2. **عوامل التصفية** — لتقييد البيانات التي يعيدها استعلامك
3. **المخطط** — لتصوّر نتائج استعلامك
4. **النتائج** — لعرض البيانات الأولية المعادة من قاعدة بيانات ClickHouse
5. **SQL** — لفحص استعلام SQL المُولَّد الذي تستند إليه نتائجك
من هنا، يمكنك إنشاء الاستعلامات وتعديلها بشكل تفاعلي — عبر سحب الحقول وإفلاتها، وإضافة عوامل التصفية، والتبديل بين أنواع التصور مثل الجداول، والمخططات الشريطية، أو السلاسل الزمنية.
للاطلاع بشكل أعمق على الاستكشافات وكيفية الاستعلام من جداولك، انظر:
[مقدمة إلى الجداول وصفحة Explore → وثائق Lightdash](https://docs.lightdash.com/get-started/exploring-data/using-explores#an-intro-to-tables-and-the-explore-page?utm_source=clickhouse\&utm_medium=partner\&utm_campaign=integration_docs)
***
### إنشاء لوحات المعلومات
بعد استكشاف بياناتك وحفظ التصورات، يمكنك جمعها في **لوحات معلومات** لمشاركتها مع فريقك.
تتميز لوحات المعلومات في Lightdash بأنها تفاعلية بالكامل — إذ يمكنك تطبيق عوامل التصفية، وإضافة علامات تبويب، وعرض مخططات تعتمد على استعلامات ClickHouse في الوقت الفعلي.
يمكنك أيضًا إنشاء مخططات جديدة **مباشرةً من داخل لوحة المعلومات**، مما يساعدك على إبقاء مشاريعك منظَّمة وخالية من الفوضى. وتكون المخططات التي تُنشأ بهذه الطريقة **مقتصرة على لوحة المعلومات تلك** — ولا يمكن إعادة استخدامها في أي مكان آخر ضمن المشروع.
لإنشاء مخطط مخصص للوحة المعلومات فقط:
1. انقر على **إضافة مربع**
2. حدِّد **مخطط جديد**
3. أنشئ تصورك في أداة إنشاء المخططات
4. احفظه — وسيظهر في أسفل لوحة المعلومات
تعرّف على المزيد حول كيفية إنشاء لوحات المعلومات وتنظيمها هنا:
[إنشاء لوحات المعلومات ← مستندات Lightdash](https://docs.lightdash.com/get-started/exploring-data/dashboards?utm_source=clickhouse\&utm_medium=partner\&utm_campaign=integration_docs)
***
### Ask AI: تحليلات ذاتية الخدمة مدعومة بـ dbt
تجعل **AI Agents** في Lightdash استكشاف البيانات ذاتي الخدمة بالفعل.
فبدلًا من كتابة الاستعلامات، يمكنك ببساطة طرح الأسئلة بلغة طبيعية — مثل *"ما نمو إيراداتنا الشهري؟"* — وسينشئ AI Agent تلقائيًا التصور المناسب، مع الاستناد إلى المقاييس والنماذج المعرّفة في dbt لضمان الدقة والاتساق.
وهي مدعومة بالطبقة الدلالية نفسها التي تستخدمها في dbt، ما يعني أن كل إجابة تظل خاضعة للحوكمة، وقابلة للتفسير، وسريعة — وكل ذلك بالاستناد إلى ClickHouse.
تعرّف على المزيد حول AI Agents هنا: [AI Agents → وثائق Lightdash](https://docs.lightdash.com/guides/ai-agents?utm_source=clickhouse\&utm_medium=partner\&utm_campaign=integration_docs)
## تعرّف على المزيد
لمعرفة المزيد حول ربط مشاريع dbt بـ Lightdash، يُرجى زيارة [وثائق Lightdash → إعداد ClickHouse](https://docs.lightdash.com/get-started/setup-lightdash/connect-project#clickhouse?utm_source=clickhouse\&utm_medium=partner\&utm_campaign=integration_docs).