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

> Mitzu هو تطبيق لتحليلات المنتجات دون برمجة ويعمل مباشرةً فوق مستودعات البيانات.

# ربط Mitzu بـ 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}) => {
  return <Frame>
      <img src={img} alt={alt} />
    </Frame>;
};

Mitzu هو تطبيق تحليلات المنتجات دون برمجة ومعتمد على مستودع البيانات. وعلى غرار أدوات مثل Amplitude وMixpanel وPostHog، يتيح Mitzu للمستخدمين تحليل بيانات استخدام المنتج من دون الحاجة إلى خبرة في SQL أو Python.

لكن، بخلاف هذه المنصات، لا ينسخ Mitzu بيانات استخدام المنتج الخاصة بالشركة. وبدلًا من ذلك، يُنشئ استعلامات SQL أصلية مباشرةً على مستودع البيانات أو بحيرة البيانات الحالية لدى الشركة.

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

في هذا الدليل، سنتناول ما يلي:

* تحليلات المنتجات المعتمدة مباشرة على مستودع البيانات
* كيفية دمج Mitzu مع ClickHouse

<Tip>
  **مجموعات بيانات تجريبية**

  إذا لم تكن لديك مجموعة بيانات لاستخدامها مع Mitzu، فيمكنك العمل باستخدام بيانات سيارات الأجرة في نيويورك.
  مجموعة البيانات هذه متاحة في ClickHouse Cloud أو [يمكن تحميلها باتباع هذه التعليمات](/ar/get-started/sample-datasets/nyc-taxi).
</Tip>

هذا الدليل ليس سوى نظرة عامة مختصرة حول كيفية استخدام Mitzu. ويمكنك العثور على معلومات أكثر تفصيلًا في [وثائق Mitzu](https://docs.mitzu.io/).

<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-mintlify-a804b3ad/daBhXl5XtKWCwD8z/images/_snippets/cloud-connect-button.png?fit=max&auto=format&n=daBhXl5XtKWCwD8z&q=85&s=82b4154e6a183c6abc449c7b38a5ba43" size="md" alt="زر Connect لخدمة ClickHouse Cloud" border width="998" height="932" data-path="images/_snippets/cloud-connect-button.png" />

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

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

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

<div id="2-sign-in-or-sign-up-to-mitzu">
  ## 2. سجّل الدخول أو أنشئ حسابًا في Mitzu
</div>

كخطوة أولى، توجّه إلى [https://app.mitzu.io](https://app.mitzu.io) لإنشاء حساب.

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99-mintlify-a804b3ad/P3SyKDuwIqPWegWb/images/integrations/data-visualization/mitzu_01.png?fit=max&auto=format&n=P3SyKDuwIqPWegWb&q=85&s=ae822b2e8560aacba0fe3bab80909acd" alt="صفحة تسجيل الدخول إلى Mitzu مع حقلي البريد الإلكتروني وكلمة المرور" border width="1913" height="962" data-path="images/integrations/data-visualization/mitzu_01.png" />

<div id="3-configure-your-workspace">
  ## 3. هيّئ مساحة العمل الخاصة بك
</div>

بعد إنشاء مؤسسة، اتبع دليل التهيئة `Set up your workspace` في الشريط الجانبي الأيسر. ثم انقر على الرابط `Connect Mitzu with your data warehouse`.

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99-mintlify-a804b3ad/P3SyKDuwIqPWegWb/images/integrations/data-visualization/mitzu_02.png?fit=max&auto=format&n=P3SyKDuwIqPWegWb&q=85&s=1ea74d4c42db5c49cfead060b1910ba2" alt="صفحة إعداد مساحة عمل Mitzu التي تعرض خطوات التهيئة" border width="1919" height="967" data-path="images/integrations/data-visualization/mitzu_02.png" />

<div id="4-connect-mitzu-to-clickhouse">
  ## 4. توصيل Mitzu بـ ClickHouse
</div>

أولاً، حدِّد ClickHouse كنوع الاتصال وأدخِل تفاصيل الاتصال. ثم انقر على زر `Test connection & Save` لحفظ الإعدادات.

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99-mintlify-a804b3ad/P3SyKDuwIqPWegWb/images/integrations/data-visualization/mitzu_03.png?fit=max&auto=format&n=P3SyKDuwIqPWegWb&q=85&s=92aae03f1e69021e321114b2aba4d198" alt="صفحة إعداد اتصال Mitzu مع ClickHouse وبها نموذج إعداد" border width="1323" height="850" data-path="images/integrations/data-visualization/mitzu_03.png" />

<div id="5-configure-event-tables">
  ## 5. إعداد جداول الأحداث
</div>

بمجرد حفظ الاتصال، حدِّد علامة التبويب `Event tables` وانقر على زر `Add table`. في النافذة المنبثقة، حدِّد قاعدة البيانات والجداول التي تريد إضافتها إلى Mitzu.

استخدم مربعات الاختيار لتحديد جدول واحد على الأقل، ثم انقر على زر `Configure table`. سيؤدي ذلك إلى فتح نافذة منبثقة يمكنك فيها تعيين الأعمدة الأساسية لكل جدول.

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99-mintlify-a804b3ad/P3SyKDuwIqPWegWb/images/integrations/data-visualization/mitzu_04.png?fit=max&auto=format&n=P3SyKDuwIqPWegWb&q=85&s=402fc150ec2f24fb102421bfa63d4050" alt="واجهة اختيار جداول Mitzu التي تعرض جداول قاعدة البيانات" border width="1341" height="885" data-path="images/integrations/data-visualization/mitzu_04.png" />

<br />

> لتشغيل تحليلات المنتجات على إعداد ClickHouse لديك، تحتاج إلى تحديد بعض الأعمدة الأساسية من جدولك.
>
> وهي كالتالي:
>
> * **معرّف المستخدم** - العمود الذي يحتوي على المعرّف الفريد للمستخدمين.
> * **وقت الحدث** - عمود الطابع الزمني لأحداثك.
> * اختياري \[**اسم الحدث**] - يُقسِّم هذا العمود الأحداث إذا كان الجدول يحتوي على أنواع متعددة من الأحداث.

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99-mintlify-a804b3ad/P3SyKDuwIqPWegWb/images/integrations/data-visualization/mitzu_05.png?fit=max&auto=format&n=P3SyKDuwIqPWegWb&q=85&s=607d05f1c3a9fb69b5e6badecd94f8f9" alt="إعداد فهرس أحداث Mitzu الذي يعرض خيارات تعيين الأعمدة" border width="1611" height="693" data-path="images/integrations/data-visualization/mitzu_05.png" />

<br />

بعد إعداد جميع الجداول، انقر على زر `Save & update event catalog`، وسيعثر Mitzu على جميع الأحداث وخصائصها من الجدول المحدد أعلاه. قد تستغرق هذه الخطوة بضع دقائق، بحسب حجم مجموعة البيانات لديك.

<div id="4-run-segmentation-queries">
  ## 4. تشغيل استعلامات التقسيم
</div>

تقسيم المستخدمين في Mitzu سهل تمامًا كما هو في Amplitude أو Mixpanel أو PostHog.

تتضمن صفحة Explore منطقة تحديد للأحداث على الجانب الأيسر، بينما يتيح لك القسم العلوي ضبط النطاق الزمني.

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99-mintlify-a804b3ad/P3SyKDuwIqPWegWb/images/integrations/data-visualization/mitzu_06.png?fit=max&auto=format&n=P3SyKDuwIqPWegWb&q=85&s=19eb50cfe59cac4a2469a73470465ae1" alt="واجهة استعلامات التقسيم في Mitzu مع تحديد الأحداث وضبط النطاق الزمني" border width="1634" height="873" data-path="images/integrations/data-visualization/mitzu_06.png" />

<br />

<Tip>
  **عوامل التصفية والتقسيم**

  تتم التصفية بالطريقة المعتادة: اختر خاصية (عمود في ClickHouse) وحدد القيم التي تريد التصفية بها من القائمة المنسدلة.
  يمكنك اختيار أي خاصية للحدث أو للمستخدم لإجراء التقسيم (راجع أدناه لمعرفة كيفية دمج خصائص المستخدم).
</Tip>

<div id="5-run-funnel-queries">
  ## 5. تشغيل استعلامات مسار التحويل
</div>

اختر ما يصل إلى 9 خطوات لمسار التحويل. وحدِّد الإطار الزمني الذي يمكن للمستخدمين خلاله إكمال هذا المسار.
احصل على رؤى فورية حول معدلات التحويل دون كتابة أي تعليمة SQL.

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99-mintlify-a804b3ad/P3SyKDuwIqPWegWb/images/integrations/data-visualization/mitzu_07.png?fit=max&auto=format&n=P3SyKDuwIqPWegWb&q=85&s=177ef8abfcad74f15d7a62c62f241bad" alt="عرض تحليل مسار التحويل في Mitzu يوضّح معدلات التحويل بين الخطوات" border width="1630" height="880" data-path="images/integrations/data-visualization/mitzu_07.png" />

<br />

<Tip>
  **اعرض الاتجاهات بصريًا**

  اختر `Funnel trends` لعرض اتجاهات مسار التحويل بمرور الوقت.
</Tip>

<div id="6-run-retention-queries">
  ## 6. شغّل استعلامات الاحتفاظ
</div>

حدّد ما يصل إلى خطوتين لحساب معدل الاحتفاظ. اختر نافذة الاحتفاظ للنافذة المتكررة للحصول على
رؤى فورية حول معدل التحويل دون كتابة سطر واحد من تعليمات SQL البرمجية.

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99-mintlify-a804b3ad/P3SyKDuwIqPWegWb/images/integrations/data-visualization/mitzu_08.png?fit=max&auto=format&n=P3SyKDuwIqPWegWb&q=85&s=9c73a21eec716b413bdf67a53bd2f4ef" alt="تحليل الاحتفاظ في Mitzu الذي يعرض معدلات احتفاظ المجموعات" border width="1634" height="828" data-path="images/integrations/data-visualization/mitzu_08.png" />

<br />

<Tip>
  **الاحتفاظ بالمجموعة**

  اختر `Weekly cohort retention` لتصوّر كيف تتغيّر معدلات الاحتفاظ بمرور الوقت.
</Tip>

<div id="7-run-journey-queries">
  ## 7. نفِّذ استعلامات الرحلة
</div>

حدِّد ما يصل إلى 9 خطوات لمسار التحويل. واختر النافذة الزمنية التي يمكن للمستخدمين خلالها إكمال الرحلة. يوفّر مخطط الرحلة في Mitzu عرضًا مرئيًا لكل مسار يسلكه المستخدمون عبر الأحداث المحددة.

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99-mintlify-a804b3ad/P3SyKDuwIqPWegWb/images/integrations/data-visualization/mitzu_09.png?fit=max&auto=format&n=P3SyKDuwIqPWegWb&q=85&s=fa030817b44a5e77cfe6a24fa1b7318d" alt="تصوّر رحلة Mitzu يوضّح تدفق مسار المستخدم بين الأحداث" border width="1630" height="885" data-path="images/integrations/data-visualization/mitzu_09.png" />

<br />

<Tip>
  **قسِّم الخطوات**

  يمكنك تحديد خاصية ضمن الشريحة `Break down` لتمييز المستخدمين داخل الخطوة نفسها.
</Tip>

<br />

<div id="8-run-revenue-queries">
  ## 8. شغّل استعلامات الإيرادات
</div>

إذا كانت إعدادات الإيرادات مُعدّة، يمكن لـ Mitzu حساب إجمالي MRR وعدد الاشتراكات استنادًا إلى أحداث الدفع لديك.

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99-mintlify-a804b3ad/P3SyKDuwIqPWegWb/images/integrations/data-visualization/mitzu_10.png?fit=max&auto=format&n=P3SyKDuwIqPWegWb&q=85&s=09eea4994181fec8897bc092c2cd9c05" alt="لوحة معلومات تحليل الإيرادات في Mitzu تعرض مقاييس MRR" border width="1634" height="820" data-path="images/integrations/data-visualization/mitzu_10.png" />

<div id="9-sql-native">
  ## 9. SQL الأصلي
</div>

يعتمد Mitzu على SQL الأصلي، ما يعني أنه ينشئ شيفرة SQL أصلية انطلاقًا من configuration التي تختارها في صفحة Explore.

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99-mintlify-a804b3ad/P3SyKDuwIqPWegWb/images/integrations/data-visualization/mitzu_11.png?fit=max&auto=format&n=P3SyKDuwIqPWegWb&q=85&s=9aa9297cbf08985d4d6fbf3b1529b48f" alt="عرض إنشاء شيفرة SQL في Mitzu يُظهر استعلام ClickHouse أصليًا" border width="3814" height="1854" data-path="images/integrations/data-visualization/mitzu_11.png" />

<br />

<Tip>
  **تابع عملك في أداة BI**

  إذا واجهت أحد قيود واجهة Mitzu، فانسخ شيفرة SQL وتابع عملك في أداة BI.
</Tip>

<div id="mitzu-support">
  ## دعم Mitzu
</div>

إذا كنت بحاجة إلى المساعدة، فلا تتردد في التواصل معنا على [support@mitzu.io](email://support@mitzu.io)

أو الانضمام إلى مجتمعنا على Slack من [هنا](https://join.slack.com/t/mitzu-io/shared_invite/zt-1h1ykr93a-_VtVu0XshfspFjOg6sczKg)

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

اطّلع على مزيد من المعلومات حول Mitzu على [mitzu.io](https://mitzu.io)

تفضّل بزيارة صفحة الوثائق الخاصة بنا على [docs.mitzu.io](https://docs.mitzu.io)
