📈 تثبيت Lightdash — ذكاء أعمال مبني على نماذج dbt الخاصة بك

انشر Lightdash على أوبنتو باستخدام Docker — أداة BI مفتوحة المصدر تحوّل نماذج dbt لديك إلى رسوم بيانية ولوحات معلومات قابلة للاستكشاف، ليتمكن فريقك بالكامل من تحليلات ذاتية الخدمة، على المنفذ 8232.

⚠️ راجع أي سكريبت دائمًا قبل تشغيله على سيرفرك، واختبره في بيئة تجريبية أولاً.

📦 الملفات والأكواد المطلوبة

قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.

سكريبت تثبيت آلي — ينشر Lightdash مع PostgreSQL الخاصة به على المنفذ 8232. سجّل أول مستخدم، اربط مشروع dbt الخاص بك، وابدأ ببناء الرسوم البيانية من مقاييسك.
عرض على GitHub

التثبيت السريع:

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/analytics/lightdash/lightdash-ubuntu.sh
chmod +x lightdash-ubuntu.sh
sudo bash lightdash-ubuntu.sh

خطوات التنفيذ

1 تحميل السكريبت

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/analytics/lightdash/lightdash-ubuntu.sh

2 منحه صلاحية التنفيذ

chmod +x lightdash-ubuntu.sh

3 تشغيل المثبت

يثبّت السكريبت Docker إن لزم ويُشغّل Lightdash مع قاعدة بيانات PostgreSQL الخاصة به (لبيانات التطبيق الوصفية) على المنفذ 8232. يولّد سراً وكلمة مرور لقاعدة البيانات؛ أول مستخدم يسجّل يصبح المشرف، ثم يربط مشروع dbt.

sudo bash lightdash-ubuntu.sh

4 فتح واجهة الويب وربط dbt

افتح Lightdash، سجّل أول مستخدم، ثم اربط مشروع dbt الخاص بك حتى يتمكن Lightdash من تحويل نماذجه ومقاييسه إلى رسوم بيانية قابلة للاستكشاف:

http://<your-server-ip>:8232

المنافذ المستخدمة

المنفذالغرض
8232Web UI (host → container 8080)
first userThe first user to register becomes the admin
dbt + warehouseConnect your dbt project and data warehouse; PostgreSQL for metadata

نظرة عامة

Lightdash أداة ذكاء أعمال مفتوحة المصدر مبنية مباشرة فوق dbt (أداة بناء البيانات). بدلاً من إعادة تعريف المقاييس داخل طبقة BI منفصلة، يقرأ Lightdash النماذج وتعريفات المقاييس التي يكتبها فريق البيانات لديك بالفعل كأكواد dbt، ويحوّلها إلى واجهة قابلة للاستكشاف من الرسوم البيانية والجداول ولوحات المعلومات يمكن لأي شخص في الفريق استخدامها دون كتابة SQL. ولأن المقاييس تعيش كأكواد خاضعة للتحكم بالإصدارات في dbt، يبقى كل رسم بياني ولوحة معلومات في Lightdash متسقاً مع مصدر حقيقة واحد.

لماذا تستخدمه

يحل Lightdash مشكلة انحراف المقاييس الشائعة في BI، حيث يُعرَّف نفس الرقم (مثل "الإيرادات" أو "المستخدمون النشطون") بشكل مختلف قليلاً في كل لوحة معلومات وجدول بيانات وتقرير. بربط تعريفات المقاييس مباشرة في dbt — نفس الأداة التي يستخدمها مهندسو التحليلات لديك بالفعل لتحويل البيانات — يضمن Lightdash أن كل رسم بياني يسحب من نفس التعريف الخاضع للحوكمة والمتحكم بإصداره. الفرق التي تستثمر بالفعل في dbt لنمذجة بياناتها تحصل على طبقة تحليلات ذاتية الخدمة دون تكرار المنطق في أداة BI ثانية منفصلة.

متى تحتاجه

  • فريق البيانات لديك يُنمذج البيانات بالفعل في dbt وتريد طبقة BI تعيد استخدام تلك التعريفات بدلاً من إعادة تعريف المقاييس من الصفر
  • واجهت انحراف مقاييس، حيث يُظهر نفس المؤشر أرقاماً مختلفة عبر لوحات معلومات أو فرق مختلفة
  • تريد أن يحصل مستخدمو الأعمال على إجابات ذاتية الخدمة من مقاييس خاضعة للحوكمة دون الحاجة لكتابة SQL بأنفسهم
  • تحتاج أن تعيش لوحات المعلومات وتعريفات المقاييس تحت التحكم بالإصدارات إلى جانب مشروع dbt الحالي لديك
  • تريد تجنب الارتباط بمورّد وتكاليف ترخيص أدوات BI التجارية مثل Looker أو Tableau مع الحفاظ على حوكمة مقاييس قوية

من يحتاجه

  • مهندسو التحليلات وفرق البيانات الذين يصونون بالفعل مشروع dbt ويريدون طبقة BI مبنية فوقه
  • الشركات الناشئة والمتوسعة التي تريد تحليلات ذاتية الخدمة دون تكلفة منصات تجارية مثل Looker أو Tableau
  • المؤسسات المعتمدة على البيانات التي عانت من انحراف المقاييس عبر جداول البيانات ولوحات المعلومات المنفصلة
  • أصحاب المصلحة في الأعمال الذين يريدون استكشاف مقاييس خاضعة للحوكمة وبناء رسوم بيانية دون كتابة SQL
  • الفرق التي تمارس هندسة التحليلات وتريد أن تحترم أداة BI لديها نفس سير عمل مراجعة الكود والتحكم بالإصدارات الذي تتبعه نماذج dbt
  • الشركات ذات متطلبات إقامة البيانات أو الامتثال التي تفضل استضافة أداة BI ذاتياً بدلاً من منصة SaaS فقط

حالات الاستخدام الشائعة

  • تحويل نماذج dbt وتعريفات المقاييس إلى لوحات معلومات قابلة للاستكشاف دون تكرار المنطق في طبقة BI منفصلة
  • تمكين فرق الأعمال من الحصول على رسوم بيانية وتقارير ذاتية الخدمة من مجموعة مقاييس خاضعة للحوكمة دون كتابة SQL
  • توحيد كيفية حساب وعرض مؤشرات الأداء مثل الإيرادات أو التسرب أو المستخدمين النشطين عبر كل لوحة معلومات
  • منح مهندسي التحليلات أداة BI تتلاءم مع سير عمل التحكم بالإصدارات ومراجعة الكود القائم على dbt لديهم
  • استبدال جداول البيانات المتناثرة واستعلامات SQL الفردية بطبقة دلالية مشتركة وقابلة للاستكشاف
  • بناء لوحات معلومات موجهة لأصحاب المصلحة تبقى متزامنة تلقائياً كلما تغيرت نماذج dbt الأساسية

الميزات الرئيسية

  • تكامل عميق مع dbt يقرأ نماذج مشروعك وأبعاده وتعريفات مقاييسه مباشرة كطبقة دلالية
  • أداة بناء رسوم بيانية ولوحات معلومات بالسحب والإفلات تتيح للمستخدمين غير التقنيين استكشاف مقاييس خاضعة للحوكمة دون SQL
  • المقاييس كأكواد — كل تعريف مقياس يعيش في مشروع dbt الخاص بك، خاضعاً للتحكم بالإصدارات ومُراجعاً كأي تغيير كود آخر
  • تسليم لوحات معلومات مجدول وتنبيهات حتى يحصل أصحاب المصلحة على تقارير وتنبيهات حدود تلقائياً
  • دعم مستودعات البيانات الرئيسية بما فيها Snowflake وBigQuery وRedshift وDatabricks وPostgreSQL
  • إدارة مساحات وصلاحيات للتحكم في من يمكنه عرض أو تعديل أو إدارة لوحات معلومات ومحتوى محدد
  • نواة ذاتية الاستضافة ومفتوحة المصدر (برخصة MIT) يمكن تشغيلها بالكامل على بنيتك التحتية الخاصة بـ Docker
  • مشغّل SQL ووضع استكشاف للمستخدمين التقنيين الذين ما زالوا يريدون كتابة استعلامات مخصصة على المستودع المتصل

كيفية الاستخدام بعد التثبيت

  • افتح واجهة الويب على http://your-server-ip:8232 وسجّل أول مستخدم — يصبح هذا الحساب مشرف مساحة العمل
  • اربط مشروع dbt الخاص بك بتوجيه Lightdash إلى مستودع dbt لديك (GitHub أو GitLab أو مشروع dbt Core محلي)
  • اربط مستودع بياناتك (Snowflake أو BigQuery أو Redshift أو Databricks أو PostgreSQL) باستخدام بيانات الاعتماد التي يستخدمها مشروع dbt لديك بالفعل
  • شغّل عملية compile/refresh لـ dbt داخل Lightdash حتى يلتقط نماذجك وأبعادك وتعريفات مقاييسك
  • ابنِ أول رسم بياني أو لوحة معلومات باستكشاف نموذج وسحب الحقول إلى أداة بناء الرسوم البيانية
  • ادعُ أعضاء الفريق واضبط الأدوار/الصلاحيات حتى يتمكن الأشخاص المناسبون من عرض أو تعديل لوحات معلومات محددة
  • اضبط SECURE_COOKIES على true بمجرد تقديم Lightdash عبر HTTPS خلف وكيل عكسي
  • جدول تسليم لوحات معلومات متكررة أو تنبيهات إذا احتاج أصحاب المصلحة تقارير تلقائية على جدول

أفضل ممارسات الأمان

  • اضبط SECURE_COOKIES=true بمجرد أن يصبح Lightdash خلف HTTPS — المثبت يضبطها افتراضياً على false، وهذا آمن فقط للاختبار المحلي
  • ضع Lightdash خلف وكيل عكسي مع إنهاء TLS لأنه يحمل بيانات اعتماد مستودع بياناتك
  • لا تكشف المنفذ 8232 مباشرة للإنترنت دون HTTPS أبداً — ستنتقل بيانات اعتماد المستودع ونتائج الاستعلامات دون تشفير
  • استخدم صلاحيات قائمة على الأدوار لتقييد المستخدمين والمساحات التي يمكنها عرض أو تعديل لوحات المعلومات الحساسة واتصالات البيانات الأساسية
  • دوّر بيانات اعتماد مستودع البيانات التي يستخدمها Lightdash وحدد نطاقها بأقل صلاحيات وصول لازمة للمخططات المتصلة
  • حافظ على تحديث صورة Lightdash Docker وقاعدة بيانات PostgreSQL الوصفية الخاصة بها بأحدث تصحيحات الأمان
  • انسخ احتياطياً السر المُنشأ للتطبيق بأمان، لأنه يُستخدم لتشفير بيانات الاعتماد والجلسات المخزنة

المنافذ وإعدادات جدار الحماية

يستمع Lightdash على المنفذ 8232 على المضيف، والذي يُحوَّل إلى المنفذ الداخلي 8080 للحاوية. ولأن Lightdash يخزن ويستخدم بيانات اعتماد للاتصال بمستودع بياناتك، يجب ألا يُكشف هذا المنفذ مباشرة للإنترنت العام أبداً دون HTTPS. ضعه خلف وكيل عكسي مثل Nginx Proxy Manager أو Caddy لإنهاء TLS، وفعّل متغير البيئة SECURE_COOKIES بمجرد توفر HTTPS — يضبطه المثبت على false افتراضياً للاختبار المحلي. يجب أن تقيّد قواعد الجدار الناري الوصول الوارد إلى المنفذ 8232 على وكيلك العكسي أو شبكة داخلية موثوقة، ويجب أن يتبع الوصول الصادر من مضيف Lightdash إلى مستودع بياناتك توصيات أمان الشبكة الخاصة بمزود المستودع نفسه.

النسخ الاحتياطي والصيانة

  • انسخ احتياطياً قاعدة بيانات Lightdash PostgreSQL التي تخزّن لوحات المعلومات والرسوم البيانية والمساحات وحسابات المستخدمين وبيانات التطبيق الوصفية
  • انسخ احتياطياً السر المُنشأ للتطبيق وبيانات اعتماد قاعدة البيانات التي أُنشئت أثناء التثبيت حتى يمكن استعادتها على مضيف جديد
  • مشروع dbt نفسه يجب أن يكون خاضعاً للتحكم بالإصدارات في Git بالفعل — يقرأ Lightdash منه لكنه لا يحتاج نسخة احتياطية منفصلة للنماذج
  • وثّق إعدادات اتصال مستودع بياناتك حتى يمكن إعادة ضبطها إذا احتاج Lightdash إعادة نشر
  • انسخ احتياطياً ملف docker-compose.yml أو أمر التشغيل حتى يمكن إعادة إنشاء الحزمة بشكل مطابق
  • اختبر استعادة كاملة دورياً على نسخة منفصلة للتأكد من عودة لوحات المعلومات والمستخدمين والصلاحيات سليمة

الأخطاء الشائعة

  • ترك SECURE_COOKIES على false بعد نقل Lightdash خلف HTTPS، ما يُضعف أمان الجلسات
  • كشف المنفذ 8232 مباشرة للإنترنت دون وكيل عكسي وTLS، مع أن Lightdash يحمل بيانات اعتماد المستودع
  • محاولة استخدام Lightdash بدون مشروع dbt موجود، دون إدراك أن dbt متطلب أساسي وليس اختيارياً
  • منح اتصال Lightdash بالمستودع صلاحيات أوسع من اللازم بدلاً من تحديد نطاقها بالمخططات المطلوبة
  • عدم تشغيل تحديث dbt بعد تغييرات النماذج، ما يؤدي لمقاييس أو لوحات معلومات قديمة لا تعكس أحدث منطق
  • نسيان النسخ الاحتياطي للسر المُنشأ للتطبيق، ما قد يُعقّد استعادة بيانات الاعتماد المشفرة بعد الترحيل
  • افتراض أن Lightdash يعمل مثل أداة BI قائمة على قاعدة البيانات مثل Metabase، ثم مفاجأة أنه يتطلب نمذجة dbt أولاً

استكشاف الأخطاء وإصلاحها

  • لا يمكن الاتصال بمستودع البيانات — تحقق أن بيانات الاعتماد تطابق ما يستخدمه مشروع dbt وأن الوصول الشبكي من مضيف Lightdash للمستودع مسموح
  • النماذج أو المقاييس لا تظهر — تأكد من تشغيل compile/refresh لـ dbt داخل Lightdash بعد أحدث التغييرات على مشروع dbt
  • واجهة الويب غير قابلة للوصول — تحقق أن حاويتي Lightdash وPostgreSQL تعملان باستخدام docker ps وأن المنفذ 8232 غير محظور بجدار ناري
  • مشكلات تسجيل دخول أو جلسة بعد تفعيل HTTPS — تحقق أن SECURE_COOKIES مضبوط بشكل صحيح حسب ما إذا كانت الحركة تُقدَّم عبر TLS
  • الرسوم البيانية تُظهر أرقاماً غير متوقعة — راجع تعريف المقياس الأساسي في dbt بدلاً من إعدادات الرسم البياني، لأن المقاييس محكومة على مستوى طبقة dbt
  • بطء تحميل لوحة المعلومات — راجع أداء الاستعلامات على مستودع البيانات الأساسي، لأن Lightdash ينفّذ الاستعلامات مباشرة عليه بدلاً من التخزين المؤقت الكثيف افتراضياً
  • تسجيل أول مستخدم لا يظهر كمشرف — تأكد أن لا مستخدم آخر سجّل بالفعل في تثبيت جديد، لأن أول حساب مُسجَّل فقط يصبح مشرف مساحة العمل

البدائل

Metabase قائم على قاعدة البيانات أولاً وأسهل بكثير للفرق التي ليس لديها إعداد dbt ناضج — وجّهه مباشرة لقاعدة بيانات وابدأ البناء دون الحاجة لتعريفات نماذج في الكود، رغم أنه يفتقر لحوكمة المقاييس المبنية على dbt التي يوفرها Lightdash. Apache Superset أداة BI مفتوحة المصدر قوية ومرنة بخيارات تصور واسعة لكن بمنحنى تعلّم أصعب وبدون تكامل طبقة دلالية أصلي مع dbt. Redash خيار مفتوح المصدر أخف للوحات معلومات سريعة قائمة على SQL لكنه شهد تطويراً أقل نشاطاً في السنوات الأخيرة. Looker كان رائداً في نهج طبقة المقاييس القائمة على الكود (LookML) التي يُردد Lightdash صداها بـ dbt، لكنه منتج تجاري باهظ الثمن بصيغة مقاييس خاصة بدلاً من dbt المفتوح. لفريق لديه بالفعل مقاييس مُعرَّفة في dbt ويريد أن يشغّل ذلك الاستثمار تحليلات ذاتية الخدمة دون إعادة تعريف المنطق في مكان آخر، يُعد Lightdash الخيار الأنسب طبيعياً.

متى لا تستخدمه

Lightdash ليس الخيار الصحيح إذا كان فريقك لا يستخدم dbt بالفعل لنمذجة البيانات — فهو يتطلب مشروع dbt موجوداً بنماذج ومقاييس معرّفة كأساس له، لذا لا يوجد مسار سريع لتشغيل رسوم بيانية مقابل قاعدة بيانات خام. إذا كنت تحتاج أقصى مرونة لمستخدمين غير تقنيين لاستكشاف قواعد بيانات عشوائية دون أي عمل نمذجة مسبق، فإن أداة قائمة على قاعدة البيانات مثل Metabase ستجعلك تعمل بشكل أسرع. الفرق الصغيرة جداً أو إعدادات المحلل الواحد قد تجد بنية dbt-زائد-طبقة-BI عبئاً أكبر مما تحتاجه مقارنة بأداة لوحة معلومات SQL خفيفة. وإذا كانت مؤسستك تحتاج الصقل والدعم المؤسسي والنظام البيئي الناضج لمنصة تجارية مثل Looker أو Tableau ولديها ميزانية لذلك، فقد تظل تلك الأدوات تقدّم تجربة أكثر سلاسة رغم التكلفة.

هل تحتاج مساعدة احترافية؟

توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.

  • التثبيت وتجهيز السيرفر
  • الإعداد المتقدم وإعداد التوجيه
  • تصليب الأمان وتحسين جدار الحماية
  • إعداد شهادات SSL/TLS مع Let's Encrypt
  • ربط النطاق المخصص والوكيل العكسي
  • جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
  • المراقبة الفورية وتنبيهات الجاهزية
  • الترحيل من المنصات القائمة
  • استكشاف مشكلات الاتصال والأداء وإصلاحها
  • سكريبتات أتمتة مخصصة وعقود دعم مستمر
تواصل مع PrismaTechWork

الأسئلة الشائعة

ما هو Lightdash؟

Lightdash أداة ذكاء أعمال مفتوحة المصدر مبنية حول dbt. يقرأ النماذج والمقاييس التي يعرّفها فريق البيانات لديك في dbt ويحوّلها إلى طبقة تحليلات ذاتية الخدمة — رسوم بيانية وجداول ولوحات معلومات يمكن لأي شخص استكشافها دون كتابة SQL، محكومة بالمقاييس المُعرَّفة في dbt.

ما المنفذ الذي يستخدمه؟

يعمل Lightdash على المنفذ 8232 على المضيف، المُحوَّل من المنفذ الداخلي 8080 للحاوية. تصفّح هناك للوصول إليه. ولأنه يتصل بمستودع بياناتك ويحمل بيانات اعتماده، قدّمه عبر TLS من خلال وكيل عكسي، فعّل SECURE_COOKIES بمجرد أن يصبح خلف HTTPS (يضبطه المثبت على false افتراضياً)، وأبقِ المنفذ محمياً بجدار ناري من الوصول العام المباشر.

هل أحتاج dbt لاستخدامه؟

نعم — بُني Lightdash خصيصاً حول dbt ويقرأ نماذج وتعريفات مقاييس مشروع dbt الخاص بك. هذا التكامل الوثيق هو صلب الفكرة: تُعرَّف مقاييسك مرة واحدة كأكواد في dbt وتظهر بشكل متسق في Lightdash.

ماذا يعني "المقاييس كأكواد"؟

يعني أن تعريفات مقاييسك — ما الذي يحسبه "الإيرادات" أو "المستخدمون النشطون" فعلياً — تعيش كأكواد في مشروع dbt الخاص بك بدلاً من إعادة تعريفها داخل كل لوحة معلومات. يُظهر Lightdash هذه التعريفات بالضبط، حتى يستخدم الجميع نفس المقاييس المتفق عليها ولا يمكن للوحات المعلومات أن تنحرف عن بعضها.

كيف يُقارَن بـ Metabase؟

Metabase قائم على قاعدة البيانات أولاً وسهل جداً — وجّهه لقاعدة بيانات وابنِ دون dbt، مثالي عندما تريد مرونة للمستخدمين غير التقنيين. Lightdash قائم على dbt أولاً، يربط المقاييس بالكود من أجل الاتساق والحوكمة.