> ## 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.
> مقدمة لاستخدام ClickHouse مع Grafana
# المكوّن الإضافي لمصدر بيانات ClickHouse لـ Grafana
export const ClickHouseSupportedBadge = () => {
return ;
};
export const Image = ({img, alt, size}) => {
return
;
};
باستخدام Grafana، يمكنك استكشاف جميع بياناتك ومشاركتها عبر لوحات المعلومات.
يتطلب Grafana مكوّنًا إضافيًا للاتصال بـ ClickHouse، ويمكن تثبيته بسهولة من داخل واجهته.
## 1. جهّز تفاصيل الاتصال الخاصة بك
للاتصال بـ ClickHouse باستخدام native TCP، ستحتاج إلى المعلومات التالية:
| المعلمات | الوصف |
| ------------------------- | ------------------------------------------------------------------------------------------------ |
| `HOST` and `PORT` | يكون المنفذ عادةً 9440 عند استخدام TLS، أو 9000 عند عدم استخدام TLS. |
| `DATABASE NAME` | توجد افتراضيًا قاعدة بيانات باسم `default`؛ استخدم اسم قاعدة البيانات التي تريد الاتصال بها. |
| `USERNAME` and `PASSWORD` | يكون اسم المستخدم افتراضيًا هو `default`. استخدم اسم المستخدم المناسب لحالة الاستخدام الخاصة بك. |
تتوفر تفاصيل خدمة ClickHouse Cloud الخاصة بك في ClickHouse Cloud console.
حدّد الخدمة التي ستتصل بها، ثم انقر على **Connect**:
اختر **Native**، وستتوفر التفاصيل ضمن مثال لأمر `clickhouse-client`.
إذا كنت تستخدم ClickHouse مُدارًا ذاتيًا، فسيحدّد مسؤول ClickHouse لديك تفاصيل الاتصال.
## 2. إنشاء مستخدم بصلاحية القراءة فقط
عند توصيل ClickHouse بأداة لتصوّر البيانات مثل Grafana، يُنصح بإنشاء مستخدم بصلاحية القراءة فقط لحماية بياناتك من التعديلات غير المرغوب فيها.
لا يتحقق Grafana من أمان الاستعلامات. فقد تتضمن الاستعلامات أي تعليمة SQL، بما في ذلك `DELETE` و`INSERT`.
لتهيئة مستخدم بصلاحية القراءة فقط، اتبع الخطوات التالية:
1. أنشئ ملف تعريف للمستخدم `readonly` باتباع دليل [إنشاء المستخدمين والأدوار في ClickHouse](/ar/concepts/features/security/access-rights).
2. تأكد من أن المستخدم `readonly` لديه الصلاحية الكافية لتعديل الإعداد `max_execution_time` الذي يتطلبه [clickhouse-go client](https://github.com/ClickHouse/clickhouse-go).
3. إذا كنت تستخدم مثيل ClickHouse عامًا، فلا يُنصح بتعيين `readonly=2` في ملف التعريف `readonly`. وبدلًا من ذلك، اترك `readonly=1` وعيّن نوع القيد للإعداد `max_execution_time` إلى [changeable\_in\_readonly](/ar/concepts/features/configuration/settings/constraints-on-settings) للسماح بتعديل هذا الإعداد.
## 3. ثبّت مكوّن إضافي ClickHouse لـ Grafana
قبل أن يتمكن Grafana من الاتصال بـ ClickHouse، تحتاج إلى تثبيت مكوّن إضافي Grafana المناسبة. إذا كنت قد سجّلت الدخول إلى Grafana بالفعل، فاتبع الخطوات التالية:
1. من صفحة **Connections** في الشريط الجانبي، اختر علامة التبويب **Add new connection**.
2. ابحث عن **ClickHouse** وانقر على المكوّن الإضافي الموقَّعة من Grafana Labs:
3. في الشاشة التالية، انقر على الزر **Install**:
## 4. تحديد مصدر بيانات ClickHouse
1. بعد اكتمال التثبيت، انقر على زر **إضافة مصدر بيانات جديد**. (يمكنك أيضًا إضافة مصدر بيانات من علامة التبويب **مصادر البيانات** في صفحة **Connections**.)
2. مرّر إلى أسفل وابحث عن نوع مصدر البيانات **ClickHouse**، أو ابحث عنه في شريط البحث في صفحة **إضافة مصدر بيانات**. حدّد مصدر بيانات **ClickHouse**، وستظهر الصفحة التالية:
3. أدخل إعدادات الخادم وبيانات الاعتماد. والإعدادات الأساسية هي:
* **عنوان مضيف الخادم:** اسم المضيف لخدمة ClickHouse لديك.
* **منفذ الخادم:** المنفذ الخاص بخدمة ClickHouse لديك. ويختلف حسب إعدادات الخادم والبروتوكول.
* **البروتوكول:** البروتوكول المستخدم للاتصال بخدمة ClickHouse لديك.
* **اتصال آمن:** فعِّله إذا كان خادمك يتطلب اتصالًا آمنًا.
* **اسم المستخدم** و**كلمة المرور**: أدخل بيانات اعتماد مستخدم ClickHouse لديك. إذا لم تكن قد أعددت أي مستخدمين، فجرّب `default` كاسم مستخدم. ويُوصى [بإعداد مستخدم بصلاحية القراءة فقط](#2-making-a-read-only-user).
للاطلاع على المزيد من الإعدادات، راجع وثائق [تهيئة المكوّن الإضافي](/ar/integrations/connectors/data-visualization/grafana/config).
4. انقر على زر **Save & test** للتحقق من أن Grafana يمكنه الاتصال بخدمة ClickHouse لديك. وإذا نجحت العملية، فسترى الرسالة **Data source is working**:
## 5. الخطوات التالية
أصبح مصدر البيانات لديك جاهزًا الآن للاستخدام! تعرّف على المزيد حول كيفية إنشاء الاستعلامات باستخدام [منشئ الاستعلامات](/ar/integrations/connectors/data-visualization/grafana/query-builder).
لمزيد من التفاصيل حول التهيئة، راجع وثائق [تهيئة المكوّن الإضافي](/ar/integrations/connectors/data-visualization/grafana/config).
إذا كنت تبحث عن مزيد من المعلومات غير الواردة في هذه الوثائق، فراجع [مستودع المكوّن الإضافي على GitHub](https://github.com/grafana/clickhouse-datasource).
## ترقية إصدارات المكوّن الإضافي
بدءًا من الإصدار v4، يمكن ترقية الإعدادات والاستعلامات مع صدور إصدارات جديدة.
تُنقَل الإعدادات والاستعلامات من v3 إلى v4 عند فتحها. ومع أن الإعدادات القديمة ولوحات المعلومات ستُحمَّل في v4، فلن يُحفَظ هذا الترحيل نهائيًا حتى تُحفَظ مرة أخرى في الإصدار الجديد. إذا لاحظت أي مشكلات عند فتح إعداد/استعلام قديم، فتجاهل تغييراتك و[أبلغ عن المشكلة على GitHub](https://github.com/grafana/clickhouse-datasource/issues).
لا يمكن للمكوّن الإضافي الرجوع إلى إصدارات سابقة إذا كان الإعداد/الاستعلام قد أُنشئ باستخدام إصدار أحدث.