> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-postgresql-tls-support.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

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

# ربط Databrain بـ ClickHouse

export const CommunityMaintainedBadge = () => {
  return <div className="CommunityMaintainedBadge">
            <div className="CommunityMaintainedIcon">
            <svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" fill="currentColor" viewBox="0 0 256 256">
                <path d="M244.8,150.4a8,8,0,0,1-11.2-1.6A51.6,51.6,0,0,0,192,128a8,8,0,0,1-7.37-4.89,8,8,0,0,1,0-6.22A8,8,0,0,1,192,112a24,24,0,1,0-23.24-30,8,8,0,1,1-15.5-4A40,40,0,1,1,219,117.51a67.94,67.94,0,0,1,27.43,21.68A8,8,0,0,1,244.8,150.4ZM190.92,212a8,8,0,1,1-13.84,8,57,57,0,0,0-98.16,0,8,8,0,1,1-13.84-8,72.06,72.06,0,0,1,33.74-29.92,48,48,0,1,1,58.36,0A72.06,72.06,0,0,1,190.92,212ZM128,176a32,32,0,1,0-32-32A32,32,0,0,0,128,176ZM72,120a8,8,0,0,0-8-8A24,24,0,1,1,87.24,82a8,8,0,1,0,15.5-4A40,40,0,1,0,37,117.51,67.94,67.94,0,0,0,9.6,139.19a8,8,0,1,0,12.8,9.61A51.6,51.6,0,0,1,64,128,8,8,0,0,0,72,120Z"></path>
            </svg>
        </div>
            تتم صيانته من قِبل المجتمع
        </div>;
};

export const Image = ({img, alt, size = "lg"}) => {
  const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
  return <div className={`ch-image-${normalizedSize}`}>
      <Frame>
        <img src={img} alt={alt} />
      </Frame>
    </div>;
};

[Databrain](https://usedatabrain.com) هي منصة تحليلات مضمّنة تتيح لك إنشاء لوحات معلومات تفاعلية ومقاييس وتصورات للبيانات ومشاركتها مع عملائك. يتصل Databrain بـ ClickHouse عبر واجهة HTTPS، مما يسهّل تصور بياناتك في ClickHouse وتحليلها من خلال واجهة حديثة وسهلة الاستخدام.

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-postgresql-tls-support/jCcMIFRXeNsMw8EN/images/integrations/data-visualization/databrain_01.webp?fit=max&auto=format&n=jCcMIFRXeNsMw8EN&q=85&s=5438e3122939505cdfc9cf479cd53c33" alt="واجهة لوحة معلومات Databrain تعرض تصورًا لبيانات ClickHouse" border width="3408" height="1820" data-path="images/integrations/data-visualization/databrain_01.webp" />

<br />

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

<div id="pre-requisites">
  ## المتطلبات الأساسية
</div>

* قاعدة بيانات ClickHouse مستضافة إما على بنيتك التحتية الخاصة أو على [ClickHouse Cloud](https://clickhouse.com/).
* [حساب Databrain](https://app.usedatabrain.com/users/sign-up).
* مساحة عمل في Databrain لربط مصدر البيانات.

<div id="steps-to-connect-databrain-to-clickhouse">
  ## خطوات ربط Databrain بـ ClickHouse
</div>

<div id="1-gather-your-connection-details">
  ### 1. جهّز تفاصيل الاتصال الخاصة بك
</div>

للاتصال بـ ClickHouse باستخدام HTTP(S)، تحتاج إلى المعلومات التالية:

| المعلمات                  | الوصف                                                                                         |
| ------------------------- | --------------------------------------------------------------------------------------------- |
| `HOST` and `PORT`         | عادةً ما يكون المنفذ 8443 عند استخدام TLS، أو 8123 عند عدم استخدام TLS.                       |
| `DATABASE NAME`           | افتراضيًا، توجد قاعدة بيانات باسم `default`. استخدم اسم قاعدة البيانات التي تريد الاتصال بها. |
| `USERNAME` and `PASSWORD` | افتراضيًا، يكون اسم المستخدم `default`. استخدم اسم المستخدم المناسب لحالة الاستخدام لديك.     |

تتوفر تفاصيل خدمة ClickHouse Cloud الخاصة بك في ClickHouse Cloud console.
حدِّد خدمة ثم انقر على **Connect**:

<Image img="https://mintcdn.com/private-7c7dfe99-postgresql-tls-support/cTIaEq6k6KYDgBI1/images/_snippets/cloud-connect-button.webp?fit=max&auto=format&n=cTIaEq6k6KYDgBI1&q=85&s=dd441fc2272e292760011d48e81d43d4" size="md" alt="زر Connect لخدمة ClickHouse Cloud" border width="998" height="932" data-path="images/_snippets/cloud-connect-button.webp" />

اختر **HTTPS**. ستظهر تفاصيل الاتصال في مثال لأمر `curl`.

<Image img="https://mintcdn.com/private-7c7dfe99-postgresql-tls-support/cTIaEq6k6KYDgBI1/images/_snippets/connection-details-https.webp?fit=max&auto=format&n=cTIaEq6k6KYDgBI1&q=85&s=878b1fe94ea520377426f69503e38994" size="md" alt="تفاصيل اتصال HTTPS لخدمة ClickHouse Cloud" border width="1320" height="1184" data-path="images/_snippets/connection-details-https.webp" />

إذا كنت تستخدم ClickHouse مُدارًا ذاتيًا، فسيُحدِّد مسؤول ClickHouse لديك تفاصيل الاتصال.

<div id="2-allow-databrain-ip-addresses">
  ### 2. السماح بعناوين IP الخاصة بـ Databrain (عند الحاجة)
</div>

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

لمستخدمي ClickHouse Cloud:

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

<Tip>
  راجع [وثائق Databrain الخاصة بإضافة عناوين IP إلى قائمة السماح](https://docs.usedatabrain.com/guides/datasources/allow-access-to-our-ip) للاطلاع على القائمة الحالية لعناوين IP التي يجب إدراجها في قائمة السماح.
</Tip>

<div id="3-add-clickhouse-as-a-data-source">
  ### 3. أضف ClickHouse كمصدر بيانات في Databrain
</div>

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

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

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-postgresql-tls-support/jCcMIFRXeNsMw8EN/images/integrations/data-visualization/databrain_02.webp?fit=max&auto=format&n=jCcMIFRXeNsMw8EN&q=85&s=1346b0d2a76b8a137be5d1c32b1628b8" alt="قائمة مصادر البيانات في Databrain" border width="3420" height="1830" data-path="images/integrations/data-visualization/databrain_02.webp" />

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

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

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-postgresql-tls-support/jCcMIFRXeNsMw8EN/images/integrations/data-visualization/databrain_03.webp?fit=max&auto=format&n=jCcMIFRXeNsMw8EN&q=85&s=60ac0d5c984da73f4125ab35e74f9b8e" alt="اختيار الموصل في Databrain مع ظهور خيار ClickHouse" border width="1920" height="917" data-path="images/integrations/data-visualization/databrain_03.webp" />

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

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-postgresql-tls-support/jCcMIFRXeNsMw8EN/images/integrations/data-visualization/databrain_04.webp?fit=max&auto=format&n=jCcMIFRXeNsMw8EN&q=85&s=6bd38fab5bbe9764d8bb2688f97e3939" alt="نموذج اتصال ClickHouse في Databrain مع حقول الإعداد" border width="1917" height="914" data-path="images/integrations/data-visualization/databrain_04.webp" />

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

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

<div id="4-configure-user-permissions">
  ### 4. إعداد أذونات المستخدم
</div>

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

```sql theme={null}
-- 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` باسم المستخدم واسم قاعدة البيانات الفعليَّين لديك.

<div id="using-databrain-with-clickhouse">
  ## استخدام Databrain مع ClickHouse
</div>

<div id="explore-your-data">
  ### استكشف بياناتك
</div>

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

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

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-postgresql-tls-support/jCcMIFRXeNsMw8EN/images/integrations/data-visualization/databrain_05.webp?fit=max&auto=format&n=jCcMIFRXeNsMw8EN&q=85&s=c0c96f278760b49a42aa6aec1c77848c" alt="مستكشف البيانات في Databrain يعرض جداول ClickHouse" border width="1919" height="920" data-path="images/integrations/data-visualization/databrain_05.webp" />

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

<div id="create-metrics-and-visualizations">
  ### إنشاء المقاييس والتصورات
</div>

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

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

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

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

<div id="build-dashboards">
  ### إنشاء لوحات المعلومات
</div>

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

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

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

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-postgresql-tls-support/jCcMIFRXeNsMw8EN/images/integrations/data-visualization/databrain_06.webp?fit=max&auto=format&n=jCcMIFRXeNsMw8EN&q=85&s=ae30fd5ce87f353c8cf773a6803b3684" alt="لوحة معلومات Databrain تضم عدة تصورات من ClickHouse" border width="1918" height="888" data-path="images/integrations/data-visualization/databrain_06.webp" />

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

<div id="advanced-features">
  ### الميزات المتقدمة
</div>

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

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

<div id="troubleshooting">
  ## استكشاف الأخطاء وإصلاحها
</div>

<div id="connection-fails">
  ### فشل الاتصال
</div>

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

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

<div id="slow-query-performance">
  ### بطء أداء الاستعلامات
</div>

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

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

<div id="learn-more">
  ## اطّلِع على المزيد
</div>

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

* [وثائق Databrain](https://docs.usedatabrain.com/)
* [دليل ClickHouse Integration](https://docs.usedatabrain.com/guides/datasources/connecting-data-sources-to-databrain/clickhouse)
* [إنشاء لوحات المعلومات](https://docs.usedatabrain.com/guides/dashboards/create-a-dashboard)
* [إنشاء المقاييس](https://docs.usedatabrain.com/guides/metrics/create-metrics)