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

> Microsoft Power BI هو منتج برمجي تفاعلي لتصور البيانات طورته Microsoft، ويركّز بالأساس على ذكاء الأعمال.

# Power BI

export const ClickHouseSupportedBadge = () => {
  return <div className="ClickHouseSupportedBadge">
            <div className="ClickHouseSupportedIcon">
                <svg width="16" height="16" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
                    <path d="M1.30762 1.39073C1.30762 1.3103 1.37465 1.22986 1.46849 1.22986H2.64824C2.72868 1.22986 2.80912 1.29689 2.80912 1.39073V14.4886C2.80912 14.5691 2.74209 14.6495 2.64824 14.6495H1.46849C1.38805 14.6495 1.30762 14.5825 1.30762 14.4886V1.39073Z" fill="currentColor" />
                    <path d="M4.2832 1.39073C4.2832 1.3103 4.35023 1.22986 4.44408 1.22986H5.62383C5.70427 1.22986 5.7847 1.29689 5.7847 1.39073V14.4886C5.7847 14.5691 5.71767 14.6495 5.62383 14.6495H4.44408C4.36364 14.6495 4.2832 14.5825 4.2832 14.4886V1.39073Z" fill="currentColor" />
                    <path d="M7.25977 1.39073C7.25977 1.3103 7.3268 1.22986 7.42064 1.22986H8.60039C8.68083 1.22986 8.76127 1.29689 8.76127 1.39073V14.4886C8.76127 14.5691 8.69423 14.6495 8.60039 14.6495H7.42064C7.3402 14.6495 7.25977 14.5825 7.25977 14.4886V1.39073Z" fill="currentColor" />
                    <path d="M10.2354 1.39073C10.2354 1.3103 10.3024 1.22986 10.3962 1.22986H11.576C11.6564 1.22986 11.7369 1.29689 11.7369 1.39073V14.4886C11.7369 14.5691 11.6698 14.6495 11.576 14.6495H10.3962C10.3158 14.6495 10.2354 14.5825 10.2354 14.4886V1.39073Z" fill="currentColor" />
                    <path d="M13.2256 6.6057C13.2256 6.52526 13.2926 6.44482 13.3865 6.44482H14.5662C14.6466 6.44482 14.7271 6.51186 14.7271 6.6057V9.27354C14.7271 9.35398 14.6601 9.43442 14.5662 9.43442H13.3865C13.306 9.43442 13.2256 9.36739 13.2256 9.27354V6.6057Z" fill="currentColor" />
                </svg>
            </div>
            متوافق مع ClickHouse
        </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>;
};

يمكن لـ Microsoft Power BI الاستعلام عن البيانات أو تحميلها إلى الذاكرة من [ClickHouse Cloud](https://clickhouse.com/cloud) أو من عملية نشر مُدارة ذاتيًا.

توجد عدة إصدارات من Power BI يمكنك استخدامها لتصور بياناتك:

* Power BI Desktop: تطبيق سطح مكتب لنظام Windows لإنشاء لوحات المعلومات والتصورات
* خدمة Power BI: متاح ضمن Azure كخدمة SaaS لاستضافة لوحات المعلومات التي أُنشئت في Power BI Desktop

يتطلب Power BI إنشاء لوحات المعلومات في إصدار Desktop ثم نشرها إلى خدمة Power BI.

سيرشدك هذا الدليل العملي خلال عملية:

* [تثبيت ClickHouse ODBC Driver](#install-the-odbc-driver)
* [تثبيت ClickHouse Power BI Connector في Power BI Desktop](#power-bi-installation)
* [الاستعلام عن البيانات من ClickHouse لتصورها في Power BI Desktop](#query-and-visualise-data)
* [إعداد بوابة بيانات محلية لـ خدمة Power BI](#power-bi-service)

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

<div id="power-bi-installation">
  ### تثبيت Power BI
</div>

يفترض هذا الدليل العملي أن Microsoft Power BI Desktop مُثبّت على جهازك الذي يعمل بنظام Windows. يمكنك تنزيل Power BI Desktop وتثبيته من [هنا](https://www.microsoft.com/en-us/download/details.aspx?id=58494)

نوصي بالتحديث إلى أحدث إصدار من Power BI. يتوفر موصل ClickHouse افتراضيًا ابتداءً من الإصدار `2.137.751.0`.

<div id="gather-your-clickhouse-connection-details">
  ### اجمع تفاصيل اتصال ClickHouse
</div>

ستحتاج إلى التفاصيل التالية للاتصال بمثيل ClickHouse الخاص بك:

* اسم المضيف - ClickHouse
* اسم المستخدم - بيانات اعتماد المستخدم
* كلمة المرور - كلمة مرور المستخدم
* قاعدة البيانات - اسم قاعدة البيانات في المثيل الذي تريد الاتصال به

<div id="power-bi-desktop">
  ## Power BI Desktop
</div>

للبدء في الاستعلام عن البيانات في Power BI Desktop، ستحتاج إلى إكمال الخطوات التالية:

1. ثبّت ClickHouse ODBC Driver
2. ابحث عن ClickHouse Connector
3. اتصل بـ ClickHouse
4. استعلم عن بياناتك وأنشئ تصورات مرئية لها

<div id="install-the-odbc-driver">
  ### تثبيت برنامج تشغيل ODBC
</div>

نزّل أحدث [إصدار من ClickHouse ODBC](https://github.com/ClickHouse/clickhouse-odbc/releases).

شغّل مُثبّت `.msi` المرفق واتبع معالج التثبيت.

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/svLCKm9RWi4jibqG/images/integrations/data-visualization/powerbi_odbc_install.webp?fit=max&auto=format&n=svLCKm9RWi4jibqG&q=85&s=bb5b217cc0f72cfb3efa0ab67bc091f9" alt="معالج تثبيت برنامج تشغيل ClickHouse ODBC يعرض خيارات التثبيت" border width="676" height="514" data-path="images/integrations/data-visualization/powerbi_odbc_install.webp" />

<br />

<Note>
  تُعد `Debug symbols` اختيارية وليست مطلوبة
</Note>

<div id="verify-odbc-driver">
  #### التحقق من برنامج تشغيل ODBC
</div>

بعد اكتمال تثبيت برنامج التشغيل، يمكنك التحقق من نجاح التثبيت من خلال ما يلي:

ابحث عن ODBC في قائمة Start، ثم اختر "ODBC Data Sources **(64-bit)**".

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/svLCKm9RWi4jibqG/images/integrations/data-visualization/powerbi_odbc_search.webp?fit=max&auto=format&n=svLCKm9RWi4jibqG&q=85&s=f60cfc405ca82d22b0e4e72365d3f686" alt="بحث Windows يُظهر خيار ODBC Data Sources (64-bit)" border width="826" height="676" data-path="images/integrations/data-visualization/powerbi_odbc_search.webp" />

<br />

تأكد من أن ClickHouse Driver مدرج في القائمة.

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/svLCKm9RWi4jibqG/images/integrations/data-visualization/powerbi_odbc_verify.webp?fit=max&auto=format&n=svLCKm9RWi4jibqG&q=85&s=667bdce7ea7d674b710ce36105388190" alt="تعرض ODBC Data Source Administrator برامج تشغيل ClickHouse في علامة التبويب Drivers" border width="1168" height="842" data-path="images/integrations/data-visualization/powerbi_odbc_verify.webp" />

<br />

<div id="find-the-clickhouse-connector">
  ### العثور على موصل ClickHouse
</div>

<Note>
  متاح في الإصدار `2.137.751.0` من Power BI Desktop
</Note>

في شاشة البدء في Power BI Desktop، انقر على "Get Data".

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/svLCKm9RWi4jibqG/images/integrations/data-visualization/powerbi_get_data.webp?fit=max&auto=format&n=svLCKm9RWi4jibqG&q=85&s=b44629c65c82c46728c4d2a1d7d2b726" alt="شاشة البدء في Power BI Desktop تعرض زر Get Data" border width="1916" height="968" data-path="images/integrations/data-visualization/powerbi_get_data.webp" />

<br />

ابحث عن "ClickHouse"

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/svLCKm9RWi4jibqG/images/integrations/data-visualization/powerbi_search_clickhouse.webp?fit=max&auto=format&n=svLCKm9RWi4jibqG&q=85&s=9e1730ed423dfde3ce9844ed56174490" alt="مربع الحوار Get Data في Power BI مع البحث عن ClickHouse في شريط البحث" border width="680" height="661" data-path="images/integrations/data-visualization/powerbi_search_clickhouse.webp" />

<br />

<div id="connect-to-clickhouse">
  ### الاتصال بـ ClickHouse
</div>

حدّد الموصل، ثم أدخل بيانات اعتماد مثيل ClickHouse:

* Host (مطلوب) - نطاق/عنوان المثيل. تأكد من إدخاله من دون أي بادئات/لاحقات.
* Port (مطلوب) - منفذ المثيل.
* Database - اسم قاعدة البيانات.
* Options - أي خيار ODBC كما هو مذكور
  في [ClickHouse ODBC GitHub Page](https://github.com/ClickHouse/clickhouse-odbc#configuration)
* وضع اتصال البيانات - DirectQuery

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/svLCKm9RWi4jibqG/images/integrations/data-visualization/powerbi_connect_db.webp?fit=max&auto=format&n=svLCKm9RWi4jibqG&q=85&s=69f639996bf6e0657dda9ecef24e45cd" alt="مربع حوار اتصال ClickHouse يعرض حقول المضيف والمنفذ وقاعدة البيانات ووضع الاتصال" border width="694" height="364" data-path="images/integrations/data-visualization/powerbi_connect_db.webp" />

<br />

<Note>
  ننصح باختيار DirectQuery للاستعلام عن ClickHouse مباشرةً.

  إذا كانت لديك حالة استخدام تتضمن كمية صغيرة من البيانات، يمكنك اختيار وضع الاستيراد، وسيتم تحميل البيانات بالكامل إلى Power BI.
</Note>

* حدّد اسم المستخدم وكلمة المرور

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/svLCKm9RWi4jibqG/images/integrations/data-visualization/powerbi_connect_user.webp?fit=max&auto=format&n=svLCKm9RWi4jibqG&q=85&s=54dbf636166c904735a663e477812894" alt="مربع حوار بيانات اعتماد اتصال ClickHouse لاسم المستخدم وكلمة المرور" border width="700" height="276" data-path="images/integrations/data-visualization/powerbi_connect_user.webp" />

<br />

<div id="query-and-visualise-data">
  ### الاستعلام عن البيانات وتصورها
</div>

أخيرًا، ينبغي أن تظهر لك قواعد البيانات والجداول في عرض Navigator. حدّد الجدول المطلوب وانقر على "Load" لكي
تستورد البيانات من ClickHouse.

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/svLCKm9RWi4jibqG/images/integrations/data-visualization/powerbi_table_navigation.webp?fit=max&auto=format&n=svLCKm9RWi4jibqG&q=85&s=20550f1a5539ba249e79c65ee49c0f55" alt="عرض Navigator في Power BI يُظهر جداول قاعدة بيانات ClickHouse وبيانات عيّنة" border width="873" height="691" data-path="images/integrations/data-visualization/powerbi_table_navigation.webp" />

<br />

بمجرد اكتمال الاستيراد، ستكون بيانات ClickHouse متاحة في Power BI كالمعتاد.

<br />

<div id="power-bi-service">
  ## خدمة Power BI
</div>

لاستخدام خدمة Microsoft Power BI، تحتاج إلى إنشاء [بوابة بيانات محلية](https://learn.microsoft.com/en-us/power-bi/connect-data/service-gateway-onprem).

لمزيد من التفاصيل حول كيفية إعداد Custom Connectors، يُرجى الرجوع إلى وثائق Microsoft لمعرفة كيفية [استخدام موصلات بيانات مخصصة مع بوابة بيانات محلية](https://learn.microsoft.com/en-us/power-bi/connect-data/service-gateway-custom-connectors).

<div id="odbc-driver-import-only">
  ## برنامج تشغيل ODBC (للاستيراد فقط)
</div>

نوصي باستخدام موصل ClickHouse الذي يعتمد على DirectQuery.

ثبّت [برنامج تشغيل ODBC](#install-the-odbc-driver) على مثيل بوابة البيانات المحلية، ثم [تحقّق منه](#verify-odbc-driver) كما هو موضّح أعلاه.

<div id="create-a-new-user-dsn">
  ### أنشئ User DSN جديدًا
</div>

عند اكتمال تثبيت برنامج التشغيل، يمكنك إنشاء مصدر بيانات ODBC. ابحث عن ODBC في قائمة Start وحدد "ODBC Data Sources (64-bit)".

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/svLCKm9RWi4jibqG/images/integrations/data-visualization/powerbi_odbc_search.webp?fit=max&auto=format&n=svLCKm9RWi4jibqG&q=85&s=f60cfc405ca82d22b0e4e72365d3f686" alt="بحث Windows يُظهر خيار ODBC Data Sources (64-bit)" border width="826" height="676" data-path="images/integrations/data-visualization/powerbi_odbc_search.webp" />

<br />

نحتاج هنا إلى إضافة User DSN جديد. انقر على زر "Add" الموجود على اليسار.

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/svLCKm9RWi4jibqG/images/integrations/data-visualization/powerbi_add_dsn.webp?fit=max&auto=format&n=svLCKm9RWi4jibqG&q=85&s=05a20f28cc3d7377eea80de3ef9477cc" alt="ODBC Data Source Administrator مع تمييز زر Add لإنشاء DSN جديد" border width="585" height="420" data-path="images/integrations/data-visualization/powerbi_add_dsn.webp" />

<br />

اختر إصدار Unicode من برنامج تشغيل ODBC.

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/svLCKm9RWi4jibqG/images/integrations/data-visualization/powerbi_select_unicode.webp?fit=max&auto=format&n=svLCKm9RWi4jibqG&q=85&s=15161c77369c7331426209d92f01d41f" alt="مربع حوار Create New Data Source يُظهر تحديد ClickHouse Unicode Driver" border width="458" height="353" data-path="images/integrations/data-visualization/powerbi_select_unicode.webp" />

<br />

أدخل تفاصيل الاتصال.

<Image size="sm" img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/svLCKm9RWi4jibqG/images/integrations/data-visualization/powerbi_connection_details.webp?fit=max&auto=format&n=svLCKm9RWi4jibqG&q=85&s=2f84a4dc9dd1bfbd12eeeb5a37c26318" alt="مربع حوار تهيئة ClickHouse ODBC Driver مع معلمات الاتصال" border width="288" height="441" data-path="images/integrations/data-visualization/powerbi_connection_details.webp" />

<br />

<Note>
  إذا كنت تستخدم عملية نشر مفعّلًا فيها SSL (مثل ClickHouse Cloud أو مثيل مُدار ذاتيًا)، فيجب إدخال `require` في حقل `SSLMode`.

  * يجب أن تكون قيمة `Host` دائمًا من دون البروتوكول (أي احذف `http://` أو `https://`).
  * `Timeout` عدد صحيح يمثّل الثواني. القيمة الافتراضية: `30 seconds`.
</Note>

<div id="get-data-into-power-bi">
  ### استيراد البيانات إلى Power BI
</div>

إذا لم يكن Power BI مثبتًا لديك
بعد، [فنزل وثبّت Power BI Desktop](https://www.microsoft.com/en-us/download/details.aspx?id=58494).

في شاشة البدء في Power BI Desktop، انقر على "Get Data".

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/svLCKm9RWi4jibqG/images/integrations/data-visualization/powerbi_get_data.webp?fit=max&auto=format&n=svLCKm9RWi4jibqG&q=85&s=b44629c65c82c46728c4d2a1d7d2b726" alt="شاشة الصفحة الرئيسية في Power BI Desktop تعرض زر Get Data" border width="1916" height="968" data-path="images/integrations/data-visualization/powerbi_get_data.webp" />

<br />

اختر "Other" -> "ODBC".

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/svLCKm9RWi4jibqG/images/integrations/data-visualization/powerbi_select_odbc.webp?fit=max&auto=format&n=svLCKm9RWi4jibqG&q=85&s=feea92ddf39006c1f4e3462753d6d20c" alt="مربع حوار Get Data في Power BI مع تحديد خيار ODBC ضمن فئة Other" border width="590" height="648" data-path="images/integrations/data-visualization/powerbi_select_odbc.webp" />

<br />

اختر مصدر البيانات الذي أنشأته سابقًا من القائمة.

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/svLCKm9RWi4jibqG/images/integrations/data-visualization/powerbi_select_dsn.webp?fit=max&auto=format&n=svLCKm9RWi4jibqG&q=85&s=c1afeb52503023dec44ed975eb178aa1" alt="مربع حوار اختيار برنامج تشغيل ODBC يعرض ClickHouse DSN الذي تم إعداده" border width="697" height="216" data-path="images/integrations/data-visualization/powerbi_select_dsn.webp" />

<br />

<Note>
  إذا لم تحدد بيانات الاعتماد أثناء إنشاء مصدر البيانات، فسيُطلب منك إدخال اسم المستخدم وكلمة المرور.
</Note>

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/svLCKm9RWi4jibqG/images/integrations/data-visualization/powerbi_dsn_credentials.webp?fit=max&auto=format&n=svLCKm9RWi4jibqG&q=85&s=7c2ebdc5e8441109be722803bdd7d98d" alt="مربع حوار بيانات الاعتماد لاتصال ODBC DSN" border width="697" height="342" data-path="images/integrations/data-visualization/powerbi_dsn_credentials.webp" />

<br />

أخيرًا، ينبغي أن تظهر لك قواعد البيانات والجداول في عرض Navigator. اختر الجدول المطلوب وانقر على "Load" لاستيراد البيانات من ClickHouse.

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/svLCKm9RWi4jibqG/images/integrations/data-visualization/powerbi_table_navigation.webp?fit=max&auto=format&n=svLCKm9RWi4jibqG&q=85&s=20550f1a5539ba249e79c65ee49c0f55" alt="عرض Navigator في Power BI يعرض جداول قاعدة بيانات ClickHouse وبيانات sample" border width="873" height="691" data-path="images/integrations/data-visualization/powerbi_table_navigation.webp" />

<br />

بمجرد اكتمال الاستيراد، ستكون بيانات ClickHouse متاحة في Power BI كالمعتاد.

<div id="optimizing-work-with-large-datasets">
  ## تحسين العمل مع مجموعات البيانات الكبيرة
</div>

صُمم PowerBI لقواعد البيانات التقليدية القائمة على الصفوف ذات أحجام البيانات المتوسطة. وعند العمل مع ClickHouse على نطاق واسع (مليارات الصفوف)، يلزم اتباع أنماط معمارية محددة لتحقيق أفضل أداء.

ينشئ PowerBI تلقائيًا استعلامات SQL تتضمن استعلامات فرعية متداخلة، وعمليات join معقدة، وتحويلات تُنفَّذ آنيًا. تنجح هذه الأنماط مع قواعد بيانات SQL التقليدية، لكنها قد تكون غير فعّالة عند الاستعلام عن قواعد بيانات عمودية واسعة النطاق مثل ClickHouse.

**النهج الموصى به لمجموعات البيانات الكبيرة:** بدلًا من الاستعلام عن الجداول الخام مباشرةً، أنشئ `materialized views` مخصصة في ClickHouse لكل تصور في لوحة المعلومات. يوفّر لك ذلك:

* أداءً سريعًا ومتسقًا بغض النظر عن حجم البيانات
* حملاً أقل على عنقود ClickHouse لديك
* تكاليف أكثر قابلية للتنبؤ

<Warning>
  إذا كانت لوحات المعلومات لديك بطيئة، فتحقّق من [`query_log`](/ar/reference/system-tables/query_log) في ClickHouse لمعرفة استعلامات SQL التي يشغّلها Power BI فعليًا. من المشكلات الشائعة: الاستعلامات الفرعية المتداخلة، أو فحص جداول كاملة، أو عمليات join غير فعّالة. وبعد تحديد المشكلة، أنشئ [عروض مادية](/ar/concepts/features/materialized-views/index) تعالج تلك المشكلات المحددة.
</Warning>

<div id="implementation-best-practices">
  ### أفضل الممارسات للتنفيذ
</div>

<div id="pre-aggregation-strategy">
  #### استراتيجية التجميع المسبق
</div>

أنشئ طرق عرض مادية على عدة مستويات من التجميع:

* تجميعات بالساعة للوحات المعلومات الحديثة والمفصلة
* تجميعات يومية للاتجاهات التاريخية
* تلخيصات شهرية لإعداد التقارير طويلة الأمد
* احتفِظ بالبيانات الخام مع TTL مناسب لإجراء التحليلات عند الحاجة

<div id="data-modelling-optimization">
  #### تحسين نمذجة البيانات
</div>

* حدِّد مفاتيح `ORDER BY` بما يتوافق مع أنماط الاستعلام
* استخدم التقسيم مع بيانات السلاسل الزمنية
* حوِّل جداول الأبعاد الصغيرة إلى قواميس لتسريع عمليات البحث
* استفد من الإسقاطات لتحسين الاستعلامات بشكل إضافي

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

<div id="uint64">
  ### UInt64
</div>

لن تُحمَّل أنواع الأعداد الصحيحة غير الموقَّعة مثل UInt64 أو الأنواع الأكبر تلقائيًا إلى مجموعة البيانات، لأن Int64 هو أكبر نوع من الأعداد الصحيحة يدعمه Power BI.

<Note>
  لاستيراد البيانات بشكل صحيح، قبل الضغط على زر "Load" في Navigator، انقر أولاً على "Transform Data".
</Note>

في هذا المثال، يحتوي جدول `pageviews` على عمود من نوع UInt64، ويُتعرَّف عليه افتراضيًا على أنه "Binary".
يفتح "Transform Data" محرر Power Query، حيث يمكننا إعادة تعيين نوع العمود وضبطه ليكون، على سبيل المثال،
Text.

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/svLCKm9RWi4jibqG/images/integrations/data-visualization/powerbi_16.webp?fit=max&auto=format&n=svLCKm9RWi4jibqG&q=85&s=ffc495fc71bc4ac22ad1a3ede913d172" alt="محرر Power Query يعرض تحويل نوع البيانات لعمود UInt64" border width="1203" height="863" data-path="images/integrations/data-visualization/powerbi_16.webp" />

<br />

بعد الانتهاء، انقر على "Close & Apply" في الزاوية العلوية اليسرى، ثم تابع تحميل البيانات.