استخدام دفتر ملاحظات Databricks ومحرر الملفات

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

يمكنك الاختيار من بين مجموعة مختارة من نسق المحرر. حدد عرض > نسق المحرر وقم بإجراء تحديد من القائمة.

الإكمال التلقائي المخصص

يكمل الإكمال التلقائي مقاطع التعليمات البرمجية تلقائيا أثناء كتابتها. تتضمن الكائنات القابلة للإكمال الأنواع والفئات والعناصر، بالإضافة إلى قاعدة بيانات SQL وأسماء الجداول. يستخدم Databricks بيانات التعريف واستخدام كتالوج Unity لتخصيص الاقتراحات.

• بالنسبة لخلايا Python، يجب إرفاق دفتر الملاحظات بمجموعة لكي يعمل الإكمال التلقائي، ويجب تشغيل كافة الخلايا التي تعرف الكائنات القابلة للإكمال.
• بالنسبة لخلايا SQL، يقترح الإكمال التلقائي الكلمات الأساسية وبناء الجملة الأساسي حتى إذا لم يتم إرفاق دفتر الملاحظات بأي مورد حساب.
  • إذا تم تمكين مساحة العمل ل Unity Catalog، فإن الإكمال التلقائي يقترح أيضا أسماء الكتالوج والمخطط والجدول والأعمدة للجداول في كتالوج Unity.
  • إذا لم يتم تمكين مساحة العمل ل Unity Catalog، يجب إرفاق دفتر الملاحظات بمجموعة أو مستودع SQL لاقتراح أسماء الجداول أو الأعمدة.

تظهر اقتراحات الإكمال التلقائي تلقائيا عند الكتابة في خلية. استخدم مفتاحي الأسهم لأعلى ولأسفل أو الماوس لتحديد اقتراح، واضغط على المفتاح Tab أو مفتاح الإدخال Enter لإدراج التحديد في الخلية.

إشعار

يتم حظر الإكمال التلقائي للخادم في دفاتر ملاحظات R أثناء تنفيذ الأمر.

هناك إعدادان للمستخدم يجب أن يكونا على دراية بما يلي:

• لإيقاف تشغيل اقتراحات الإكمال التلقائي، قم بتبديل الإكمال التلقائي أثناء الكتابة. عند إيقاف تشغيل الإكمال التلقائي، يمكنك عرض اقتراحات الإكمال التلقائي بالضغط على Ctrl + مفتاح المسافة.
• لمنع Enter من إدراج اقتراحات الإكمال التلقائي، يقبل مفتاح التبديل Enter اقتراحات الإكمال التلقائي.

فحص المتغير

لعرض معلومات حول متغير معرف في دفتر ملاحظات SQL أو Python، مرر المؤشر فوق اسم المتغير. يتطلب فحص متغير Python Databricks Runtime 12.2 LTS أو أعلى.

راجع مستكشف المتغيرات

الانتقال إلى التعريف

عند إرفاق دفتر ملاحظات Python بمجموعة، يمكنك الانتقال بسرعة إلى تعريف متغير أو دالة أو التعليمات البرمجية خلف عبارة %run . للقيام بذلك، انقر بزر الماوس الأيمن فوق اسم المتغير أو الدالة، ثم انقر فوق الانتقال إلى التعريف أو تعريف نظرة خاطفة.

اضغط باستمرار على مفتاح Cmd على macOS أو المفتاح Ctrl على Windows وقم بالمرور فوق اسم المتغير أو الدالة. إذا تم العثور على تعريف، يتحول الاسم إلى ارتباط تشعبي.

تتوفر ميزة "go to definition" في Databricks Runtime 12.2 LTS وما فوق.

طي التعليمات البرمجية

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

لإخفاء التعليمات البرمجية، ضع المؤشر في أقصى يسار الخلية. تظهر أسهم التوجيه لأسفل في نقاط منطقية حيث يمكنك إخفاء قسم من التعليمات البرمجية. انقر فوق السهم لإخفاء مقطع التعليمات البرمجية. انقر فوق السهم مرة أخرى (أشر الآن إلى اليمين) لإظهار التعليمات البرمجية.

لمزيد من التفاصيل، بما في ذلك اختصارات لوحة المفاتيح، راجع وثائق VS Code.

دعم متعدد المكونات

يمكنك إنشاء مؤشرات متعددة لتسهيل عمليات التحرير المتزامنة، كما هو موضح في الفيديو:

لإنشاء مؤشرات متعددة في خلية:

• في macOS، اضغط باستمرار على Option المفتاح وانقر في كل موقع لإضافة مؤشر.
• في Windows، اضغط باستمرار على Alt المفتاح وانقر في كل موقع لإضافة مؤشر.
• لديك أيضا خيار تغيير الاختصار. راجع تغيير الاختصار لتحديد متعدد المكونات والأعمدة.

في macOS، يمكنك إنشاء مؤشرات متعددة ذات محاذاة عمودية باستخدام اختصار Option+Commandلوحة المفاتيح + مفتاح السهم لأعلى أو لأسفل.

تحديد العمود (المربع)

لتحديد عناصر متعددة في عمود، انقر فوق أعلى يسار المنطقة التي تريد التقاطها. ثم:

• في macOS، اضغط Shift + Option واسحب إلى أسفل اليمين لالتقاط عمود واحد أو أكثر.
• في Windows، اضغط Shift + Alt واسحب إلى أسفل اليمين لالتقاط عمود واحد أو أكثر.
• لديك أيضا خيار تغيير الاختصار. راجع تغيير الاختصار لتحديد متعدد المكونات والأعمدة.

تغيير الاختصار لتحديد متعدد المكونات والأعمدة

يتوفر اختصار بديل لتحديد متعدد المكونات والعمود (مربع). مع التحديد البديل، تتغير الاختصارات كما يلي:

• لإنشاء مؤشرات متعددة في خلية:
  • في macOS، اضغط باستمرار على Cmd المفتاح وانقر في كل موقع لإضافة مؤشر.
  • في Windows، اضغط باستمرار على Ctrl المفتاح وانقر في كل موقع لإضافة مؤشر.
• لتحديد عناصر متعددة في عمود، انقر فوق أعلى يسار المنطقة التي تريد التقاطها. ثم:
  • في macOS، اضغط Option واسحب إلى أسفل اليمين لالتقاط عمود واحد أو أكثر.
  • في Windows، اضغط Alt واسحب إلى أسفل اليمين لالتقاط عمود واحد أو أكثر.

لتمكين الاختصارات البديلة، قم بما يلي:

1. انقر فوق اسم المستخدم في الزاوية العلوية اليسرى من مساحة العمل، ثم انقر فوق إعدادات في القائمة المنسدلة.
2. في الشريط الجانبي Settings ، حدد Developer.
3. في قسم محرر التعليمات البرمجية، قم بتغيير إعداد تعديل المفتاح للنقر فوق مؤشر متعدد إلى Cmd لنظام التشغيل macOS أو Ctrl لنظام التشغيل Windows.

عند تمكين اختصارات بديلة، لا يتغير اختصار لوحة المفاتيح لإنشاء مؤشرات متعددة ذات محاذاة عمودية.

مطابقة الأقواس

عند النقر بالقرب من قوس أو قوس مربع أو قوس متعرج، يقوم المحرر بتمييز هذا الحرف وقوسه المطابق.

فرق جنبا إلى جنب في محفوظات الإصدار

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

تمييز خطأ Python

عند توصيل دفتر ملاحظات بمجموعة، يتم تسطير أخطاء بناء الجملة باللون الأحمر. بالنسبة إلى Python، يجب أن تقوم المجموعة بتشغيل Databricks Runtime 12.2 LTS أو أعلى.

مرر تحذير بناء الجملة وحدد Quick Fix للإجراءات المحتملة.

يمكن لمساحات العمل مع تمكين Databricks Assistant أيضا تحديد إصلاح باستخدام مساعد للحصول على اقتراحات بمساعدة الذكاء الاصطناعي.

لتمكين تمييز خطأ بناء الجملة أو تعطيله، قم بما يلي:

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

تمييز تنسيق Python

يتم تسطير أخطاء تنسيق التعليمات البرمجية Python والتحذيرات باللون الأصفر. مرر مؤشر الماوس فوق تحذيرات بناء الجملة للاطلاع على مزيد من المعلومات. يجب أن يقوم نظام المجموعة بتشغيل Databricks Runtime 12.1 LTS أو أعلى.

لتمكين أخطاء التنسيق والتحذيرات:

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