ملاحظة
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
توضح هذه المقالة كيفية تشغيل دفاتر ملاحظات Jupyter داخل مساحة عمل Azure التعلم الآلي studio. هناك طرق أخرى لتشغيل دفتر الملاحظات أيضا: Jupyter وJupyterLab وVisual Studio Code. يمكن تكوين VS Code Desktop للوصول إلى مثيل الحساب الخاص بك. أو استخدم VS Code للويب، مباشرة من المتصفح، ودون أي تثبيتات أو تبعيات مطلوبة.
تلميح
نوصي بتجربة VS Code للويب للاستفادة من التكامل السهل وبيئة التطوير الغنية التي يوفرها. يمنحك VS Code للويب العديد من ميزات VS Code Desktop التي تحبها، بما في ذلك تمييز البحث وبناء الجملة أثناء الاستعراض والتحرير. لمزيد من المعلومات حول استخدام VS Code Desktop و VS Code للويب، راجع تشغيل Visual Studio Code المتكامل مع Azure التعلم الآلي والعمل في VS Code المتصل عن بعد بمثيل حساب.
بغض النظر عن الحل الذي تستخدمه لتشغيل دفتر الملاحظات، يمكنك الوصول إلى جميع الملفات من مساحة العمل. للحصول على معلومات عن كيفية إنشاء الملفات وإدارتها، بما في ذلك دفاتر الملاحظات، راجع إنشاء الملفات وإدارتها في مساحة العمل.
توضح هذه المقالة تجربة تشغيل دفتر الملاحظات مباشرة في الاستوديو.
هام
يتم توفير الميزات التي تم وضع علامة عليها (إصدار أولي) دون اتفاقية مستوى الخدمة، ولا يوصى بها لأحمال العمل الإنتاجية. بعض الميزات ربما لا تكون مدعمة أو بها بعض القدرات المقيدة. لمزيد من المعلومات، راجع شروط الاستخدام التكميلية لمعاينات Microsoft Azure.
المتطلبات الأساسية
- اشتراك Azure. إذا لم يكن لديك اشتراك Azure، فبادر بإنشاء حساب مجاني قبل البدء.
- مساحة عمل التعلم الآلي. راجع إنشاء موارد مساحة العمل.
- يتعين أن يكون لهوية المستخدم حق الوصول إلى حساب التخزين الافتراضي لمساحة العمل. يعتمد ما إذا كان بإمكانك قراءة دفاتر الملاحظات أو تحريرها أو إنشائها على مستوى الوصول إلى مساحة عملك. على سبيل المثال، يتوفر للمساهم تحرير دفتر الملاحظات، بينما يمكن للقارئ عرضه فقط.
الوصول إلى دفاتر الملاحظات من مساحة عمل
استخدم قسم Notebooks في مساحة العمل لتحرير دفاتر ملاحظات Jupyter وتشغيلها.
- سجّل الدخول إلى Azure Machine Learning studio
- حدد مساحة العمل الخاصة بك، في حالة لم تكن مفتوحة بالفعل
- على اليسار، حدد Notebooks.
تحرير دفتر ملاحظات
لتحرير دفتر ملاحظات، افتح أي دفتر ملاحظات موجود في قسم User files في مساحة العمل. حدد الخلية التي ترغب في تحريرها. في حالة لم يكن لديك أي دفاتر ملاحظات في هذا القسم، فشاهد إنشاء الملفات وإدارتها في مساحة العمل.
يمكنك تحرير دفتر الملاحظات دون الاتصال بمثيل الحساب. عندما ترغب في تشغيل الخلايا في دفتر الملاحظات، حدد مثيل حساب أو أنشئه. في حالة قمت بتحديد مثيل حساب متوقف، فسيبدأ تلقائيا عند تشغيل الخلية الأولى.
عند تشغيل مثيل حساب، يمكنك أيضا استخدام إكمال التعليمات البرمجية، مُشغّلة بواسطة Intellisense، في أي دفتر ملاحظات Python.
عند تشغيل مثيل حساب، يمكنك تشغيل Jupyter أو JupyterLab من شريط أدوات دفتر الملاحظات. لا يوفر Azure التعلم الآلي تحديثات ويصلح الأخطاء من Jupyter أو JupyterLab لأنها منتجات مفتوحة المصدر خارج حدود دعم Microsoft.
وضع التركيز
استعمل وضع التركيز لتوسيع طريقة العرض الحالية حتى تتمكن من التركيز على علامات التبويب النشطة. يخفي وضع التركيز مستكشف الملفات الخاصة بدفاتر الملاحظات.
في شريط أدوات نافذة المحطة الطرفية، حدد Focus mode لتشغيل وضع التركيز. استنادا على عرض النافذة الخاصة بك، قد تكون الأداة موجودة ضمن عنصر القائمة ... في شريط الأدوات الخاص بك.
أثناء وضع التركيز، ارجع إلى طريقة العرض القياسية عن طريق تحديد Standard view.
عملية إكمال التعليمات البرمجية (IntelliSense)
IntelliSenseعبارة عن أداة مساعدة لاكتمال التعليمة البرمجية تحتوي على عددًا من الميزات: قائمة الأعضاء، ومعلومات المعلمة، والمعلومات السريعة، وإكمال Word. باستعمال عدد قليل فقط من ضغطات المفاتيح، يمكنك:
- تعرف على المزيد حول التعليمات البرمجية التي تستعملها
- تعقب المعلمات التي تقوم بكتابتها
- عملية إضافة استدعاءات إلى الخصائص والأساليب
مشاركة دفتر الملاحظات
يتم تخزين دفاتر الملاحظات في حساب تخزين مساحة العمل الخاص بك، ويمكن مشاركتها مع الآخرين، اعتمادا على مستوى الوصول الخاص بهم إلى مساحة العمل الخاصة بك. يتوفر لهم فتح دفتر الملاحظات وتحريره طالما أن لديهم حق الوصول المناسب. على سبيل المثال، يتوفر للمساهم تحرير دفتر الملاحظات، بينما يمكن للقارئ عرضه فقط.
يمكن للمستخدمين الآخرين لمساحة العمل العثور على دفتر ملاحظاتك في قسم دفاتر الملاحظات وملفات المستخدم في Azure التعلم الآلي studio. بطريقة افتراضية، توجد دفاتر الملاحظات في مجلد باسم المستخدم الخاص بك، ويمكن للآخرين الوصول إليها هناك.
يمكنك أيضا نسخ عنوان URL من المستعرض عند فتح دفتر الملاحظات، ثم إرساله إلى الآخرين. طالما أن لديهم حق الوصول المناسب إلى مساحة العمل الخاصة بك، يتوفر لهم فتح دفتر الملاحظات.
نظرا لأنك لا تشارك مثيلات الحوسبة، فسيستخدم المستخدمون الآخرون الذين يقومون بتشغيل دفتر الملاحظات مثيل الحساب الخاص بهم.
التعاون في العمل باستخدام تعليقات دفتر الملاحظات
استعمل تعليق دفتر ملاحظات للتعاون مع الآخرين الذين لديهم حق الوصول إلى دفتر الملاحظات.
قم بتبديل جزء التعليقات وإيقاف تشغيله باستعمال أداة تعليقات دفتر الملاحظات في أعلى دفتر الملاحظات. في حالة لم تكن الشاشة عريضة بما فيه الكفاية، فابحث عن هذه الأداة عن طريق تحديد ... أولا في نهاية مجموعة الأدوات.
سواء كان جزء التعليقات مرئيا أم لا، يمكنك إضافة التعليق إلى أي خلية تعليمات برمجية:
- حدد بعض النص في الخلية الخاصة بالتعليمات البرمجية. يمكنك التعليق فقط على النص في الخلية الخاصة بالتعليمات البرمجية.
- استخدم أداة مؤشر ترابط التعليق الجديد لإنشاء التعليق الخاص بك.
- إذا كان جزء التعليقات مخفيا مسبقا، فإنه يفتح الآن.
- اكتب تعليقك وانشره باستعمال الأداة أو استعمل Ctrl+Enter.
- بمجرد نشر تعليق، حدد ... في أعلى اليمين إلى:
- خدمة تحرير التعليق
- حل المؤشر الخاص بالترابط
- إزالة مؤشر الترابط
يظهر النص الذي تم التعليق عليه مع تمييز أرجواني في التعليمات البرمجية. عند تحديد تعليق في جزء التعليقات، يقوم دفتر الملاحظات بالتمرير إلى الخلية التي تحتوي على النص المميز.
ملاحظة
يتم حفظ التعليقات في بيانات التعريف الخاصة بخلية التعليمات البرمجية.
تنظيف دفتر الملاحظات (إصدار أولي)
أثناء إنشاء دفتر ملاحظات، ينتهي بك الأمر عادة بالخلايا التي استعملتها لاستكشاف البيانات أو تصحيح الأخطاء. تساعدك ميزة "جمع" على إنشاء دفتر ملاحظات نظيف بدون هذه الخلايا الدخيلة.
- شغل كافة خلايا دفتر الملاحظات.
- حدد الخلية التي تحتوي على التعليمات البرمجية التي تريد تشغيل دفتر الملاحظات الجديد. على سبيل المثال، التعليمات البرمجية التي ترسل التجربة، أو ربما التعليمات البرمجية التي تسجل نموذجا.
- حدد الأيقونة Gather التي تظهر على شريط أدوات الخلية.
- أدخل الاسم الخاص بدفتر الملاحظات "المجمع" الجديد.
يتضمن دفتر الملاحظات الجديد على خلايا التعليمات البرمجية فقط، مع كل الخلايا المطلوبة لإنتاج نفس النتائج مثل الخلية التي حددتها لجمعها.
حفظ دفتر الملاحظات ونقطة التحقق منه
ينشئ التعلم الآلي من Azure ملف نقطة التحقق عند إنشاء ملف ipynb.
في شريط أدوات دفتر الملاحظات، حدد القائمة ثم حفظ الملف>ونقطة التحقق لحفظ دفتر الملاحظات يدويا وإضافة ملف نقطة تحقق مقترن بدفتر الملاحظات.
يحفظ كل دفتر ملاحظات تلقائيا كل 30 ثانية. يعمل الحفظ التلقائي بتحديث ملف ipynb الأولي فقط، وليس ملف نقطة التحقق.
حدد Checkpoints في قائمة دفتر الملاحظات لإنشاء نقطة تحقق مسماة والعودة بدفتر الملاحظات إلى نقطة تحقق محفوظة.
تصدير دفتر الملاحظات
في شريط أدوات دفتر الملاحظات، حدد القائمة ثم التصدير باسم لتصدير دفتر الملاحظات كأي نوع من الأنواع المدعومة:
- بايثون
- HTML
- اللاتكس
يحفظ الملف الذي تم تصديره على الكمبيوتر.
تشغيل دفتر الملاحظات أو برنامج نصي Python
لتشغيل دفتر ملاحظات أو برنامج نصي Python، يمكنك أولا الاتصال بمثيل الحساب قيد التشغيل.
في حالة لم يكن لديك مثيل حساب، فاستخدم هذه الخطوات لإنشاء مثيل:
- في شريط أدوات دفتر ملاحظات أو البرنامج النصي، على يمين القائمة المنسدلة Compute، حدد + New Compute. اعتمادا على حجم الشاشة، قد يكون عنصر التحكم موجودا ضمن قائمة ... .
- قم بتسمية الحساب واختر Virtual Machine Size.
- حدد إنشاء.
- يتم توصيل مثيل الحساب بالملف بطريقة تلقائية. يمكنك الآن تشغيل خلايا دفتر الملاحظات أو البرنامج النصي Python باستعمال الأداة إلى يسار مثيل الحساب.
- في شريط أدوات دفتر ملاحظات أو البرنامج النصي، على يمين القائمة المنسدلة Compute، حدد + New Compute. اعتمادا على حجم الشاشة، قد يكون عنصر التحكم موجودا ضمن قائمة ... .
في حالة كان لديك مثيل حساب متوقف، فحدد Start compute على يمين القائمة المنسدلة للحساب. اعتمادا على حجم الشاشة، قد يكون عنصر التحكم موجودا ضمن قائمة ... .
بمجرد الاتصال بمثيل حساب، استخدم شريط الأدوات لتشغيل كافة الخلايا في دفتر الملاحظات، أو Control + Enter لتشغيل خلية محددة واحدة.
يمكنك فقط رؤية مثيلات الحساب التي تقوم بإنشائها واستخدامها. يتم تخزين ملفات المستخدم بشكل منفصل عن الجهاز وتتم مشاركتها بين جميع مثيلات الحوسبة في مساحة العمل.
استكشاف المتغيرات الموجودة في دفتر الملاحظات
على شريط أدوات دفتر الملاحظات، استخدم أداة مستكشف المتغيرات لإظهار الاسم والنوع والطول وعينة القيم لجميع المتغيرات التي تم إنشاؤها في دفتر الملاحظات.
حدد الأداة لإظهار النافذة الخاصة بمستكشف المتغيرات.
التنقل باستعمال TOC
على شريط أدوات دفتر الملاحظات، استعمل أداة جدول المحتويات لعرض جدول المحتويات أو إخفاؤه. عند بدء تشغيل خلية markdown مع عنوان، تتم إضافتها إلى جدول المحتويات. حدد إدخالا في الجدول للتمرير إلى تلك الخلية في دفتر الملاحظات.
عملية تغيير بيئة دفتر الملاحظات
يوفر لك شريط أدوات دفتر الملاحظات بتغيير البيئة التي يتم تشغيل دفتر الملاحظات عليها.
لا تغير هذه الإجراءات حالة دفتر الملاحظات أو قيم أي متغيرات في دفتر الملاحظات:
| فعل | نتيجة |
|---|---|
| إيقاف kernel | عملية إيقاف أي خلية قيد التشغيل. يؤدي تشغيل خلية إلى إعادة تشغيل النواة تلقائيا. |
| الانتقال إلى مقطع مساحة العمل الآخر | يتم إيقاف تشغيل الخلايا. |
تقوم هذه الإجراءات بإعادة تعيين حالة دفتر الملاحظات وإعادة تعيين كافة المتغيرات في دفتر الملاحظات.
| فعل | نتيجة |
|---|---|
| تغيير kernel | يستخدم دفتر الملاحظات kernel جديد |
| عملية تبديل الحساب | يستخدم دفتر الملاحظات الحساب الجديدة تلقائيا. |
| عملية إعادة تعيين الحساب | يبدأ مرة أخرى عند محاولة تشغيل الخلية |
| عملية إيقاف الحساب | لن يتم تفعيل أي خلايا |
| فتح دفتر ملاحظات في Jupyter أو JupyterLab | تم فتح دفتر الملاحظات في علامة التبويب الجديدة. |
إضافة أنوية جديدة
استخدم terminal لإنشاء وإضافة kernel جديد إلى مثيل الحساب الخاص بك. سيعثر دفتر الملاحظات تلقائيا على كافة نواة Jupyter المثبتة على مثيل الحساب المتصل.
قم بالتغيير إلى أي من النواة المثبتة باستخدام القائمة المنسدلة kernel على اليمين.
إدارة الحزم
نظرا لأن مثيل الحساب الخاص بك يحتوي على نواة متعددة، تأكد من استخدام %pip أو %condaوظائف سحرية، والتي تثبت الحزم في النواة قيد التشغيل حاليا. لا تستخدم !pip أو !conda، الذي يشير إلى جميع الحزم (بما في ذلك الحزم خارج النواة قيد التشغيل حاليا).
المؤشرات الخاصة بالحالة
يعرض المؤشر الموجود بجانب القائمة المنسدلة Compute حالته. تعرض الحالة أيضا في القائمة المنسدلة نفسها.
| لون | الحالة الخاصة بالحساب |
|---|---|
| أخضر | الحساب قيد التشغيل |
| أحمر | تعطل الحساب |
| أسود | توقف الحساب |
| أزرق فاتح | الحساب الخاص بالإنشاء والبدء وإعادة التشغيل وإعداد |
| رمادي | حساب الإزالة والإيقاف |
يظهر مؤشر بجانب القائمة المنسدلة لـ Kernel حالته، ويظهر مؤشر بجانب القائمة المنسدلة لـ Kernel حالته.
| لون | حالة kernel |
|---|---|
| أخضر | kernel متصلة، الخامة، مشغولة |
| رمادي | kernel غير متصلة |
البحث عن التفاصيل الخاصة بالحساب
ابحث عن تفاصيل حول مثيلات الحساب في صفحة الحساب في الاستوديو.
عرض اختصارات لوحة المفاتيح
على غرار Jupyter Notebooks، تحتوي دفاتر ملاحظات استوديو Azure التعلم الآلي على واجهة مستخدم مشروطة. تقوم لوحة المفاتيح بأشياء مختلفة استنادا إلى الوضع الذي توجد به الخلية الخاصة بدفتر الملاحظات. تدعم دفاتر ملاحظات Azure التعلم الآلي studio الوضعين التاليين لخلية تعليمة برمجية معينة: وضع الأمر ووضع التحرير.
الاختصارات الخاصة بوضع الأوامر
تكون الخلية في وضع الأوامر عندما لا يكون هناك مؤشر نص يطالبك بالكود. عندما تكون الخلية في وضع الأوامر، يمكنك تحرير دفتر الملاحظات ككل ولكن لا يمكن الكتابة في خلايا فردية. أدخل وضع الأمر من خلال الضغطESCعلى الماوس أو أستعمله للتحديد خارج منطقة محرر الخلية.
| الاختصار | وصف |
|---|---|
| دخل | أدخل وضع تحرير |
| Shift+Enter | تفعيل الخلية، حدد أدناه |
| Control/Command + Enter | تفعيل الخلية |
| Alt + Enter | تفعيل الخلية، وإدراج خلية التعليمات البرمجية أدناه |
| Control/Command + Alt + Enter | تفعيل الخلية، إدراج خلية markdown أدناه |
| Alt + R | تشغيل الكل |
| Y | تحويل الخلية إلى التعليمة البرمجية |
| M | تحويل الخلية إلى العلامة التنازلية |
| لأعلى/K | قم بتحديد الخلية أعلاه |
| لأسفل/J | تحديد الخلية أدناه |
| A | إدراج الخلية الخاصة بالتعليمات البرمجية أعلاه |
| B | إدراج خلية التعليمات البرمجية أدناه |
| Control/Command + Shift + A | إدراج خلية markdown أعلاه |
| Control/Command + Shift + A | إدراج خلية markdown أعلاه |
| X | قص الخلية المحددة |
| C | نسخ الخلية المحددة |
| Shift + V | لصق الخلية المحددة أعلاه |
| V | لصق الخلية المحددة أدناه |
| D D | إزالة الخلية المحددة |
| O | عملية تبديل الإخراج |
| Shift + O | تبديل تمرير الإخراج |
| أنا | kernel المقاطعة |
| 0 0 | إعادة تشغيل kernel |
| Shift+Space | التمرير لأعلى |
| فضاء | التمرير لأسفل |
| التبويب | عملية تغيير التركيز إلى العنصر التالي القابل للتركيز (عند تعطيل تراكب علامة التبويب) |
| Control/Command + Enter | حفظ دفتر ملاحظات |
| 1 | التغيير إلى h1 |
| 2 | التغيير إلى h2 |
| 3 | التغيير إلى h3 |
| 4 | التغيير إلى h4 |
| 5 | التغيير إلى h5 |
| 6 | التغيير إلى h6 |
تحرير الاختصارات الخاصة بالوضع
تتم الإشارة إلى وضع التحرير عن طريق مؤشر نص يطالبك بكتابة في منطقة المحرر. عندما تكون الخلية في وضع التحرير، يمكنك الكتابة في الخلية. أدخل وضع التحرير بالضغط Enter على منطقة محرر الخلية أو تحديدها. تظهر مطالبة المؤشر في الخلية في وضع التحرير.
باستعمال اختصارات ضغطة المفاتيح التالية، يمكنك التنقل بسهولة أكبر وتشغيل التعليمات البرمجية في دفاتر ملاحظات التعلم الآلي من Azure عندما تكون في وضع التحرير.
| الاختصار | وصف |
|---|---|
| فرار | أدخل وضع الأمر |
| Control/Command + Enter | عملية تنشيط IntelliSense |
| Shift+Enter | تفعيل الخلية، حدد أدناه |
| Control/Command + Enter | تفعيل الخلية |
| Alt + Enter | تفعيل الخلية، وإدراج خلية التعليمات البرمجية أدناه |
| Control/Command + Alt + Enter | تفعيل الخلية، إدراج خلية markdown أدناه |
| Alt + R | تشغيل كل الخلايا |
| أعلى | عملية نقل المؤشر لأعلى أو الخلية السابقة |
| أسفل | عملية نقل المؤشر لأسفل أو الخلية التالية |
| Control/Command + Enter | حفظ دفتر ملاحظات |
| 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: إذا تعطل kernel وأعادت تشغيله، يمكنك تشغيل الأمر التالي لإلقاء نظرة على سجل Jupyter والعثور على مزيد من التفاصيل:
sudo journalctl -u jupyter. في حالة استمرت مشكلات kernel، ففكر في استخدام مثيل حساب مع ذاكرة أكبر.الرمز المميز منتهية الصلاحية: إذا واجهت مشكلة في الرمز المميز منتهية الصلاحية، فسجل الخروج من Azure التعلم الآلي studio، وسجل الدخول مرة أخرى، ثم أعد تشغيل نواة دفتر الملاحظات.
حد تحميل الملفات: عند تحميل ملف من خلال مستكشف ملفات دفتر الملاحظات، تكون ملفاتك محدودة أصغر من 5 تيرابايت. إذا كنت بحاجة إلى تحميل ملف أكبر من هذا، نوصي باستخدام SDK لتحميل البيانات إلى مخزن بيانات. لمزيد من المعلومات، راجع إنشاء أصول البيانات.