تثبيت تبعيات دفتر الملاحظات

يمكنك تثبيت تبعيات Python لدفاتر الملاحظات بلا خادم باستخدام اللوحة الجانبية للبيئة. توفر هذه اللوحة مكانا واحدا لتحرير متطلبات مكتبة دفتر الملاحظات وعرضها وتصديرها. يمكن إضافة هذه التبعيات باستخدام بيئة أساسية أو بشكل فردي.

بالنسبة للمهام غير المتعلقة بدفتر الملاحظات، راجع تكوين البيئات والتبعيات للمهام غير المتعلقة بدفتر الملاحظات.

هام

لا تقم بتثبيت PySpark أو أي مكتبة تقوم بتثبيت PySpark كتبعية على دفاتر الملاحظات بلا خادم. سيؤدي القيام بذلك إلى إيقاف جلسة العمل الخاصة بك ويؤدي إلى حدوث خطأ. إذا حدث ذلك، قم بإعادة تعيين البيئة الخاصة بك.

تكوين بيئة أساسية

البيئة الأساسية هي ملف YAML مخزن كملف مساحة عمل أو على وحدة تخزين كتالوج Unity تحدد تبعيات بيئة إضافية. يمكن مشاركة البيئات الأساسية بين دفاتر الملاحظات. لتكوين بيئة أساسية:

1. إنشاء ملف YAML يحدد إعدادات بيئة Python الظاهرية. يحدد المثال التالي YAML، الذي يستند إلى مواصفات بيئة مشاريع MLflow، بيئة أساسية مع بعض تبعيات المكتبة:

   client: "1"
   dependencies:
     - --index-url https://pypi.org/simple
     - -r "/Workspace/Shared/requirements.txt"
     - cowsay==6.1
   

2. قم بتحميل ملف YAML كملف مساحة عمل أو إلى وحدة تخزين كتالوج Unity. راجع استيراد ملف أو تحميل ملفات إلى وحدة تخزين كتالوج Unity.

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

4. في حقل البيئة الأساسية، أدخل مسار ملف YAML الذي تم تحميله أو انتقل إليه وحدده.

5. انقر فوق تطبيق. يؤدي هذا إلى تثبيت التبعيات في البيئة الظاهرية لدفتر الملاحظات وإعادة تشغيل عملية Python.

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

إضافة تبعيات بشكل فردي

يمكنك أيضا تثبيت التبعيات على دفتر ملاحظات متصل بحساب بلا خادم باستخدام علامة التبويب Dependencies في لوحة Environment:

1. على يمين دفتر الملاحظات، انقر فوق الزر لتوسيع لوحة البيئة . يظهر هذا الزر فقط عندما يكون دفتر ملاحظات متصلا بحساب بلا خادم.
2. في قسم Dependencies، انقر فوق Add Dependency وأدخل مسار تبعية المكتبة في الحقل. يمكنك تحديد تبعية بأي تنسيق صالح في ملف requirements.txt .
3. انقر فوق تطبيق. يؤدي هذا إلى تثبيت التبعيات في البيئة الظاهرية لدفتر الملاحظات وإعادة تشغيل عملية Python.

إشعار

ستقوم الوظيفة التي تستخدم الحوسبة بلا خادم بتثبيت مواصفات البيئة لدفتر الملاحظات قبل تنفيذ التعليمات البرمجية لدفتر الملاحظات. وهذا يعني أنه ليست هناك حاجة لإضافة تبعيات عند جدولة دفاتر الملاحظات كمهام. راجع تكوين البيئات والتبعيات.

عرض التبعيات المثبتة وسجلات النقاط

لعرض التبعيات المثبتة، انقر فوق مثبت في اللوحة الجانبية البيئات لدفتر ملاحظات. تتوفر سجلات تثبيت Pip لبيئة دفتر الملاحظات أيضا بالنقر فوق سجلات Pip في أسفل اللوحة.

إعادة تعيين البيئة

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

ينطبق التخزين المؤقت لبيئة Python الظاهرية أيضا على الوظائف. وهذا يعني أن عمليات التشغيل اللاحقة للوظائف أسرع حيث تتوفر بالفعل التبعيات المطلوبة.

إشعار

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

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

إشعار

إعادة تعيين البيئة الظاهرية إذا قمت بتثبيت الحزم التي تكسر أو تغير دفتر الملاحظات الأساسي أو بيئة Apache Spark. فصل دفتر الملاحظات من الحوسبة بلا خادم وإعادة إرفاقه لا يؤدي بالضرورة إلى مسح ذاكرة التخزين المؤقت للبيئة بأكملها.

تكوين البيئات والتبعيات للمهام غير المتعلقة بدفتر الملاحظات

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

1. في القائمة المنسدلة البيئة والمكتبات، انقر فوق بجوار البيئة الافتراضية أو انقر فوق + إضافة بيئة جديدة.

   

2. في مربع الحوار تكوين البيئة ، انقر فوق + إضافة مكتبة.

3. حدد نوع التبعية من القائمة المنسدلة ضمن المكتبات.

4. في مربع النص مسار الملف، أدخل المسار إلى المكتبة.

• بالنسبة لعجلة Python في ملف مساحة عمل، يجب أن يكون المسار مطلقا ويبدأ ب /Workspace/.

• بالنسبة لعجلة Python في وحدة تخزين كتالوج Unity، يجب أن يكون /Volumes/<catalog>/<schema>/<volume>/<path>.whlالمسار .

• بالنسبة إلى requirements.txt ملف، حدد PyPi وأدخل -r /path/to/requirements.txt.

  

1. انقر فوق تأكيد أو + إضافة مكتبة لإضافة مكتبة أخرى.
2. إذا كنت تقوم بإضافة مهمة، فانقر فوق إنشاء مهمة. إذا كنت تقوم بتحرير مهمة، فانقر فوق حفظ المهمة.