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

# توصيل Chartbrew بـ ClickHouse

> صِل Chartbrew بـ ClickHouse لإنشاء لوحات معلومات لحظية وتقارير للعملاء.

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>;
};

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>;
};

[Chartbrew](https://chartbrew.com) هي منصة لتصور البيانات تتيح لك إنشاء لوحات معلومات ومراقبة البيانات في الوقت الفعلي. وهي تدعم مصادر بيانات متعددة، بما في ذلك ClickHouse، وتوفّر واجهة لا تتطلب كتابة شيفرة لإنشاء المخططات والتقارير.

<div id="goal">
  ## الهدف
</div>

في هذا الدليل، ستربط Chartbrew بـ ClickHouse، وتنفّذ استعلام SQL، وتنشئ تصورًا. وفي النهاية، قد تبدو لوحة المعلومات لديك على النحو التالي:

<Image img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/L7_COrR7NltKl_Va/images/integrations/data-visualization/chartbrew_01.webp?fit=max&auto=format&n=L7_COrR7NltKl_Va&q=85&s=42326e70ce4cdc7334d394ae53dd943a" size="lg" alt="لوحة معلومات Chartbrew" width="2400" height="1289" data-path="images/integrations/data-visualization/chartbrew_01.webp" />

<Tip>
  **أضف بعض البيانات**

  إذا لم تكن لديك مجموعة بيانات للعمل عليها، يمكنك إضافة أحد الأمثلة. يستخدم هذا الدليل مجموعة بيانات [UK Price Paid](/ar/get-started/sample-datasets/uk-price-paid).
</Tip>

<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-detect-table-modification/0yJtAU6cqYAQlCWC/images/_snippets/cloud-connect-button.webp?fit=max&auto=format&n=0yJtAU6cqYAQlCWC&q=85&s=2d1e2340e1ddccf3199ca1e41eeba836" 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-detect-table-modification/0yJtAU6cqYAQlCWC/images/_snippets/connection-details-https.webp?fit=max&auto=format&n=0yJtAU6cqYAQlCWC&q=85&s=2ea2af378046d5ec87ea8e78de573bc1" size="md" alt="تفاصيل اتصال HTTPS لخدمة ClickHouse Cloud" border width="1320" height="1184" data-path="images/_snippets/connection-details-https.webp" />

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

<div id="2-connect-chartbrew-to-clickhouse">
  ## 2. ربط Chartbrew بـ ClickHouse
</div>

1. سجّل الدخول إلى [Chartbrew](https://chartbrew.com/login) ثم انتقل إلى علامة التبويب **Connections**.

2. انقر على **Create connection** ثم اختر **ClickHouse** من خيارات قواعد البيانات المتاحة.

   <Image img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/L7_COrR7NltKl_Va/images/integrations/data-visualization/chartbrew_02.webp?fit=max&auto=format&n=L7_COrR7NltKl_Va&q=85&s=1efe419de8f271eaa0c512bd142c404c" size="lg" alt="اختيار اتصال ClickHouse في Chartbrew" width="1600" height="1132" data-path="images/integrations/data-visualization/chartbrew_02.webp" />

3. أدخل تفاصيل الاتصال بقاعدة بيانات ClickHouse:

   * **Display Name**: اسم لتمييز الاتصال في Chartbrew.
   * **Host**: اسم المضيف أو عنوان IP لخادم ClickHouse.
   * **Port**: يكون عادةً `8443` لاتصالات HTTPS.
   * **Database Name**: قاعدة البيانات التي تريد الاتصال بها.
   * **Username**: اسم مستخدم ClickHouse الخاص بك.
   * **Password**: كلمة مرور ClickHouse الخاصة بك.

   <Image img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/L7_COrR7NltKl_Va/images/integrations/data-visualization/chartbrew_03.webp?fit=max&auto=format&n=L7_COrR7NltKl_Va&q=85&s=1276d502fe1e5803c3a073b468329d2f" size="lg" alt="إعدادات اتصال ClickHouse في Chartbrew" width="1600" height="1141" data-path="images/integrations/data-visualization/chartbrew_03.webp" />

4. انقر على **Test connection** للتحقق من أن Chartbrew يستطيع الاتصال بـ ClickHouse.

5. إذا نجح الاختبار، فانقر على **Save connection**. سيجلب Chartbrew المخطط تلقائيًا من ClickHouse.

   <Image img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/L7_COrR7NltKl_Va/images/integrations/data-visualization/chartbrew_04.webp?fit=max&auto=format&n=L7_COrR7NltKl_Va&q=85&s=fd5375329492fbb597f0a41365f34465" size="lg" alt="مخطط JSON لـ ClickHouse في Chartbrew" width="1600" height="855" data-path="images/integrations/data-visualization/chartbrew_04.webp" />

<div id="3-create-a-dataset-and-run-a-sql-query">
  ## 3. أنشئ مجموعة بيانات وشغّل استعلام SQL
</div>

1. انقر على زر **Create dataset** أو انتقل إلى علامة التبويب **Datasets** لإنشاء مجموعة بيانات.
2. حدِّد اتصال ClickHouse الذي أنشأته سابقًا.

<Image img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/L7_COrR7NltKl_Va/images/integrations/data-visualization/chartbrew_05.webp?fit=max&auto=format&n=L7_COrR7NltKl_Va&q=85&s=b3de22f8c6a59c93992b996664b4ff17" size="lg" alt="حدِّد اتصال ClickHouse لمجموعة البيانات" width="1600" height="725" data-path="images/integrations/data-visualization/chartbrew_05.webp" />

اكتب استعلام SQL لجلب البيانات التي تريد تمثيلها بصريًا. على سبيل المثال، يحسب هذا الاستعلام متوسط السعر المدفوع سنويًا من مجموعة البيانات `uk_price_paid`:

```sql theme={null}
  SELECT toYear(date) AS year, avg(price) AS avg_price
  FROM uk_price_paid
  GROUP BY year
  ORDER BY year;
```

<Image img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/L7_COrR7NltKl_Va/images/integrations/data-visualization/chartbrew_07.webp?fit=max&auto=format&n=L7_COrR7NltKl_Va&q=85&s=e7f18edb8bf9e8cff5b932c37bc0475a" size="lg" alt="استعلام ClickHouse SQL في Chartbrew" width="1600" height="928" data-path="images/integrations/data-visualization/chartbrew_07.webp" />

انقر على **Run query** لجلب البيانات.

إذا لم تكن متأكدًا من كيفية كتابة الاستعلام، يمكنك استخدام **مساعد الذكاء الاصطناعي في Chartbrew** لإنشاء استعلامات SQL استنادًا إلى مخطط قاعدة البيانات لديك.

<Image img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/L7_COrR7NltKl_Va/images/integrations/data-visualization/chartbrew_06.webp?fit=max&auto=format&n=L7_COrR7NltKl_Va&q=85&s=06d5f9eaab20b2b9f16d194263ba6e72" size="lg" alt="مساعد ClickHouse SQL المدعوم بالذكاء الاصطناعي في Chartbrew" width="2400" height="1184" data-path="images/integrations/data-visualization/chartbrew_06.webp" />

بعد استرجاع البيانات، انقر على **Configure dataset** لضبط معلمات التصور.

<div id="4-create-a-visualization">
  ## 4. إنشاء تصور
</div>

1. حدِّد مقياسًا (قيمة رقمية) وبُعدًا (قيمة فئوية) لتصورك.
2. عاين مجموعة البيانات للتأكد من أن نتائج الاستعلام منظَّمة على نحو صحيح.
3. اختر نوع المخطط (مثل مخطط خطي أو مخطط أعمدة أو مخطط دائري) وأضِفه إلى لوحة المعلومات.
4. انقر على **Complete dataset** لإكمال الإعداد.

<Image img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/L7_COrR7NltKl_Va/images/integrations/data-visualization/chartbrew_08.webp?fit=max&auto=format&n=L7_COrR7NltKl_Va&q=85&s=470c0482b165c4e8cb7ecc09ec77de2a" size="lg" alt="لوحة معلومات Chartbrew مع بيانات ClickHouse" width="2400" height="1068" data-path="images/integrations/data-visualization/chartbrew_08.webp" />

يمكنك إنشاء أي عدد تريده من مجموعات البيانات لتصور جوانب مختلفة من بياناتك. وباستخدام مجموعات البيانات هذه، يمكنك إنشاء لوحات معلومات متعددة لمتابعة مقاييس مختلفة.

<Image img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/L7_COrR7NltKl_Va/images/integrations/data-visualization/chartbrew_01.webp?fit=max&auto=format&n=L7_COrR7NltKl_Va&q=85&s=42326e70ce4cdc7334d394ae53dd943a" size="lg" alt="لوحة معلومات Chartbrew مع بيانات ClickHouse" width="2400" height="1289" data-path="images/integrations/data-visualization/chartbrew_01.webp" />

<div id="5-automate-data-updates">
  ## 5. أتمتة تحديثات البيانات
</div>

للحفاظ على تحديث لوحة المعلومات باستمرار، يمكنك جدولة تحديثات البيانات تلقائيًا:

1. انقر على أيقونة التقويم بجوار زر تحديث مجموعة البيانات.
2. اضبط الفاصل الزمني للتحديث (مثلًا: كل ساعة أو كل يوم).
3. احفظ الإعدادات لتفعيل التحديث التلقائي.

<Image img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/L7_COrR7NltKl_Va/images/integrations/data-visualization/chartbrew_09.webp?fit=max&auto=format&n=L7_COrR7NltKl_Va&q=85&s=93fc59013d2591f5603a55a20c961a87" size="lg" alt="إعدادات تحديث مجموعة بيانات Chartbrew" width="1600" height="899" data-path="images/integrations/data-visualization/chartbrew_09.webp" />

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

لمزيد من التفاصيل، اطّلع على تدوينة المدونة حول [Chartbrew وClickHouse](https://chartbrew.com/blog/visualizing-clickhouse-data-with-chartbrew-a-step-by-step-guide/).
