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

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

<div id="1-setup-a-clickhouse-connection">
  ## 1. إعداد اتصال ClickHouse
</div>

لإنشاء اتصال بـ ClickHouse، انتقل إلى **صفحة Connections**، وحدد **New Connection**، ثم اختر ClickHouse من النافذة المنبثقة New Connection.

<Image img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/svLCKm9RWi4jibqG/images/integrations/data-visualization/luzmo_01.webp?fit=max&auto=format&n=svLCKm9RWi4jibqG&q=85&s=78a3e8cf0dabcf65333fbcc026dafa68" 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-detect-table-modification/svLCKm9RWi4jibqG/images/integrations/data-visualization/luzmo_02.webp?fit=max&auto=format&n=svLCKm9RWi4jibqG&q=85&s=cfce5692bea9661642b5a1384b4058e2" 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) عبر API الخاص بنا.

<div id="2-add-datasets">
  ## 2. أضف مجموعات البيانات
</div>

بعد توصيل ClickHouse، يمكنك إضافة مجموعات البيانات كما هو موضح [هنا](https://academy.luzmo.com/article/ldx3iltg). يمكنك اختيار مجموعة بيانات واحدة أو عدة مجموعات بيانات متاحة في ClickHouse، ثم [ربطها](https://academy.luzmo.com/article/gkrx48x5) في Luzmo لضمان إمكانية استخدامها معًا في لوحة معلومات. واحرص أيضًا على الاطلاع على هذه المقالة حول [إعداد بياناتك لأغراض تحليل](https://academy.luzmo.com/article/u492qov0).

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

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

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

<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           | هرمي      |