تشغيل دفاتر ملاحظات Jupyter في مساحة العمل
تعرف على كيفية تشغيل دفاتر ملاحظات Jupyter مباشرة في مساحة العمل في Azure التعلم الآلي studio. بينما يمكنك تشغيل Jupyter أو JupyterLab، يمكنك أيضا تحرير دفاتر الملاحظات وتشغيلها دون مغادرة مساحة العمل.
للحصول على معلومات حول كيفية إنشاء الملفات وإدارتها، بما في ذلك دفاتر الملاحظات، راجع إنشاء الملفات وإدارتها في مساحة العمل.
هام
يتم توفير الميزات التي تم وضع علامة عليها ك (معاينة) دون اتفاقية مستوى الخدمة، ولا يوصى بها لأحمال عمل الإنتاج. بعض الميزات ربما لا تكون مدعمة أو بها بعض القدرات المقيدة لمزيد من المعلومات، راجع شروط الاستخدام التكميلية لمعاينات Microsoft Azure.
المتطلبات الأساسية
- اشتراك Azure. إذا لم يكن لديك اشتراك Azure، فأنشئ حساباً مجانياً قبل أن تبدأ.
- مساحة عمل التعلم الآلي. راجع "Create an Azure التعلم الآلي workspace".
- يجب أن يكون لهوية المستخدم حق الوصول إلى حساب التخزين الافتراضي لمساحة العمل. يعتمد ما إذا كان بإمكانك قراءة دفاتر الملاحظات أو تحريرها أو إنشائها على مستوى الوصول إلى مساحة العمل الخاصة بك. على سبيل المثال، يمكن للمساهم تحرير دفتر الملاحظات، بينما يمكن للقارئ عرضه فقط.
الوصول إلى دفاتر الملاحظات من مساحة العمل
استخدم قسم دفاتر الملاحظات في مساحة العمل لتحرير دفاتر ملاحظات Jupyter وتشغيلها.
- تسجيل الدخول إلى Azure التعلم الآلي studio
- حدد مساحة العمل الخاصة بك، إذا لم تكن مفتوحة بالفعل
- على اليسار، حدد Notebooks.
تحرير دفتر ملاحظات
لتحرير دفتر ملاحظات، افتح أي دفتر ملاحظات موجود في قسم ملفات المستخدم في مساحة العمل. انقر فوق الخلية التي ترغب في تحريرها. إذا لم يكن لديك أي دفاتر ملاحظات في هذا القسم، فشاهد إنشاء الملفات وإدارتها في مساحة العمل.
يمكنك تحرير دفتر الملاحظات دون الاتصال بمثيل حساب. عندما تريد تشغيل الخلايا في دفتر الملاحظات، حدد مثيل حساب أو أنشئه. إذا قمت بتحديد مثيل حساب متوقف، فسيبدأ تلقائيا عند تشغيل الخلية الأولى.
عند تشغيل مثيل حساب، يمكنك أيضا استخدام إكمال التعليمات البرمجية، مدعوما ب Intellisense، في أي دفتر ملاحظات Python.
يمكنك أيضا تشغيل Jupyter أو JupyterLab من شريط أدوات دفتر الملاحظات. لا يوفر Azure التعلم الآلي تحديثات ويصلح الأخطاء من Jupyter أو JupyterLab لأنها منتجات مفتوحة المصدر خارج حدود دعم Microsoft.
وضع التركيز
استخدم وضع التركيز لتوسيع طريقة العرض الحالية حتى تتمكن من التركيز على علامات التبويب النشطة. يخفي وضع التركيز مستكشف ملفات دفاتر الملاحظات.
في شريط أدوات نافذة المحطة الطرفية، حدد وضع التركيز لتشغيل وضع التركيز. اعتمادا على عرض النافذة الخاصة بك، قد تكون الأداة موجودة ضمن عنصر القائمة ... في شريط الأدوات الخاص بك.
أثناء وضع التركيز، ارجع إلى طريقة العرض القياسية عن طريق تحديد طريقة العرض القياسية.
إكمال التعليمات البرمجية (IntelliSense)
IntelliSense هو مساعدة لإكمال التعليمات البرمجية تتضمن العديد من الميزات: List Members و Parameter Info و Quick Info و Complete Word. باستخدام عدد قليل من ضغطات المفاتيح فقط، يمكنك:
- تعرف على المزيد حول التعليمات البرمجية التي تستخدمها
- تعقب المعلمات التي تكتبها
- إضافة استدعاءات إلى الخصائص والأساليب
إدراج قصاصات برمجية (معاينة)
استخدم Ctrl+Space لتشغيل قصاصات التعليمات البرمجية IntelliSense. قم بالتمرير عبر الاقتراحات أو ابدأ الكتابة للعثور على التعليمات البرمجية التي تريد إدراجها. بمجرد إدراج التعليمات البرمجية، انتقل عبر الوسيطات لتخصيص التعليمات البرمجية لاستخدامها الخاص.
تتوفر هذه القصاصات البرمجية نفسها عند فتح دفتر ملاحظاتك في VS Code. للحصول على قائمة كاملة بالمقتطفات المتوفرة، راجع قصاصات Azure التعلم الآلي VS Code.
يمكنك استعراض قائمة القصاصات البرمجية والبحث فيها باستخدام شريط أدوات دفتر الملاحظات لفتح لوحة القصاصة البرمجية.
من لوحة القصاصات البرمجية، يمكنك أيضا إرسال طلب لإضافة قصاصات برمجية جديدة.
مشاركة دفتر ملاحظات
يتم تخزين دفاتر الملاحظات في حساب تخزين مساحة العمل الخاص بك، ويمكن مشاركتها مع الآخرين، اعتمادا على مستوى وصولهم إلى مساحة العمل الخاصة بك. يمكنهم فتح دفتر الملاحظات وتحريره طالما أن لديهم حق الوصول المناسب. على سبيل المثال، يمكن للمساهم تحرير دفتر الملاحظات، بينما يمكن للقارئ عرضه فقط.
يمكن للمستخدمين الآخرين في مساحة العمل العثور على دفتر ملاحظاتك في قسم دفاتر الملاحظاتوملفات المستخدم في استوديو التعلم الآلي من Microsoft Azure. بشكل افتراضي، توجد دفاتر الملاحظات في مجلد باسم المستخدم الخاص بك، ويمكن للآخرين الوصول إليها هناك.
يمكنك أيضا نسخ عنوان URL من المستعرض عند فتح دفتر ملاحظات، ثم إرساله إلى الآخرين. طالما أن لديهم حق الوصول المناسب إلى مساحة العمل الخاصة بك، يمكنهم فتح دفتر الملاحظات.
نظرا لأنك لا تشارك مثيلات الحوسبة، سيقوم المستخدمون الآخرون الذين يقومون بتشغيل دفتر الملاحظات بذلك على مثيل الحساب الخاص بهم.
التعاون في العمل باستخدام تعليقات دفتر الملاحظات (معاينة)
استخدم تعليق دفتر ملاحظات للتعاون مع الآخرين الذين لديهم حق الوصول إلى دفتر ملاحظاتك.
قم بتبديل جزء التعليقات وإيقاف تشغيله باستخدام أداة تعليقات دفتر الملاحظات في أعلى دفتر الملاحظات. إذا لم تكن الشاشة عريضة بما فيه الكفاية، فابحث عن هذه الأداة عن طريق تحديد ... في نهاية مجموعة الأدوات.
سواء كان جزء التعليقات مرئيا أم لا، يمكنك إضافة تعليق إلى أي خلية تعليمات برمجية:
- حدد بعض النص في خلية التعليمات البرمجية. يمكنك التعليق فقط على النص في خلية التعليمات البرمجية.
- استخدم أداة مؤشر ترابط التعليق الجديد لإنشاء تعليقك.
- إذا كان جزء التعليقات مخفيا مسبقا، فسيتم فتحه الآن.
- اكتب تعليقك وانشره باستخدام الأداة أو استخدم Ctrl+Enter.
- بمجرد نشر تعليق، حدد ... في أعلى اليمين إلى:
- تحرير التعليق
- حل مؤشر الترابط
- حذف مؤشر الترابط
سيظهر النص الذي تم التعليق عليه مع تمييز أرجواني في التعليمات البرمجية. عند تحديد تعليق في جزء التعليقات، سيتم تمرير دفتر الملاحظات إلى الخلية التي تحتوي على النص المميز.
ملاحظة
يتم حفظ التعليقات في بيانات تعريف خلية التعليمات البرمجية.
تنظيف دفتر الملاحظات (معاينة)
على مدار إنشاء دفتر ملاحظات، ينتهي بك الأمر عادة بالخلايا التي استخدمتها لاستكشاف البيانات أو تصحيح الأخطاء. ستساعدك ميزة "تجميع " على إنشاء دفتر ملاحظات نظيف بدون هذه الخلايا الغريبة.
- قم بتشغيل كافة خلايا دفتر الملاحظات.
- حدد الخلية التي تحتوي على التعليمات البرمجية التي ترغب في تشغيل دفتر الملاحظات الجديد. على سبيل المثال، التعليمات البرمجية التي ترسل تجربة، أو ربما التعليمات البرمجية التي تسجل نموذجا.
- حدد الأيقونة تجميع التي تظهر على شريط أدوات الخلية.
- أدخل اسم دفتر الملاحظات الجديد "المجمع".
يحتوي دفتر الملاحظات الجديد على خلايا التعليمات البرمجية فقط، مع كافة الخلايا المطلوبة لإنتاج نفس النتائج مثل الخلية التي حددتها لجمعها.
حفظ دفتر ملاحظات ونقاط التحقق منه
يقوم Azure التعلم الآلي بإنشاء ملف نقطة تحقق عند إنشاء ملف ipynb.
في شريط أدوات دفتر الملاحظات، حدد القائمة ثم حفظ الملفات> ونقطة التحقق لحفظ دفتر الملاحظات يدويا وسيضيف ملف نقطة تحقق مقترنا بدفتر الملاحظات.
يتم حفظ كل دفتر ملاحظات تلقائيا كل 30 ثانية. يقوم الحفظ التلقائي بتحديث ملف ipynb الأولي فقط، وليس ملف نقطة التحقق.
حدد نقاط التحقق في قائمة دفتر الملاحظات لإنشاء نقطة تحقق مسماة وإعادة دفتر الملاحظات إلى نقطة تحقق محفوظة.
تصدير دفتر ملاحظات
في شريط أدوات دفتر الملاحظات، حدد القائمة ثم تصدير باسم لتصدير دفتر الملاحظات كأي نوع من الأنواع المدعومة:
- دفتر الملاحظات
- Python
- HTML
- اللاتكس
يتم حفظ الملف الذي تم تصديره على الكمبيوتر.
تشغيل دفتر ملاحظات أو برنامج نصي Python
لتشغيل دفتر ملاحظات أو برنامج نصي Python، يمكنك أولا الاتصال بمثيل حساب قيد التشغيل.
إذا لم يكن لديك مثيل حساب، فاستخدم هذه الخطوات لإنشاء مثيل:
- في شريط أدوات دفتر الملاحظات أو البرنامج النصي، على يمين القائمة المنسدلة Compute، حدد + New Compute. اعتمادا على حجم الشاشة، قد يكون هذا موجودا ضمن قائمة ... .
- قم بتسمية الحساب واختر حجم الجهاز الظاهري.
- حدد Create.
- يتم توصيل مثيل الحساب بالملف تلقائيا. يمكنك الآن تشغيل خلايا دفتر الملاحظات أو البرنامج النصي Python باستخدام الأداة إلى يسار مثيل الحساب.
- في شريط أدوات دفتر الملاحظات أو البرنامج النصي، على يمين القائمة المنسدلة Compute، حدد + New Compute. اعتمادا على حجم الشاشة، قد يكون هذا موجودا ضمن قائمة ... .
إذا كان لديك مثيل حساب متوقف، فحدد Start compute إلى يمين القائمة المنسدلة Compute. اعتمادا على حجم الشاشة، قد يكون هذا موجودا ضمن قائمة ... .
بمجرد الاتصال بمثيل حساب، استخدم شريط الأدوات لتشغيل كافة الخلايا في دفتر الملاحظات، أو Control + Enter لتشغيل خلية محددة واحدة.
يمكنك فقط رؤية مثيلات الحوسبة التي تقوم بإنشائها واستخدامها. يتم تخزين ملفات المستخدم بشكل منفصل عن الجهاز الظاهري وتتم مشاركتها بين جميع مثيلات الحوسبة في مساحة العمل.
عرض السجلات والإخراج
استخدم عناصر واجهة مستخدم دفتر الملاحظات لعرض تقدم التشغيل والسجلات. عنصر واجهة المستخدم غير متزامن ويوفر تحديثات حتى ينتهي التدريب. يتم أيضا دعم عناصر واجهة مستخدم Azure التعلم الآلي في Jupyter و JupterLab.
استكشاف المتغيرات في دفتر الملاحظات
على شريط أدوات دفتر الملاحظات، استخدم أداة مستكشف المتغيرات لإظهار الاسم والنوع والطول وعينة القيم لكافة المتغيرات التي تم إنشاؤها في دفتر الملاحظات.
حدد الأداة لإظهار نافذة مستكشف المتغيرات.
التنقل باستخدام TOC
على شريط أدوات دفتر الملاحظات، استخدم أداة جدول المحتويات لعرض جدول المحتويات أو إخفاؤه. ابدأ تشغيل خلية markdown مع عنوان لإضافتها إلى جدول المحتويات. انقر فوق إدخال في الجدول للتمرير إلى تلك الخلية في دفتر الملاحظات.
تغيير بيئة دفتر الملاحظات
يسمح لك شريط أدوات دفتر الملاحظات بتغيير البيئة التي يتم تشغيل دفتر الملاحظات عليها.
لن تغير هذه الإجراءات حالة دفتر الملاحظات أو قيم أي متغيرات في دفتر الملاحظات:
| إجراء | النتيجة |
|---|---|
| إيقاف النواة | إيقاف أي خلية قيد التشغيل. سيؤدي تشغيل خلية إلى إعادة تشغيل النواة تلقائيا. |
| الانتقال إلى مقطع مساحة عمل آخر | تم إيقاف تشغيل الخلايا. |
ستؤدي هذه الإجراءات إلى إعادة تعيين حالة دفتر الملاحظات وستعيد تعيين كافة المتغيرات في دفتر الملاحظات.
| إجراء | النتيجة |
|---|---|
| تغيير النواة | يستخدم دفتر الملاحظات نواة جديدة |
| تبديل الحساب | يستخدم دفتر الملاحظات الحوسبة الجديدة تلقائيا. |
| إعادة تعيين الحساب | يبدأ مرة أخرى عند محاولة تشغيل خلية |
| إيقاف الحساب | لن يتم تشغيل أي خلايا |
| فتح دفتر الملاحظات في Jupyter أو JupyterLab | تم فتح دفتر الملاحظات في علامة تبويب جديدة. |
إضافة نواة جديدة
استخدم المحطة الطرفية لإنشاء وإضافة نواة جديدة إلى مثيل الحساب الخاص بك. سيعثر دفتر الملاحظات تلقائيا على جميع نواة Jupyter المثبتة على مثيل الحساب المتصل.
استخدم القائمة المنسدلة kernel على اليمين للتغيير إلى أي من النواة المثبتة.
إدارة الحزم
نظرا لأن مثيل الحساب الخاص بك يحتوي على نواة متعددة، تأكد من استخدام %pip أو %condaوظائف سحرية، والتي تقوم بتثبيت الحزم في النواة قيد التشغيل حاليا. لا تستخدم !pip أو !conda، الذي يشير إلى جميع الحزم (بما في ذلك الحزم خارج النواة قيد التشغيل حاليا).
مؤشرات الحالة
يظهر المؤشر الموجود بجانب القائمة المنسدلة Compute حالته. تظهر الحالة أيضا في القائمة المنسدلة نفسها.
| اللون | حالة الحساب |
|---|---|
| Green | حساب قيد التشغيل |
| أحمر | فشل الحساب |
| Black | تم إيقاف الحساب |
| أزرق فاتح | حساب الإنشاء والبدء وإعادة التشغيل وإعداد |
| رمادي | حساب الحذف والإيقاف |
يظهر مؤشر بجوار القائمة المنسدلة Kernel حالته.
| اللون | حالة النواة |
|---|---|
| Green | نواة متصلة، الخامة، مشغولة |
| رمادي | النواة غير متصلة |
البحث عن تفاصيل الحساب
ابحث عن تفاصيل حول مثيلات الحوسبة في صفحة الحوسبة في الاستوديو.
اختصارات لوحة المفاتيح المفيدة
على غرار Jupyter Notebooks، تحتوي دفاتر ملاحظات Azure التعلم الآلي Studio على واجهة مستخدم مشروطة. تقوم لوحة المفاتيح بأشياء مختلفة استنادا إلى الوضع الذي توجد به خلية دفتر الملاحظات. تدعم دفاتر ملاحظات Azure التعلم الآلي Studio الوضعين التاليين لخلية تعليمات برمجية معينة: وضع الأوامر ووضع التحرير.
اختصارات وضع الأوامر
تكون الخلية في وضع الأوامر عندما لا يكون هناك مؤشر نص يطالبك بالكود. عندما تكون خلية في وضع الأمر، يمكنك تحرير دفتر الملاحظات ككل ولكن لا تكتب في خلايا فردية. أدخل وضع الأمر بالضغط ESC على الماوس أو استخدامه للتحديد خارج منطقة محرر الخلية. الحد الأيسر للخلية النشطة أزرق ومتين، وزر التشغيل الخاص به أزرق.
| مختصرة | الوصف |
|---|---|
| زر الإدخال | أدخل وضع التحرير |
| Shift + Enter | تشغيل الخلية، حدد أدناه |
| Control/Command + Enter | تشغيل الخلية |
| Alt + Enter | تشغيل الخلية، وإدراج خلية التعليمات البرمجية أدناه |
| Control/Command + Alt + Enter | تشغيل الخلية وإدراج خلية markdown أدناه |
| Alt + R | Run all |
| Y | تحويل الخلية إلى تعليمة برمجية |
| M | تحويل الخلية إلى markdown |
| لأعلى/ك | تحديد الخلية أعلاه |
| لأسفل/J | تحديد الخلية أدناه |
| A | إدراج خلية التعليمات البرمجية أعلاه |
| B | إدراج خلية التعليمات البرمجية أدناه |
| Control/Command + Shift + A | إدراج خلية markdown أعلاه |
| Control/Command + Shift + B | إدراج خلية markdown أدناه |
| X | قص الخلية المحددة |
| C | نسخ الخلية المحددة |
| Shift + V | لصق الخلية المحددة أعلاه |
| V | لصق الخلية المحددة أدناه |
| D D | حذف الخلية المحددة |
| -O | تبديل الإخراج |
| Shift + O | تبديل تمرير الإخراج |
| أنا | نواة المقاطعة |
| 0 0 | إعادة تشغيل النواة |
| Shift + مسافة | التمرير لأعلى |
| المساحة | التمرير لأسفل |
| علامة تبويب | تغيير التركيز إلى العنصر التالي القابل للتركيز (عند تعطيل تراكب علامة التبويب) |
| Control/Command + S | حفظ دفتر الملاحظات |
| 1 | تغيير إلى h1 |
| 2 | تغيير إلى h2 |
| 3 | تغيير إلى h3 |
| 4 | تغيير إلى h4 |
| 5 | تغيير إلى h5 |
| 6 | تغيير إلى h6 |
تحرير اختصارات الوضع
تتم الإشارة إلى وضع التحرير بواسطة مؤشر نص يطالبك بكتابة منطقة المحرر. عندما تكون خلية في وضع التحرير، يمكنك الكتابة في الخلية. أدخل وضع التحرير بالضغط Enter على الماوس أو استخدامه للتحديد في منطقة محرر الخلية. الحد الأيسر للخلية النشطة أخضر ومفرسا، والزر "تشغيل" باللون الأخضر. سترى أيضا مطالبة المؤشر في الخلية في وضع التحرير.
باستخدام اختصارات ضغطات المفاتيح التالية، يمكنك التنقل بسهولة أكبر وتشغيل التعليمات البرمجية في دفاتر ملاحظات Azure التعلم الآلي عند العمل في وضع التحرير.
| مختصرة | الوصف |
|---|---|
| الهروب | إدخال وضع الأوامر |
| Control/Command + مسافة | تنشيط IntelliSense |
| Shift + Enter | تشغيل الخلية، حدد أدناه |
| Control/Command + Enter | تشغيل الخلية |
| Alt + Enter | تشغيل الخلية وإدراج خلية التعليمات البرمجية أدناه |
| Control/Command + Alt + Enter | تشغيل الخلية وإدراج خلية markdown أدناه |
| Alt + R | تشغيل كل الخلايا |
| أعلى | نقل المؤشر لأعلى أو الخلية السابقة |
| اسفل | نقل المؤشر لأسفل أو الخلية التالية |
| Control/Command + S | حفظ دفتر الملاحظات |
| Control/Command + لأعلى | الانتقال إلى بدء الخلية |
| Control/Command + Down | الانتقال إلى نهاية الخلية |
| علامة تبويب | إكمال التعليمات البرمجية أو المسافة البادئة (إذا تم تمكين تراكب علامة التبويب) |
| Control/Command + M | تمكين/تعطيل تراكب علامة التبويب |
| Control/Command + ] | المسافه البادئه |
| Control/Command + [ | مسافة بادئة |
| Control/Command + A | تحديد الكل |
| Control/Command + Z | تراجع |
| Control/Command + Shift + Z | إعادة |
| Control/Command + Y | إعادة |
| Control/Command + Home | الانتقال إلى بدء الخلية |
| Control/Command + End | الانتقال إلى نهاية الخلية |
| Control/Command + Left | الانتقال إلى اليمين بكلمة واحدة |
| Control/Command + Right | الانتقال إلى كلمة واحدة لليمين |
| Control/Command + Backspace | حذف كلمة قبل |
| Control/Command + Delete | حذف كلمة بعد |
| Control/Command + / | تبديل التعليق على الخلية |
استكشاف الأخطاء وإصلاحها
الاتصال بدفتر ملاحظات: إذا تعذر عليك الاتصال بدفتر ملاحظات، فتأكد من عدم تعطيل اتصال مأخذ توصيل الويب. لكي تعمل وظيفة Jupyter لمثيل الحوسبة، يجب تمكين اتصال مأخذ توصيل الويب. تأكد من أن شبكتك تسمح باتصالات websocket ب *.instances.azureml.net و*.instances.azureml.ms.
نقطة النهاية الخاصة: عند نشر مثيل حساب في مساحة عمل بنقطة نهاية خاصة، يمكن الوصول إليه فقط من داخل الشبكة الظاهرية. إذا كنت تستخدم ملف DNS المخصص أو المضيفين، أضف إدخالا لاسم <>المثيل .< المنطقة >.instances.azureml.ms مع عنوان IP الخاص لنقطة النهاية الخاصة بمساحة العمل. لمزيد من المعلومات، راجع مقالة DNS المخصصة .
تعطل Kernel: إذا تحطمت النواة الخاصة بك ثم تمت إعادة تشغيلها، يمكنك تشغيل الأمر التالي لإلقاء نظرة على سجل jupyter ومعرفة المزيد من التفاصيل:
sudo journalctl -u jupyter. إذا استمرت مشكلات النواة، ففكر في استخدام مثيل حساب مع ذاكرة أكبر.لم يتم العثور على Kernel أو تم تعطيل عمليات Kernel: عند استخدام نواة Python 3.8 الافتراضية على مثيل حساب، قد تحصل على خطأ مثل "لم يتم العثور على Kernel" أو "تم تعطيل عمليات Kernel". لإصلاح المشكلة، استخدم إحدى الطرق التالية:
- إنشاء مثيل حساب جديد. سيستخدم هذا صورة جديدة حيث تم حل هذه المشكلة.
- استخدم نواة Py 3.6 على مثيل الحساب الموجود.
- من محطة طرفية في بيئة py38 الافتراضية، قم بتشغيل
pip install ipykernel==6.6.0ORpip install ipykernel==6.0.3
الرمز المميز منتهية الصلاحية: إذا واجهت مشكلة في الرمز المميز منتهية الصلاحية، فقم بتسجيل الخروج من استوديو التعلم الآلي من Azure، وسجل الدخول مرة أخرى، ثم أعد تشغيل نواة دفتر الملاحظات.
حد تحميل الملف: عند تحميل ملف من خلال مستكشف الملفات في دفتر الملاحظات، تكون الملفات محدودة أصغر من 5 تيرابايت. إذا كنت بحاجة إلى تحميل ملف أكبر من هذا، نوصي باستخدام إحدى الطرق التالية:
- استخدم SDK لتحميل البيانات إلى مخزن البيانات. لمزيد من المعلومات، راجع Upload قسم البيانات من البرنامج التعليمي.
- استخدم Azure Data Factory لإنشاء مسار استيعاب البيانات.