> ## 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.

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

# ربط ClickHouse بـ Holistics

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

<CommunityMaintainedBadge />

[Holistics](https://www.holistics.io/) هي منصة ذكاء أعمال ذاتي الخدمة مصممة أصلًا للذكاء الاصطناعي، وتوفّر طبقة دلالية قابلة للبرمجة تضمن مقاييس متسقة وموثوقة.

من خلال ربط ClickHouse بـ Holistics، تحصل فرقك على تجربة ذاتية الخدمة سريعة وموثوقة ومدعومة بالذكاء الاصطناعي، وترتكز إلى طبقة دلالية قائمة على الشيفرة. ويمكن لمستخدمي الأعمال استكشاف البيانات بثقة باستخدام السحب والإفلات والذكاء الاصطناعي، بينما تحافظ أنت على تعريفات المقاييس بحيث تكون قابلة لإعادة الاستخدام، وقابلة للتركيب، وخاضعة للتحكم في الإصدارات عبر Git.

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

قبل الاتصال، تأكد من توفر ما يلي:

* **الأذونات:** يجب أن تكون Admin في Holistics حتى تتمكن من إضافة Data Sources جديدة.
* **الوصول إلى الشبكة:** يجب أن يكون خادم ClickHouse لديك متاحًا للوصول من [عناوين IP الخاصة بـ Holistics](https://docs.holistics.io/docs/connect/ip-whitelisting).
* **مستخدم قاعدة البيانات:** أنشئ مستخدمًا مخصصًا للقراءة فقط لـ Holistics بدلًا من استخدام حساب مسؤول.

<div id="recommended-privileges">
  ### الامتيازات الموصى بها
</div>

يتطلب المستخدم المخصص امتيازات `SELECT` على الجداول التي تريد الاستعلام عنها، بالإضافة إلى جداول `system` (لاكتشاف المخطط).

```sql theme={null}
-- Example: Grant read access to a specific database
GRANT SELECT ON my_database.* TO holistics_user;

-- Grant access to system metadata
GRANT SELECT ON system.* TO holistics_user;
```

<Steps>
  <Step title="اجمع تفاصيل الاتصال" id="step-1-gather-connection-details">
    للاتصال بـ ClickHouse عبر HTTP(S)، ستحتاج إلى المعلومات التالية:

    | **المعلمة**       | **الوصف**                                                                                      |
    | ----------------- | ---------------------------------------------------------------------------------------------- |
    | **Host**          | اسم المضيف لخادم ClickHouse لديك (على سبيل المثال: `mz322.eu-central-1.aws.clickhouse.cloud`). |
    | **Port**          | **8443** لـ ClickHouse Cloud ‏(SSL/TLS)، و**8123** للمثيلات ذاتية الإدارة من دون SSL.          |
    | **Database Name** | اسم قاعدة البيانات التي تريد الاتصال بها. وعادةً ما تكون القيمة الافتراضية `default`.          |
    | **Username**      | اسم مستخدم قاعدة البيانات. والقيمة الافتراضية هي `default`.                                    |
    | **Password**      | كلمة المرور الخاصة بمستخدم قاعدة البيانات.                                                     |

    يمكنك العثور على هذه التفاصيل بالنقر على زر **Connect** في وحدة تحكم ClickHouse Cloud واختيار **HTTPS**.

    <Image size="md" img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/holistics_01.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=512a3ef076212baa4887e0f241b400c4" alt="موضع زر Connect في وحدة تحكم ClickHouse Cloud" border width="998" height="932" data-path="images/integrations/data-visualization/holistics_01.webp" />
  </Step>

  <Step title="اضبط الوصول إلى الشبكة" id="step-2-configure-network-access">
    بما أن Holistics تطبيق قائم على السحابة، يجب أن تتمكن خوادمه من الوصول إلى قاعدة بياناتك. لديك خياران:

    1. **اتصال مباشر (موصى به):** اسمح بعناوين IP الخاصة بـ Holistics في جدار الحماية لديك أو في IP Access List الخاصة بـ ClickHouse Cloud. يمكنك العثور على قائمة عناوين IP في [دليل IP Whitelisting](https://docs.holistics.io/docs/connect/ip-whitelisting).

           <Image size="md" img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/holistics_02.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=ec2b20fe5329b6bd9ed39a5547b5c1cc" alt="مثال على السماح بعناوين IP في ClickHouse Cloud" border width="1651" height="1131" data-path="images/integrations/data-visualization/holistics_02.webp" />

    2. **نفق SSH عكسي:** إذا كانت قاعدة بياناتك موجودة في شبكة خاصة ‏(VPC) ولا يمكن إتاحتها على الإنترنت العام، فاستخدم [Reverse SSH Tunnel](https://docs.holistics.io/docs/connect/connect-tunnel).
  </Step>

  <Step title="أضف مصدر بيانات في Holistics" id="step-3-add-data-source-in-holistics">
    1. في Holistics، انتقل إلى **Settings → Data Sources**.

           <Image size="md" img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/holistics_03.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=140bed8bce68e86bcb0f42e6486ea30a" alt="الانتقال إلى Data Sources في إعدادات Holistics" border width="1647" height="1129" data-path="images/integrations/data-visualization/holistics_03.webp" />

    2. انقر على **New Data Source** ثم اختر **ClickHouse**.

           <Image size="md" img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/holistics_04.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=d92626890c46a53d7ff9dc980c02cf6a" alt="اختيار ClickHouse من قائمة مصادر البيانات الجديدة" border width="1651" height="1131" data-path="images/integrations/data-visualization/holistics_04.webp" />

    3. املأ النموذج بالتفاصيل التي جمعتها في الخطوة 1.

       | **الحقل**         | **الإعداد**                                                             |
       | ----------------- | ----------------------------------------------------------------------- |
       | **Host**          | اسم مضيف ClickHouse لديك                                                |
       | **Port**          | `8443` (أو `8123`)                                                      |
       | **Require SSL**   | بدّل إلى **ON** إذا كنت تستخدم المنفذ 8443 (مطلوب لـ ClickHouse Cloud). |
       | **Database Name** | `default` (أو اسم DB الخاص بك)                                          |

           <Image size="md" img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/holistics_05.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=cf2745f7ec9288d499a9d1a8ba349a73" alt="إدخال تفاصيل اتصال ClickHouse في Holistics" border width="1651" height="1131" data-path="images/integrations/data-visualization/holistics_05.webp" />

    4. انقر على **Test Connection**.

           <Image size="md" img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/holistics_06.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=c48de7963b5e10198c670e3f62ec4496" alt="نجاح اختبار اتصال ClickHouse في Holistics" border width="1651" height="1131" data-path="images/integrations/data-visualization/holistics_06.webp" />

       * **نجاح:** انقر على **Save**.
       * **فشل:** تحقق من اسم المستخدم/كلمة المرور، وتأكد من السماح [بعناوين IP الخاصة بـ Holistics](https://docs.holistics.io/docs/connect/ip-whitelisting).
  </Step>
</Steps>

<div id="known-limitations">
  ## القيود المعروفة
</div>

تدعم Holistics معظم ميزات SQL القياسية في ClickHouse، مع الاستثناءات التالية:

* **الإجمالي التراكمي:** هذه الدالة التحليلية مدعومة حاليًا بشكل محدود في ClickHouse.
* **أنواع البيانات المتداخلة:** قد تتطلب بُنى JSON أو Array المتداخلة بعمق تسطيحها عبر نماذج SQL قبل عرضها بصريًا.

للاطلاع على القائمة الكاملة بالميزات المدعومة، يُرجى الرجوع إلى [صفحة القيود الخاصة بقاعدة البيانات](https://docs.holistics.io/docs/connect/faqs/clickhouse-limitations).