> ## 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.
> مقدمة لاستخدام ClickHouse مع Grafana
# المكوّن الإضافي لمصدر بيانات ClickHouse لـ Grafana
export const ClickHouseSupportedBadge = () => {
return ;
};
export const Image = ({img, alt, size = "lg"}) => {
const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
return
;
};
باستخدام Grafana، يمكنك استكشاف جميع بياناتك ومشاركتها عبر لوحات المعلومات.
يتطلب Grafana مكوّنًا إضافيًا للاتصال بـ ClickHouse، ويمكن تثبيته بسهولة من داخل واجهته.
للاتصال بـ 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 لديك تفاصيل الاتصال.
عند توصيل ClickHouse بأداة لتصور البيانات مثل Grafana، يُوصى بإنشاء مستخدم للقراءة فقط لحماية بياناتك من التعديلات غير المرغوب فيها.
لا يتحقق Grafana من أن الاستعلامات آمنة. إذ يمكن أن تتضمن الاستعلامات أي عبارة SQL، بما في ذلك `DELETE` و`INSERT`.
لتهيئة مستخدم للقراءة فقط، اتبع الخطوات التالية:
1. أنشئ ملف تعريف المستخدم `readonly` باتباع دليل [Creating Users and Roles in ClickHouse](/docs/ar/concepts/features/security/access-rights).
2. تأكد من أن المستخدم `readonly` لديه أذونات كافية لتعديل الإعداد `max_execution_time` الذي يتطلبه [clickhouse-go client](https://github.com/ClickHouse/clickhouse-go) الأساسي.
3. إذا كنت تستخدم ClickHouse instance عامًا، فلا يُنصح بتعيين `readonly=2` في ملف تعريف `readonly`. بدلًا من ذلك، اترك `readonly=1` وعيّن نوع القيد لـ `max_execution_time` إلى [changeable\_in\_readonly](/docs/ar/concepts/features/configuration/settings/constraints-on-settings) للسماح بتعديل هذا الإعداد.
قبل أن يتمكن Grafana من الاتصال بـ ClickHouse، تحتاج إلى تثبيت مكوّن Grafana الإضافي المناسب. بافتراض أنك سجلت الدخول إلى Grafana، اتبع الخطوات التالية:
1. من صفحة **Connections** في الشريط الجانبي، حدّد علامة التبويب **Add new connection**.
2. ابحث عن **ClickHouse** وانقر على المكوّن الإضافي الموقّع من Grafana Labs:
3. في الشاشة التالية، انقر على زر **Install**:
1. بعد اكتمال التثبيت، انقر على زر **إضافة مصدر بيانات جديد**. (يمكنك أيضًا إضافة مصدر بيانات من علامة التبويب **مصادر البيانات** في صفحة **Connections**.)
2. مرّر إلى أسفل وابحث عن نوع مصدر البيانات **ClickHouse**، أو ابحث عنه في شريط البحث في صفحة **إضافة مصدر بيانات**. حدّد مصدر بيانات **ClickHouse**، وستظهر الصفحة التالية:
3. أدخل إعدادات الخادم وبيانات الاعتماد. والإعدادات الأساسية هي:
* **عنوان مضيف الخادم:** اسم المضيف لخدمة ClickHouse لديك.
* **منفذ الخادم:** المنفذ الخاص بخدمة ClickHouse لديك. ويختلف حسب إعدادات الخادم والبروتوكول.
* **البروتوكول:** البروتوكول المستخدم للاتصال بخدمة ClickHouse لديك.
* **اتصال آمن:** فعِّله إذا كان خادمك يتطلب اتصالًا آمنًا.
* **اسم المستخدم** و**كلمة المرور**: أدخل بيانات اعتماد مستخدم ClickHouse لديك. إذا لم تكن قد أعددت أي مستخدمين، فجرّب `default` كاسم مستخدم. ويُوصى [بإعداد مستخدم بصلاحية القراءة فقط](#2-making-a-read-only-user).
للاطلاع على المزيد من الإعدادات، راجع وثائق [تهيئة المكوّن الإضافي](/docs/ar/integrations/connectors/data-visualization/grafana/config).
4. انقر على زر **Save & test** للتحقق من أن Grafana يمكنه الاتصال بخدمة ClickHouse لديك. وإذا نجحت العملية، فسترى الرسالة **Data source is working**:
أصبح مصدر البيانات جاهزًا الآن للاستخدام! تعرّف على المزيد حول كيفية إنشاء الاستعلامات باستخدام [query builder](/docs/ar/integrations/connectors/data-visualization/grafana/query-builder).
للمزيد من التفاصيل حول التهيئة، راجع وثائق [تهيئة المكوّن الإضافي](/docs/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).
لا يمكن للمكوّن الإضافي الرجوع إلى إصدارات سابقة إذا كان الإعداد/الاستعلام قد أُنشئ باستخدام إصدار أحدث.
