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

> Luzmo هي منصة تحليلات مضمنة توفر تكاملًا أصليًا مع ClickHouse، وقد صُممت خصيصًا لتطبيقات البرمجيات وتطبيقات SaaS.

# تكامل Luzmo مع 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>;
};

<CommunityMaintainedBadge />

<Steps>
  <Step title="إعداد اتصال ClickHouse" id="1-setup-a-clickhouse-connection">
    لإنشاء اتصال بـ ClickHouse، انتقل إلى **صفحة Connections**، وحدد **New Connection**، ثم اختر ClickHouse من نافذة **New Connection** المنبثقة.

    <Image img="https://mintcdn.com/private-7c7dfe99/etDiFo_9fGSe5rMN/images/integrations/data-visualization/luzmo_01.webp?fit=max&auto=format&n=etDiFo_9fGSe5rMN&q=85&s=967e6102cd8c64b737019bc319980003" size="md" alt="واجهة Luzmo تعرض مربع الحوار Create a New Connection مع تحديد ClickHouse" border width="720" height="497" data-path="images/integrations/data-visualization/luzmo_01.webp" />

    سيُطلب منك إدخال **المضيف** و**اسم المستخدم** و**كلمة المرور**:

    <Image img="https://mintcdn.com/private-7c7dfe99/etDiFo_9fGSe5rMN/images/integrations/data-visualization/luzmo_02.webp?fit=max&auto=format&n=etDiFo_9fGSe5rMN&q=85&s=0441f2efee476fc353d914bc808a73e8" size="md" alt="نموذج تكوين اتصال Luzmo يعرض حقول مضيف ClickHouse واسم المستخدم وكلمة المرور" border width="462" height="454" data-path="images/integrations/data-visualization/luzmo_02.webp" />

    * **Host**: هذا هو المضيف الذي تكون قاعدة بيانات ClickHouse الخاصة بك مكشوفة عليه. لاحظ أنه لا يُسمح هنا إلا باستخدام `https` لنقل البيانات بأمان عبر الشبكة. ويتوقع URL الخاص بالمضيف البنية التالية: `https://url-to-clickhouse-db:port/database`
      افتراضيًا، ستتصل الإضافة بقاعدة البيانات 'default' وعلى المنفذ 443. ومن خلال تحديد قاعدة بيانات بعد '/'، يمكنك تعيين قاعدة البيانات المطلوب الاتصال بها.
    * **Username**: اسم المستخدم الذي سيُستخدم للاتصال بعنقود ClickHouse الخاص بك.
    * **Password**: كلمة المرور المستخدمة للاتصال بعنقود ClickHouse الخاص بك

    يُرجى الرجوع إلى الأمثلة في وثائق المطورين الخاصة بنا لمعرفة كيفية [إنشاء اتصال بـ ClickHouse](https://developer.luzmo.com/api/createAccount?exampleSection=AccountCreateClickhouseRequestBody) عبر واجهة برمجة تطبيقات الخاصة بنا.
  </Step>

  <Step title="إضافة مجموعات البيانات" id="2-add-datasets">
    بمجرد توصيل ClickHouse، يمكنك إضافة مجموعات البيانات كما هو موضح [هنا](https://academy.luzmo.com/article/ldx3iltg). يمكنك تحديد مجموعة بيانات واحدة أو عدة مجموعات بيانات متاحة في ClickHouse لديك و[ربطها](https://academy.luzmo.com/article/gkrx48x5) في Luzmo لضمان إمكانية استخدامها معًا في لوحة معلومات. وتأكد أيضًا من الاطلاع على هذه المقالة حول [تهيئة بياناتك لأغراض التحليلات](https://academy.luzmo.com/article/u492qov0).

    لمعرفة كيفية إضافة مجموعات البيانات باستخدام واجهة برمجة تطبيقات الخاصة بنا، يُرجى الرجوع إلى [هذا المثال في وثائق المطورين الخاصة بنا](https://developer.luzmo.com/api/createDataprovider?exampleSection=DataproviderCreateClickhouseRequestBody).

    يمكنك الآن استخدام مجموعات البيانات الخاصة بك لإنشاء لوحات معلومات جميلة (مضمّنة)، أو حتى لتشغيل محلل بيانات بالذكاء الاصطناعي ([Luzmo IQ](https://luzmo.com/iq)) يمكنه الإجابة عن أسئلة عملائك.

    <Image img="https://mintcdn.com/private-7c7dfe99/etDiFo_9fGSe5rMN/images/integrations/data-visualization/luzmo_03.webp?fit=max&auto=format&n=etDiFo_9fGSe5rMN&q=85&s=4b66ae70e426978f43f8d82e1abed64c" size="md" alt="مثال على لوحة معلومات في Luzmo تعرض عدة تصورات للبيانات من ClickHouse" border width="956" height="693" data-path="images/integrations/data-visualization/luzmo_03.webp" />
  </Step>
</Steps>

<div id="usage-notes">
  ## ملاحظات الاستخدام
</div>

1. يستخدم موصل Luzmo لـ ClickHouse واجهة HTTP API (التي تعمل عادةً على المنفذ 8123) للاتصال.
2. إذا كنت تستخدم جداول بمحرك الجدول `Distributed`، فقد تتعطل بعض مخططات Luzmo عندما تكون قيمة `distributed_product_mode` هي `deny`. ومع ذلك، لا يحدث هذا عادةً إلا إذا ربطت الجدول بجدول آخر واستخدمت هذا الربط في مخطط. في هذه الحالة، تأكد من تعيين `distributed_product_mode` إلى خيار آخر مناسب ضمن عنقود ClickHouse لديك. وإذا كنت تستخدم ClickHouse Cloud، فيمكنك تجاهل هذا الإعداد بأمان.
3. لضمان أن يتمكن تطبيق Luzmo وحده، على سبيل المثال، من الوصول إلى مثيل ClickHouse لديك، يُنصح بشدة **بإدراج** [نطاق عناوين IP الثابتة الخاص بـ Luzmo في قائمة السماح](https://academy.luzmo.com/article/u9on8gbm). كما نوصي باستخدام مستخدم تقني للقراءة فقط.
4. يدعم موصل ClickHouse حاليًا أنواع البيانات التالية:

   | نوع ClickHouse | نوع Luzmo |
   | -------------- | --------- |
   | UInt           | رقمي      |
   | Int            | رقمي      |
   | Float          | رقمي      |
   | Decimal        | رقمي      |
   | Date           | تاريخ/وقت |
   | DateTime       | تاريخ/وقت |
   | String         | هرمي      |
   | Enum           | هرمي      |
   | FixedString    | هرمي      |
   | UUID           | هرمي      |
   | Bool           | هرمي      |