مشاركة عبر

استخدام مصحح الأخطاء التفاعلي Databricks

  • مقالة

هام

هذه الميزة في المعاينة العامة.

توضح هذه الصفحة كيفية استخدام مصحح الأخطاء التفاعلي المضمن في دفتر ملاحظات Databricks. يتوفر مصحح الأخطاء ل Python فقط.

يوفر مصحح الأخطاء التفاعلي نقاط توقف وتنفيذا خطوة بخطوة وفحصا متغيرا والمزيد من الأدوات لمساعدتك في تطوير التعليمات البرمجية في دفاتر الملاحظات بشكل أكثر كفاءة.

المتطلبات

يجب إرفاق دفتر الملاحظات بمجموعة تفي بالمتطلبات التالية:

  • Databricks Runtime الإصدار 13.3 LTS أو أعلى.
  • يجب أن يكون وضع الوصول مستخدما واحدا (معينا) أو لا يوجد عزل مشترك.

تمكين مصحح الأخطاء أو تعطيله

لتمكين مصحح الأخطاء أو تعطيله، قم بما يلي:

  1. انقر فوق اسم المستخدم في الزاوية العلوية اليسرى من مساحة العمل وحدد الإعدادات من القائمة المنسدلة.
  2. في الشريط الجانبي Settings ، حدد Developer.
  3. في قسم الميزات التجريبية، قم بتبديل Python Notebook Interactive Debugger.

بدء تشغيل مصحح الأخطاء

لبدء مصحح الأخطاء، اتبع الخطوات التالية:

  1. أضف نقطة توقف واحدة أو أكثر بالنقر فوق هامش خلية. لإزالة نقطة توقف، انقر فوقها مرة أخرى.

    إنشاء فيديو نقاط التوقف وإزالته

  2. قم بأحد الإجراءات التالية:

    • انقر فوق Run > Debug cell.
    • استخدم اختصار لوحة المفاتيح Ctrl + Shift + D.
    • من قائمة تشغيل الخلية، حدد Debug cell.

    تصحيح عنصر الخلية في قائمة تشغيل الخلية

تبدأ جلسة تصحيح الأخطاء تلقائيا وتشغل الخلية المحددة.

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

عندما تكون جلسة تصحيح الأخطاء نشطة، يظهر شريط شريط أدوات تتبع الأخطاء أدوات التصحيح في أعلى الخلية.

استخدام مصحح الأخطاء

شريط أدوات مصحح الأخطاء المشروح

في جلسة تصحيح الأخطاء، يمكنك القيام بما يلي:

  • تعيين نقاط التوقف أو إزالتها.
  • عرض قيم المتغيرات في نقطة توقف.
  • التنقل عبر التعليمات البرمجية.
  • الانتقال إلى دالة أو الخروج منها.

عندما تصل التعليمات البرمجية إلى نقطة توقف، تتوقف قبل تشغيل السطر، وليس بعده.

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

عند التنقل عبر دالة، تظهر متغيرات الدالة المحلية في جزء المتغير، مع وضع علامة [local].

إنهاء جلسة مصحح الأخطاء

لإنهاء جلسة تصحيح الأخطاء، انقر في زر إيقاف مصحح الأخطاء الزاوية العلوية اليمنى من الخلية أو انقر زر إيقاف دفتر الملاحظات في أعلى دفتر الملاحظات.

القيود

راجع القيود المعروفة دفاتر ملاحظات Databricks لمزيد من المعلومات.