تتيح لك المكتبات ذات نطاق دفتر الملاحظات إنشاء بيئات Python المخصصة الخاصة بدفتر الملاحظات وتعديلها وحفظها وإعادة استخدامها ومشاركتها. عند تثبيت مكتبة ذات نطاق دفتر ملاحظات يمكن فقط لدفتر الملاحظات الحالي وأي مهام مقترنة بدفتر الملاحظات هذا الوصول إلى تلك المكتبة. لا تتأثر دفاتر الملاحظات الأخرى المرفقة بنفس المجموعة.
لا تستمر المكتبات ذات نطاق دفتر الملاحظات عبر جلسات العمل. يجب إعادة تثبيت المكتبات ذات نطاق دفتر الملاحظات في بداية كل جلسة عمل أو كلما تم فصل دفتر الملاحظات عن نظام مجموعة.
يمكنك استخدام %pip في دفاتر الملاحظات المجدولة كمهام. إذا كنت بحاجة إلى إدارة بيئة Python في دفتر ملاحظات Scala أو SQL أو R فاستخدم %python الأمر السحري بالتزامن مع %pip.
قد تواجه المزيد من حركة المرور إلى عقدة برنامج التشغيل عند العمل مع تثبيتات المكتبة ذات نطاق دفتر الملاحظات. راجع ما حجم عقدة برنامج التشغيل عند العمل مع المكتبات ذات نطاق دفتر الملاحظات.
لتثبيت مكتبات لكافة دفاتر الملاحظات المرفقة بمجموعة استخدم مكتبات نظام المجموعة. راجع مكتبات نظام المجموعة.
في Databricks Runtime 10.4 LTS وما يليه يمكنك استخدام الأداة المساعدة (القديمة) لمكتبة Azure Databricks. يتم دعم الأداة المساعدة للمكتبة فقط على Databricks Runtime وليس Databricks Runtime ML. راجع الأداة المساعدة للمكتبة (dbutils.library) (قديم).
%pip الأمر مكافئ لأمر pip ويدعم نفس واجهة برمجة التطبيقات. تعرض الأقسام التالية أمثلة حول كيفية استخدام %pip الأوامر لإدارة بيئتك. لمزيد من المعلومات حول تثبيت حزم Python باستخدام pip راجع وثائق تثبيت pip والصفحات ذات الصلة.
لا يمكنك إلغاء تثبيت مكتبة مضمنة في إصدارات ملاحظات إصدار Databricks Runtime والتوافق أو مكتبة تم تثبيتها كمكتبة نظام مجموعة. إذا قمت بتثبيت إصدار مكتبة مختلف عن الإصدار المضمن في Databricks Runtime أو الإصدار المثبت على نظام المجموعة يمكنك استخدام %pip uninstall لإعادة المكتبة إلى الإصدار الافتراضي في Databricks Runtime أو الإصدار المثبت على نظام المجموعة ولكن لا يمكنك استخدام %pip أمر لإلغاء تثبيت إصدار مكتبة مضمن في Databricks Runtime أو مثبت على نظام المجموعة.
يمكنك إضافة معلمات إلى عنوان URL لتحديد أشياء مثل الإصدار أو الدليل الفرعي git. راجع دعم VCS لمزيد من المعلومات وعلى سبيل المثال باستخدام أنظمة التحكم في الإصدار الأخرى.
يدعم Pip تثبيت الحزم من مصادر خاصة مع المصادقة الأساسية بما في ذلك أنظمة التحكم في الإصدار الخاص ومستودعات الحزم الخاصة مثل Nexus و Artifactory. تتوفر إدارة البيانات السرية عبر Databricks Secrets API والتي تسمح لك بتخزين رموز المصادقة المميزة وكلمات المرور. استخدم واجهة برمجة تطبيقات DBUtils للوصول إلى البيانات السرية من دفتر ملاحظاتك. لاحظ أنه يمكنك استخدام $variables في الأوامر السحرية.
يمكن لأي مستخدم مساحة عمل تعديل الملفات المخزنة في DBFS. توصي Azure Databricks بتخزين الملفات في مساحات العمل أو على وحدات تخزين كتالوج Unity.
عند تحميل ملف إلى DBFS فإنه يعيد تسمية الملف تلقائيا ويستبدل المسافات والنقاط والواصلات بتسطير أسفل السطر. بالنسبة لملفات عجلة Python pip يتطلب استخدام اسم الملف لفترات في الإصدار (على سبيل المثال 0.1.0) والواصلات بدلا من المسافات أو التسطير السفلي لذلك لا يتم تغيير أسماء الملفات هذه.
عند تحميل ملف إلى وحدة تخزين يقوم تلقائيا بإعادة تسمية الملف واستبدال المسافات والنقاط والواصلات بتسطير أسفل السطر. بالنسبة لملفات عجلة Python pip يتطلب استخدام اسم الملف لفترات في الإصدار (على سبيل المثال 0.1.0) والواصلات بدلا من المسافات أو التسطير السفلي لذلك لا يتم تغيير أسماء الملفات هذه.
يجب أن تكون أي دلائل فرعية في مسار الملف موجودة بالفعل. إذا قمت بتشغيل %pip freeze > /Workspace//requirements.txt يفشل الأمر إذا لم يكن الدليل /Workspace/ موجودا بالفعل.
قد يؤدي استخدام المكتبات ذات نطاق دفتر الملاحظات إلى المزيد من نسبة استخدام الشبكة إلى عقدة برنامج التشغيل لأنها تعمل للحفاظ على البيئة متسقة عبر عقد المنفذ.
%shوتنفيذ ! أمر shell في دفتر ملاحظات الأول هو أمر سحري مساعد Databricks بينما الأخير هو ميزة من ميزات IPython. pip هو اختصار عند %pipتمكين automagic وهو الافتراضي في دفاتر ملاحظات Azure Databricks Python.
في Databricks Runtime 11.3 LTS وما فوق و %pip%sh pipوكلها !pip تثبت مكتبة كمكتبة Python ذات نطاق دفتر ملاحظات. في Databricks Runtime 10.4 LTS والإدناه توصي Databricks باستخدام المكتبات ذات نطاق دفتر الملاحظات فقط %pip أو pip تثبيتها. سلوك %sh pip و !pip غير متناسق في Databricks Runtime 10.4 LTS وما دونه.
03c5feb9e7