ربط Databrain بـ ClickHouse

Databrain هي منصة تحليلات مضمنة تتكامل بسلاسة مع ClickHouse لإنشاء لوحات معلومات ومقاييس وتصورات للبيانات موجهة للعملاء.

Databrain هي منصة تحليلات مضمّنة تتيح لك إنشاء لوحات معلومات تفاعلية ومقاييس وتصورات للبيانات ومشاركتها مع عملائك. يتصل Databrain بـ ClickHouse عبر واجهة HTTPS، مما يسهّل تصور بياناتك في ClickHouse وتحليلها من خلال واجهة حديثة وسهلة الاستخدام.

سيرشدك هذا الدليل خلال خطوات ربط Databrain بمثيل ClickHouse لديك.

​

المتطلبات الأساسية

• قاعدة بيانات ClickHouse مستضافة إما على بنيتك التحتية الخاصة أو على ClickHouse Cloud.
• حساب Databrain.
• مساحة عمل في Databrain لربط مصدر البيانات.

​

خطوات ربط Databrain بـ ClickHouse

​

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. السماح بعناوين IP الخاصة بـ Databrain (عند الحاجة)

إذا كانت تصفية IP مفعّلة على مثيل ClickHouse لديك، فستحتاج إلى إدراج عناوين IP الخاصة بـ Databrain في قائمة السماح.

لمستخدمي ClickHouse Cloud:

1. انتقل إلى خدمتك في وحدة تحكم ClickHouse Cloud
2. انتقل إلى Settings → Security
3. أضف عناوين IP الخاصة بـ Databrain إلى قائمة السماح

راجع وثائق Databrain الخاصة بإضافة عناوين IP إلى قائمة السماح للاطلاع على القائمة الحالية لعناوين IP التي يجب إدراجها في قائمة السماح.

​

3. أضف ClickHouse كمصدر بيانات في Databrain

1. سجّل الدخول إلى حسابك في Databrain، ثم انتقل إلى مساحة العمل التي تريد إضافة مصدر البيانات إليها.

2. انقر على Data Sources في قائمة التنقل.

3. انقر على Add a Data Source أو Connect Data Source.

4. حدّد ClickHouse من قائمة الموصلات المتاحة.

5. املأ تفاصيل الاتصال:
   • Destination Name: أدخل اسمًا وصفيًا لهذا الاتصال (مثل: “ClickHouse للإنتاج” أو “Analytics DB”)
   • Host: أدخل عنوان URL لمضيف ClickHouse (مثل: https://your-instance.region.aws.clickhouse.cloud)
   • Port: أدخل 8443 (منفذ HTTPS الافتراضي لـ ClickHouse)
   • Username: أدخل اسم مستخدم ClickHouse
   • Password: أدخل كلمة مرور ClickHouse

6. انقر على Test Connection للتحقق من أن Databrain يمكنه الاتصال بمثيل ClickHouse لديك.

7. بعد نجاح الاتصال، انقر على Save أو Connect لإضافة مصدر البيانات.

​

4. إعداد أذونات المستخدم

تأكد من أن مستخدم ClickHouse الذي تتصل باستخدامه لديه الأذونات اللازمة:

-- Grant permissions to read schema information
GRANT SELECT ON information_schema.* TO your_databrain_user;

-- Grant read access to your database and tables
GRANT SELECT ON your_database.* TO your_databrain_user;

استبدل your_databrain_user وyour_database باسم المستخدم واسم قاعدة البيانات الفعليَّين لديك.

​

استخدام Databrain مع ClickHouse

​

استكشف بياناتك

1. بعد الاتصال، انتقل إلى مساحة العمل الخاصة بك في Databrain.

2. سترى جداول ClickHouse مدرجة في مستكشف البيانات.

3. انقر على أحد الجداول لاستكشاف المخطط ومعاينة البيانات.

​

إنشاء المقاييس والتصورات

1. انقر على Create Metric لبدء إنشاء التصورات من بيانات ClickHouse.

2. حدِّد مصدر بيانات ClickHouse واختر الجدول الذي تريد تصوّره.

3. استخدم واجهة Databrain سهلة الاستخدام لـ:

   • تحديد الأبعاد والمقاييس
   • تطبيق عوامل التصفية وعمليات التجميع
   • اختيار أنواع التصور (مخططات شريطية، ومخططات خطية، ومخططات دائرية، وجداول، وما إلى ذلك)
   • إضافة استعلامات SQL مخصصة لإجراء تحليلات متقدمة

4. احفظ المقياس لإعادة استخدامه في لوحات المعلومات.

​

إنشاء لوحات المعلومات

1. انقر على إنشاء لوحة معلومات لبدء إنشاء لوحة معلومات جديدة.

2. أضف المقاييس إلى لوحة المعلومات الخاصة بك بسحب المقاييس المحفوظة وإفلاتها.

3. خصّص تخطيط لوحة المعلومات ومظهرها.

4. شارك لوحة المعلومات الخاصة بك مع فريقك أو ضمّنها في تطبيقك.

​

الميزات المتقدمة

توفّر Databrain عدة ميزات متقدمة عند العمل مع ClickHouse:

• SQL Console مخصّصة: اكتب استعلامات SQL مخصّصة ونفّذها مباشرةً على قاعدة بيانات ClickHouse
• البنية أحادية المستأجر ومتعددة المستأجرين: صِل قاعدة بيانات ClickHouse لديك، سواء ببنية أحادية المستأجر أو متعددة المستأجرين
• جدولة التقارير: جَدول التقارير الآلية وأرسلها عبر البريد الإلكتروني إلى المعنيين
• رؤى مدعومة بالذكاء الاصطناعي: استخدم الذكاء الاصطناعي لإنشاء ملخصات ورؤى من بياناتك
• التحليلات المضمّنة: ضمّن لوحات المعلومات والمقاييس مباشرةً في تطبيقاتك
• الطبقة الدلالية: أنشئ نماذج بيانات ومنطق أعمال قابلَين لإعادة الاستخدام

​

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

​

فشل الاتصال

إذا لم تتمكن من الاتصال بـ ClickHouse:

1. تحقق من بيانات الاعتماد: راجع اسم المستخدم وكلمة المرور وURL الخاص بالمضيف مرةً أخرى
2. تحقق من المنفذ: تأكد من أنك تستخدم المنفذ 8443 لـ HTTPS (أو 8123 لـ HTTP إذا كنت لا تستخدم SSL)
3. السماح لعناوين IP: تأكد من أن عناوين IP الخاصة بـ Databrain مُدرجة في القائمة المسموح بها ضمن إعدادات جدار الحماية/الأمان في ClickHouse
4. SSL/TLS: تأكد من تكوين SSL/TLS بشكل صحيح إذا كنت تستخدم HTTPS
5. أذونات المستخدم: تحقق من أن لدى المستخدم أذونات SELECT على information_schema وعلى قواعد البيانات المستهدفة

​

بطء أداء الاستعلامات

إذا كانت الاستعلامات تعمل ببطء:

1. حسِّن استعلاماتك: استخدم عوامل التصفية وعمليات التجميع بكفاءة
2. أنشئ عروضًا مادية: لعمليات التجميع التي يكثر الوصول إليها، فكّر في إنشاء عروض مادية في ClickHouse
3. استخدم أنواع البيانات المناسبة: تأكد من أن مخطط ClickHouse لديك يستخدم أنواع البيانات المثلى
4. تحسين الفهرسة: استفد من المفاتيح الأساسية وفهارس التخطي في ClickHouse

​

اطّلِع على المزيد

لمزيد من المعلومات حول ميزات Databrain وكيفية إنشاء تحليلات متقدمة:

• وثائق Databrain
• دليل ClickHouse Integration
• إنشاء لوحات المعلومات
• إنشاء المقاييس