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

> 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 = "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 />

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

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

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

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

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

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

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

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

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

    | المعلمات                  | الوصف                                                                                         |
    | ------------------------- | --------------------------------------------------------------------------------------------- |
    | `HOST` and `PORT`         | عادةً ما يكون المنفذ 8443 عند استخدام TLS، أو 8123 عند عدم استخدام TLS.                       |
    | `DATABASE NAME`           | افتراضيًا، توجد قاعدة بيانات باسم `default`. استخدم اسم قاعدة البيانات التي تريد الاتصال بها. |
    | `USERNAME` and `PASSWORD` | افتراضيًا، يكون اسم المستخدم `default`. استخدم اسم المستخدم المناسب لحالة الاستخدام لديك.     |

    تتوفر تفاصيل خدمة ClickHouse Cloud الخاصة بك في ClickHouse Cloud console.
    حدِّد خدمة ثم انقر على **Connect**:

    <div className="ch-image-md">
      <Frame>
        <img src="https://mintcdn.com/private-7c7dfe99/CFFsa2agBPbviR4r/images/_snippets/cloud-connect-button.webp?fit=max&auto=format&n=CFFsa2agBPbviR4r&q=85&s=ec0a298a33ca841e947fa5e8bae47362" alt="زر Connect لخدمة ClickHouse Cloud" width="998" height="932" data-path="images/_snippets/cloud-connect-button.webp" />
      </Frame>
    </div>

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

    <div className="ch-image-md">
      <Frame>
        <img src="https://mintcdn.com/private-7c7dfe99/CFFsa2agBPbviR4r/images/_snippets/connection-details-https.webp?fit=max&auto=format&n=CFFsa2agBPbviR4r&q=85&s=cb0fbd98aa2b5b7ca484c9f53395ee07" alt="تفاصيل اتصال HTTPS لخدمة ClickHouse Cloud" width="1320" height="1184" data-path="images/_snippets/connection-details-https.webp" />
      </Frame>
    </div>

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

  <Step title="سجّل الدخول أو أنشئ حسابًا في Mitzu" id="2-sign-in-or-sign-up-to-mitzu">
    كخطوة أولى، توجَّه إلى [https://app.mitzu.io](https://app.mitzu.io) لإنشاء حساب.

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

  <Step title="هيِّئ مساحة العمل الخاصة بك" id="3-configure-your-workspace">
    بعد إنشاء المؤسسة، اتبع دليل onboarding `Set up your workspace` في الشريط الجانبي الأيسر. ثم انقر على الرابط `Connect Mitzu with your data warehouse`.

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

  <Step title="توصيل Mitzu بـ ClickHouse" id="4-connect-mitzu-to-clickhouse">
    أولًا، حدِّد ClickHouse كنوع الاتصال وأدخِل تفاصيل الاتصال. ثم انقر على زر `Test connection & Save` لحفظ الإعدادات.

    <Image size="lg" img="https://mintcdn.com/private-7c7dfe99/etDiFo_9fGSe5rMN/images/integrations/data-visualization/mitzu_03.webp?fit=max&auto=format&n=etDiFo_9fGSe5rMN&q=85&s=67d24d93585e89f878e4588f4997cd81" alt="صفحة إعداد اتصال Mitzu لـ ClickHouse مع نموذج التكوين" border width="1323" height="850" data-path="images/integrations/data-visualization/mitzu_03.webp" />
  </Step>

  <Step title="إعداد جداول الأحداث" id="5-configure-event-tables">
    بمجرد حفظ الاتصال، حدِّد علامة التبويب `Event tables` وانقر على زر `Add table`. في النافذة المنبثقة، حدِّد قاعدة البيانات والجداول التي تريد إضافتها إلى Mitzu.

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

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

    <br />

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

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

    <br />

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

  <Step title="تنفيذ استعلامات التجزئة" id="4-run-segmentation-queries">
    تقسيم المستخدمين إلى شرائح في Mitzu سهل تمامًا كما هو الحال في Amplitude أو Mixpanel أو PostHog.

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

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

    <br />

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

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

  <Step title="تنفيذ استعلامات مسار التحويل" id="5-run-funnel-queries">
    حدِّد ما يصل إلى 9 خطوات لمسار التحويل. اختر الإطار الزمني الذي يمكن للمستخدمين خلاله إكمال مسار التحويل.
    احصل على رؤى فورية حول معدل التحويل من دون كتابة أي سطر من شيفرة SQL.

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

    <br />

    <Tip>
      **اعرض الاتجاهات**

      اختر `Funnel trends` لتصوُّر اتجاهات مسار التحويل بمرور الوقت.
    </Tip>
  </Step>

  <Step title="تشغيل استعلامات الاستبقاء" id="6-run-retention-queries">
    حدِّد ما يصل إلى خطوتين لحساب معدل الاحتفاظ. اختر نافذة الاحتفاظ الخاصة بالنافذة المتكررة لـ
    احصل على رؤى فورية حول معدل التحويل دون كتابة سطر واحد من شيفرة SQL.

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

    <br />

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

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

  <Step title="تنفيذ استعلامات الرحلات" id="7-run-journey-queries">
    حدِّد ما يصل إلى 9 خطوات لمسار التحويل. اختر الإطار الزمني الذي يمكن للمستخدمين خلاله إكمال الرحلة. يوفّر مخطط رحلة Mitzu خريطة بصرية لكل مسار يسلكه المستخدمون عبر الأحداث المحددة.

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

    <br />

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

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

    <br />
  </Step>

  <Step title="تنفيذ استعلامات الإيرادات" id="8-run-revenue-queries">
    إذا تم تكوين إعدادات الإيرادات، يمكن لـ Mitzu حساب إجمالي MRR وعدد الاشتراكات استنادًا إلى أحداث الدفع لديك.

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

  <Step title="SQL الأصلية" id="9-sql-native">
    Mitzu يعتمد على SQL الأصلي، ما يعني أنه يُنشئ شيفرة SQL أصلية من الإعداد الذي تختاره في صفحة Explore.

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

    <br />

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

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

<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)
