توصيل Power BI ب Azure Databricks

Microsoft Power BI هي خدمة تحليلات الأعمال التي توفر مرئيات تفاعلية مع قدرات المعلومات المهنية ذاتية الخدمة، ما يمكن المستخدمين النهائيين من إنشاء التقارير ولوحات المعلومات بأنفسهم دون الحاجة إلى الاعتماد على موظفي تكنولوجيا المعلومات أو مسؤولي قاعدة البيانات.

عند استخدام Azure Databricks كمصدر بيانات مع Power BI، يمكنك جلب مزايا أداء وتكنولوجيا Azure Databricks بخلاف علماء البيانات ومهندسي البيانات لجميع مستخدمي الأعمال.

النشر إلى Power BI Online من Azure Databricks

عند استخدام Azure Databricks كمصدر بيانات مع Power BI Online، يمكنك إنشاء مجموعات بيانات Power BI من الجداول أو المخططات مباشرة من واجهة مستخدم Databricks.

المتطلبات

• يجب أن تكون بياناتك في كتالوج Unity، ويجب تمكين الحوسبة (نظام المجموعة) كتالوج Unity. Hive metastore غير مدعوم حاليا.

• يجب أن يكون لديك ترخيص Power BI متميز (سعة متميزة أو ترخيص متميز لكل مستخدم).

• يجب منح الأذونات التالية لتطبيق معرف Entra المسجل الذي تستخدمه للنشر من Databricks إلى Power BI:

  • Content.Create
  • Dataset.ReadWrite.All
  • Workspace.ReadWrite.All
  • Report.ReadWrite.All

  لمزيد من المعلومات، راجع أذونات Microsoft Entra.

  إشعار

  عادة ما تكون موافقة مسؤول الإدخال مطلوبة لهذه الأذونات، خاصة لمساحة العمل والوصول على مستوى مجموعة البيانات في Power BI. راجع مراجعة طلبات موافقة المسؤول للحصول على الإرشادات.

• في إعدادات مساحة عمل Power BI، يجب تمكين المستخدمين من تحرير نماذج البيانات في خدمة Power BI (معاينة) لتحرير النموذج الدلالي بعد نشره. يمكنك أيضا تحرير النموذج الدلالي باستخدام Tabular Editor عن طريق إجراء اتصال باستخدام نقطة نهاية XMLA.

• إذا كنت بحاجة إلى تمكين كتابة XML في مساحة عمل Power BI، فاتبع هذا الارتباط للحصول على الإرشادات.

• إذا كانت مساحة عمل Power BI تستخدم ارتباطا خاصا، فيجب تحديث بيانات اعتماد مصدر بيانات مجموعة البيانات يدويا في Power BI.

نشر جداول Azure Databricks إلى مجموعة بيانات Power BI

1. سجل الدخول إلى مساحة عمل Databricks وانقر فوق كتالوج في الشريط الجانبي لفتح مستكشف الكتالوج.

2. حدد مورد حساب من القائمة المنسدلة في أعلى اليمين.

3. افتح كتالوج وحدد المخطط أو الجداول التي سيتم نشرها. لا تحدد من مخزن بيانات تعريف الخلية أو كتالوج العينات.

4. في أعلى اليمين، انقر فوق استخدام مع أدوات المعلومات المهنية لمخطط أو فتح في لوحة معلومات لجدول.

5. حدد Publish to Power BI workspace.

6. في مربع الحوار الاتصال بالشريك ، انقر فوق الاتصال بمعرف Microsoft Entra للمصادقة.

7. في مساحات عمل Power BI، حدد مساحة عمل Power BI.

8. في وضع مجموعة البيانات، حدد إما DirectQuery أو Import.

9. في أسلوب المصادقة في Power BI، حدد OAuth أو PAT (رمز الوصول الشخصي) .

   توصي Databricks باستخدام OAuth لأنها تسمح بالتحكم الدقيق في الوصول والتدقيق على مستوى المستخدم. قد تحتاج بيانات اعتماد OAuth إلى تكوينها في صفحة إعدادات مجموعة بيانات Power BI ضمن بيانات اعتماد مصدر البيانات. إذا حددت رمز الوصول الشخصي (PAT)، يتم إنشاء PAT نيابة عنك للسماح ل Power BI بالوصول إلى النموذج الدلالي.

10. في اسم مجموعة البيانات، حدد نشر كمجموعة بيانات جديدة أو استخدام مجموعة بيانات موجودة.

11. انقر فوق نشر إلى Power BI.

12. في غضون 10 إلى 20 ثانية عند نشر مجموعة البيانات، انقر فوق فتح Power BI لفتح مجموعة بيانات Power BI في علامة تبويب جديدة.

الميزات والملاحظات

• عند نشر مخطط يحتوي على جداول متعددة، يتم نشر جميع الجداول التي تحتوي على أعمدة. لا يتم نشر الجداول التي لا تحتوي على أعمدة.
• يتم نسخ التعليقات على أعمدة الجدول في Azure Databricks إلى أوصاف الأعمدة المقابلة في Power BI.
• يتم الاحتفاظ بعلاقات المفاتيح الخارجية في مجموعة البيانات المنشورة. ومع ذلك، يدعم Power BI مسار علاقة نشط واحد فقط بين أي جدولين. عند وجود مسارات متعددة في المخطط في Azure Databricks، يتم تعيين بعض العلاقات المقابلة في Power BI إلى غير نشطة. يمكنك لاحقا تغيير العلاقات النشطة أو غير النشطة في طريقة عرض نموذج البيانات في Power BI.
• عند استخدام OAuth أو بوابة بيانات محلية، قد تحتاج بيانات الاعتماد إلى تكوين ضمن "بيانات اعتماد مصدر البيانات" في صفحة إعدادات مجموعة بيانات Power BI.

استكشاف الأخطاء وإصلاحها

خطأ	ملاحظات
"الموافقة مطلوبة" عند تشغيل النشر إلى Power BI للمرة الأولى	إذا رأيت هذه الرسالة، فستحتاج إلى موافقة مسؤول Entra قبل أن تتمكن من منح أذونات لميزة التكامل هذه. اتصل بمسؤول Entra للموافقة على الطلب. اتبع هذا الارتباط للحصول على الإرشادات.
PowerBINotLicensedException	تأكد من أن لديك ترخيص Power BI Premium.
تعذر علينا نشر مجموعة البيانات هذه. اتصل بمسؤول السعة للتأكد من تمكين دعم قراءة/كتابة XMLA في إعدادات السعة على سعة Power BI Premium، ثم حاول مرة أخرى. للحصول على معلومات إضافية، راجع "دعم قراءة/كتابة XMLA" في وثائق المنتج.	اتصل بمسؤول سعة Power BI لتمكين قدرات القراءة والكتابة ضمن نقطة نهاية XMLA في إعدادات السعة. اتبع هذا الارتباط للحصول على الإرشادات.
تم تعطيل ميزة نقطة نهاية XMLA. قم بتشغيل تحليل في ميزة Excel في PowerBI.com لتمكين هذه الميزة.	اتصل بمسؤول سعة Power BI لتمكين قدرات القراءة والكتابة ضمن نقطة نهاية XMLA في إعدادات السعة. اتبع هذا الارتباط للحصول على الإرشادات.
CapacityNotActive	قد يتم إيقاف السعة مؤقتا. اتصل بمسؤول السعة للتحقق من حالة السعة.
قاعدة البيانات التي تحمل اسم '<ccon>***</ccon>' موجودة بالفعل في '<ccon>مساحة </ccon>العمل ' ***.	تأكد من أن لديك الأذونات لإنشاء نموذج دلالي. ثم أعد محاولة النشر إلى Power BI لنشر النموذج الدلالي برقم إصدار متزايد.
لا يمكنك استخدام وضع Direct Lake مع أوضاع التخزين الأخرى في نفس النموذج. لا يدعم النموذج المركب وضع Direct Lake. قم بإزالة الجداول غير المدعومة أو قم بتبديلها إلى وضع Direct Lake.	نظرا لأن Publish to Power BI ينشئ نموذجا دلاليا مع وضع Import أو DirectQuery، فلا يمكن استخدامه للنشر إلى مجموعة بيانات موجودة تستخدم وضع Direct Lake. اتبع هذا الارتباط لمعرفة المزيد.
لا يملك المستخدم "<euii>* </euii>" الإذن لاستدعاء أسلوب الاكتشاف.	تأكد من أنك تقوم بالنشر إلى مساحة عمل Power BI باستخدام وضع ترخيص Premium. لا يمكنك النشر إلى مساحة عمل باستخدام وضع ترخيص Pro.
إما أن المستخدم '<euii> </euii>' ليس لديه الإذن لإنشاء كائن جديد في '**'، أو أن الكائن غير موجود.	قد يكون لديك دور العارض في مساحة عمل Power BI. تحقق مما إذا كان لديك الأذونات لإنشاء نموذج دلالي. اتبع هذا الارتباط للحصول على مزيد من المعلومات.
"فشل تحديث بيانات اعتماد مصدر البيانات: [Microsoft][ThriftExtension] (14) استجابة غير متوقعة من الخادم أثناء اتصال HTTP: تم إرجاع استجابة الخطأ غير المصرح به/المحظورة، ولكن لم يتم تلقي رسالة منتهية الصلاحية للرمز المميز." عند تحرير بيانات اعتماد مصدر البيانات على Power BI	تحقق مما إذا كانت مساحة عمل Databricks الخاصة بك يمكن الوصول إليها بشكل عام. إذا كانت مساحة العمل الخاصة بك تستخدم Private Link أو قوائم الوصول إلى IP، فقد تحتاج إلى تكوين بوابة Power BI المحلية.

توصيل Power BI Desktop ب Azure Databricks

يمكنك توصيل Power BI Desktop بمجموعة Azure Databricks ومستودعات Databricks SQL. يمكنك أيضا نشر تقارير Power BI إلى خدمة Power BI وتمكين المستخدمين من الوصول إلى بيانات Azure Databricks الأساسية باستخدام تسجيل الدخول الأحادي (SSO)، وتمرير بيانات اعتماد معرف Microsoft Entra نفسها التي يستخدمونها للوصول إلى التقرير.

المتطلبات

• Power BI Desktop 2.85.681.0 أو أعلى. لاستخدام البيانات التي يديرها كتالوج Unity مع Power BI، يجب استخدام Power BI Desktop 2.98.683.0 أو أعلى (إصدار أكتوبر 2021).

  إشعار

  يتطلب Power BI Desktop Windows. البديل لأنظمة التشغيل الأخرى هو تشغيل Power BI Desktop على مضيف فعلي أو جهاز ظاهري مستند إلى Windows ثم الاتصال به من نظام التشغيل الخاص بك.

  إذا كنت تستخدم إصدارا من Power BI Desktop أقل من 2.85.681.0، فستحتاج أيضا إلى تثبيت برنامج تشغيل Databricks ODBC في نفس البيئة مثل Power BI Desktop.

• رمز مميز للوصول الشخصي إلى Azure Databricks أو بيانات اعتماد حساب معرف Microsoft Entra.

  إشعار

  كأفضل ممارسة أمان عند المصادقة باستخدام رموز الوصول الشخصية، توصي Databricks باستخدام رموز الوصول الشخصية التي تنتمي إلى كيانات الخدمة بدلا من مستخدمي مساحة العمل. لإنشاء رموز مميزة لكيانات الخدمة، راجع إدارة الرموز المميزة لكيان الخدمة.

• مجموعة Azure Databricks أو مستودع Databricks SQL.

توصيل Power BI Desktop ب Azure Databricks باستخدام Partner Connect

يمكنك استخدام Partner Connect للاتصال بمجموعة أو مستودع SQL من Power BI Desktop ببضع نقرات فقط.

1. تأكد من أن حساب Azure Databricks ومساحة العمل والمستخدم الذي سجل الدخول يفي بمتطلبات Partner Connect.

2. في الشريط الجانبي، انقر فوق Partner Connect.

3. انقر فوق لوحة Power BI.

4. في مربع الحوار الاتصال بالشريك، للحوسبة، اختر اسم مورد حساب Azure Databricks الذي تريد توصيله.

5. اختر تنزيل ملف الاتصال.

6. افتح ملف الاتصال الذي تم تنزيله، والذي يبدأ تشغيل Power BI Desktop.

7. في Power BI Desktop، أدخل بيانات اعتماد المصادقة:

   • رمز الوصول الشخصي: أدخل رمز الوصول الشخصي الخاص بك في Azure Databricks.
   • معرف Microsoft Entra: انقر فوق تسجيل الدخول ثم اتبع الإرشادات التي تظهر على الشاشة.
   • اسم المستخدم / كلمة المرور: غير قابل للتطبيق.

8. انقر على اتصال.

9. حدد بيانات Azure Databricks للاستعلام من Power BI Navigator.

   

توصيل Power BI Desktop ب Azure Databricks يدويا

اتبع هذه الإرشادات، اعتمادا على أسلوب المصادقة الذي اخترته، للاتصال بمجموعة أو مستودع SQL باستخدام Power BI Desktop. يوصى باستخدام مستودعات Databricks SQL عند استخدام Power BI في وضع DirectQuery .

إشعار

للاتصال بشكل أسرع باستخدام Power BI Desktop، استخدم Partner Connect.

1. احصل على اسم مضيف الخادم ومسار HTTP.

2. ابدأ Power BI Desktop.

3. انقر فوق الحصول على البيانات أو الحصول على بيانات الملف>.

4. انقر فوق الحصول على البيانات للبدء.

5. ابحث عن Databricks، ثم انقر فوق الموصل:

   • Azure Databricks

6. انقر على اتصال.

7. أدخل اسم مضيف الخادم ومسار HTTP.

8. حدد وضع اتصال البيانات. للحصول على معلومات حول الفرق بين الاستيراد و DirectQuery، راجع استخدام DirectQuery في Power BI Desktop.

9. وانقر فوق موافق.

10. انقر فوق أسلوب المصادقة:

    • رمز الوصول الشخصي: أدخل رمز الوصول الشخصي الخاص بك في Azure Databricks.
    • معرف Microsoft Entra: انقر فوق تسجيل الدخول ثم اتبع الإرشادات التي تظهر على الشاشة.
    • اسم المستخدم / كلمة المرور: غير قابل للتطبيق.

11. انقر على اتصال.

12. حدد بيانات Azure Databricks للاستعلام من Power BI Navigator. إذا تم تمكين كتالوج Unity لمساحة العمل الخاصة بك، فحدد كتالوج قبل تحديد مخطط وجدول.

    

استخدام استعلام SQL مخصص

يوفر Databricks.Query موصل Databricks مصدر البيانات الذي يسمح للمستخدم بتوفير استعلام SQL مخصص.

1. اتبع الخطوات الموضحة في الاتصال ب Power BI Desktop لإنشاء اتصال، باستخدام Import كوضع اتصال البيانات.

2. في المتصفح، انقر بزر الماوس الأيمن فوق العنصر الأعلى الذي يحتوي على اسم المضيف المحدد ومسار HTTP وانقر فوق تحويل البيانات لفتح محرر Power Query.

   

3. في شريط الدالة، استبدل اسم Databricks.Catalogs الدالة بالتغيير Databricks.Query وطبقه. يؤدي هذا إلى إنشاء دالة Power Query التي تأخذ استعلام SQL كمعلمة.

4. أدخل استعلام SQL في حقل المعلمة وانقر فوق Invoke. يؤدي ذلك إلى تنفيذ الاستعلام وإنشاء جدول جديد مع نتائج الاستعلام كمحتوياته.

الوصول إلى مصدر بيانات Azure Databricks باستخدام خدمة Power BI

عند نشر تقرير إلى خدمة Power BI، يمكنك الاتصال ب Azure Databricks باستخدام رمز وصول شخصي. في خدمة Power BI، يمكنك أيضا تمكين تسجيل الدخول الأحادي (SSO) بحيث يمكن للمستخدمين الوصول إلى التقارير التي تم إنشاؤها باستخدام وضع تخزين DirectQuery عن طريق تمرير بيانات اعتماد معرف Microsoft Entra إلى Azure Databricks.

1. انشر تقرير Power BI من Power BI Desktop إلى خدمة Power BI.

2. تمكين وصول تسجيل الدخول الأحادي (SSO) إلى التقرير ومصدر البيانات الأساسي.

   1. انتقل إلى مجموعة بيانات Azure Databricks الأساسية للتقرير في خدمة Power BI، وقم بتوسيع بيانات اعتماد مصدر البيانات، وانقر فوق تحرير بيانات الاعتماد.
   2. في مربع حوار التكوين، حدد يمكن لمشاهدي التقرير الوصول إلى مصدر البيانات هذا فقط باستخدام هويات Power BI الخاصة بهم باستخدام الاستعلام المباشر وانقر فوق تسجيل الدخول.

   

   مع تحديد هذا الخيار، تتم معالجة الوصول إلى مصدر البيانات باستخدام DirectQuery وإدارته باستخدام هوية معرف Microsoft Entra للمستخدم الذي يصل إلى التقرير. إذا لم تحدد هذا الخيار، يمكنك أنت فقط، كمستخدم نشر التقرير، الوصول إلى مصدر بيانات Azure Databricks.

الكشف التلقائي عن وكيل HTTP

يحتوي الإصدار 2.104.941.0 من Power BI Desktop والإصدارات الأحدث (إصدار مايو 2022) على دعم مضمن للكشف عن تكوين وكيل HTTP على مستوى نظام Windows.

يمكن ل Power BI Desktop الكشف عن تكوين وكيل HTTP على مستوى نظام Windows واستخدامه تلقائيا.

إذا لم يوفر الخادم الوكيل نقطة توزيع CRL (CDP)، فقد يعرض Power BI رسالة الخطأ التالية:

Details: "ODBC: ERROR [HY000] [Microsoft][DriverSupport] (1200)
-The revocation status of the certificate or one of the certificates in the certificate chain is unknown."

لإصلاح هذا الخطأ، أكمل الخطوات التالية:

1. إنشاء الملف C:\Program Files\Microsoft Power BI Desktop\bin\ODBC Drivers\Simba Spark ODBC Driver\microsoft.sparkodbc.ini إذا لم يكن موجودا.

2. أضف التكوين التالي إلى ملفك microsoft.sparkodbc.ini :

   [Driver]
   CheckCertRevocation=0
   

موصل Power BI Delta Sharing

يسمح موصل Power BI Delta Sharing للمستخدمين باكتشاف مجموعات البيانات المشتركة معهم وتحليلها وتصورها من خلال بروتوكول مشاركة دلتا المفتوح. يتيح البروتوكول التبادل الآمن لمجموعات البيانات عبر المنتجات والأنظمة الأساسية من خلال الاستفادة من REST والتخزين السحابي.

للحصول على إرشادات الاتصال، راجع Power BI: قراءة البيانات المشتركة.

القيود

• يدعم موصل Azure Databricks وكيل الويب. ومع ذلك، لا يتم دعم إعدادات الوكيل التلقائي المحددة في ملفات .pac.
• في موصل Azure Databricks، Databricks.Query مصدر البيانات غير مدعوم بالاشتراك مع وضع DirectQuery.
• يجب أن تتناسب البيانات التي يقوم موصل Delta Sharing بتحميلها مع ذاكرة جهازك. للتأكد من ذلك، يحدد الموصل عدد الصفوف المستوردة إلى حد الصفوف الذي تم تعيينه مسبقا.

الموارد الإضافية

الدعم