مشاركة عبر

تصحيح أخطاء دفاتر الملاحظات

  • مقالة

هام

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

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

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

المتطلبات

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

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

استخدم الخطوات التالية لتمكين مصحح الأخطاء، :

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

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

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

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

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

  2. ابدأ جلسة تصحيح الأخطاء باستخدام أحد الخيارات التالية:

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

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

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

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

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

إجراءات تصحيح الأخطاء

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

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

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

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

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

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

تصحيح أخطاء وحدة التحكم

عند بدء جلسة تصحيح الأخطاء، تظهر وحدة تحكم التصحيح تلقائيا في اللوحة السفلية. تسمح لك وحدة التحكم هذه بتنفيذ تعليمة Python البرمجية لفحص المتغيرات أو معالجتها عند إيقافها مؤقتا عند نقطة توقف. لا يتم تشغيل التعليمات البرمجية المنفذة في دفتر الملاحظات الرئيسي أثناء جلسة تصحيح الأخطاء. لتشغيل التعليمات البرمجية في وحدة التحكم، اضغط على مفتاح الإدخال Enter. بالنسبة للتعبيرات متعددة الأسطر، استخدم Shift + Enter للانتقال إلى سطر جديد.

debug_console

إشعار

  • تم تصميم وحدة تحكم تتبع الأخطاء للتقييمات السريعة وانتهاء المهلة إذا تجاوز تنفيذ التعليمات البرمجية 15 ثانية.
  • display الأمر غير معتمد في وحدة تحكم تتبع الأخطاء. لعرض نموذج البيانات من DataFrame، استخدم df.show() ل PySpark DataFrames أو df.head() ل Pandas DataFrames.

مستكشف متغير

يمكنك استخدام لوحة أيقونة مستكشف المتغيرات مستكشف المتغيرات على الجانب الأيمن لعرض قيم المتغيرات الخاصة بك. يؤدي النقر فوق فحص إلى تنفيذ التعليمات البرمجية تلقائيا في وحدة تحكم التصحيح لإخراج قيمة المتغير الخاص بك.

مثال على لوحة مستكشف المتغيرات

لتصفية جهاز العرض، أدخل النص في مربع البحث. تتم تصفية القائمة تلقائيا أثناء الكتابة.

بالنسبة إلى Python على Databricks Runtime 12.2 LTS وما فوق، يتم تحديث المتغيرات أثناء تشغيل الخلية. بالنسبة إلى Scala وR وPython على Databricks Runtime 11.3 LTS والإصدارات أدناه، يتم تحديث المتغيرات بعد انتهاء تشغيل الخلية.

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

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

تتبع الأخطاء باستخدام مساعد Databricks

مساعد Databricks هو مساعد الذكاء الاصطناعي مدرك للسياق يمكنه مساعدتك في تصحيح التعليمات البرمجية الخاصة بك. راجع استخدام مساعد Databricks في خلية دفتر ملاحظات للحصول على مزيد من المعلومات.

القيود

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