مكتبات نظام المجموعة

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

إشعار

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

يمكنك تثبيت المكتبات على نظام مجموعة باستخدام الأساليب التالية:

• تثبيت مكتبة للاستخدام مع مجموعة معينة فقط.

• تثبيت مكتبة باستخدام واجهة برمجة تطبيقات REST. راجع واجهة برمجة تطبيقات المكتبات.

• تثبيت مكتبة باستخدام Databricks CLI. راجع ما هو Databricks CLI؟.

• تثبيت مكتبة باستخدام Terraform. راجع موفر Databricks Terraform databricks_library.

• قم بتثبيت مكتبة عن طريق إنشاء نظام مجموعة باستخدام نهج يحدد عمليات تثبيت المكتبة. راجع إضافة مكتبات إلى نهج.

• (غير مستحسن) تثبيت مكتبة باستخدام برنامج نصي init يعمل في وقت إنشاء نظام المجموعة. راجع تثبيت مكتبة مع برنامج نصي init (قديم) .

تثبيت مكتبة على نظام مجموعة

لتثبيت مكتبة على نظام مجموعة:

1. انقر فوق حساب في الشريط الجانبي.
2. انقر فوق اسم نظام المجموعة.
3. انقر فوق علامة التبويب مكتبات.
4. انقر فوق تثبيت جديد.
5. يتم عرض مربع الحوار تثبيت المكتبة.
6. حدد أحد خيارات مصدر المكتبة، وأكمل الإرشادات التي تظهر، ثم انقر فوق تثبيت.

هام

يمكن تثبيت المكتبات من DBFS عند استخدام Databricks Runtime 14.3 LTS وما دونه. ومع ذلك، يمكن لأي مستخدم مساحة عمل تعديل ملفات المكتبة المخزنة في DBFS. لتحسين أمان المكتبات في مساحة عمل Azure Databricks، يتم إهمال تخزين ملفات المكتبات في جذر DBFS وتعطيلها بشكل افتراضي في Databricks Runtime 15.0 وما فوق. راجع إهمال وتعطيل تخزين المكتبات في جذر DBFS بشكل افتراضي.

بدلا من ذلك، توصي Databricks بتحميل جميع المكتبات، بما في ذلك مكتبات Python وملفات JAR وموصلات Spark، إلى ملفات مساحة العمل أو وحدات تخزين كتالوج Unity، أو استخدام مستودعات حزم المكتبات. إذا كان حمل العمل الخاص بك لا يدعم هذه الأنماط، يمكنك أيضا استخدام المكتبات المخزنة في تخزين الكائنات السحابية.

لا تدعم كافة أوضاع الوصول إلى نظام المجموعة كافة تكوينات المكتبة. راجع المكتبات ذات نطاق نظام المجموعة.

مصدر المكتبة	الإرشادات
مساحه عمل	حدد ملف مساحة عمل أو حمل ملف Whl أو العجلة المضغوطة أو JAR أو ZIP أو tar أو requirements.txt. راجع تثبيت المكتبات من ملفات مساحة العمل
وحدات التخزين	حدد ملف Whl أو JAR أو requirements.txt من وحدة تخزين. راجع تثبيت المكتبات من وحدة تخزين.
مسار الملف/ADLS	حدد نوع المكتبة وقم بتوفير URI الكامل لكائن المكتبة (على سبيل المثال: /Workspace/path/to/library.whlأو /Volumes/path/to/library.whlأو abfss://container-name@storage-account-name.dfs.core.windows.net/path/to/library.whl). راجع تثبيت المكتبات من تخزين الكائنات.
PyPI	أدخل اسم حزمة PyPI. راجع حزمة PyPI.
Maven	حدد إحداثيات Maven. راجع حزمة Maven أو Spark.
CRAN	أدخل اسم الحزمة. راجع حزمة CRAN.
DBFS (غير مستحسن)	تحميل ملف JAR أو Whl إلى جذر DBFS. هذا غير مستحسن، حيث يمكن تعديل الملفات المخزنة في DBFS من قبل أي مستخدم مساحة عمل.

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

تثبيت مكتبة باستخدام نهج

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

يمكن لمسؤولي مساحة العمل إضافة مكتبات إلى النهج، ما يسمح لهم بإدارة عمليات تثبيت المكتبة وفرضها على جميع الحوسبة التي تستخدم النهج. للحصول على إرشادات المسؤول، راجع إضافة مكتبات إلى نهج.

إلغاء تثبيت مكتبة من نظام مجموعة

إشعار

عند إلغاء تثبيت مكتبة من نظام مجموعة، تتم إزالة المكتبة فقط عند إعادة تشغيل نظام المجموعة. حتى تقوم بإعادة تشغيل نظام المجموعة، تظهر حالة المكتبة غير المثبتة كإزالة تثبيت معلق إعادة التشغيل.

لإلغاء تثبيت مكتبة، يمكنك استخدام واجهة مستخدم نظام المجموعة:

1. انقر فوق حساب في الشريط الجانبي.
2. انقر فوق اسم نظام المجموعة.
3. انقر فوق علامة التبويب مكتبات.
4. حدد خانة الاختيار بجوار المجموعة التي تريد إلغاء تثبيت المكتبة منها، وانقر فوق إلغاء التثبيت، ثم تأكيد. تتغير الحالة إلى إلغاء تثبيت إعادة التشغيل المعلقة.

انقر فوق إعادة التشغيل والتأكيد لإلغاء تثبيت المكتبة. تتم إزالة المكتبة من علامة تبويب المكتبات الخاصة بالمجموعة.

عرض المكتبات المثبتة على نظام مجموعة

1. انقر فوق حساب في الشريط الجانبي.
2. انقر فوق اسم نظام المجموعة.
3. انقر فوق علامة التبويب مكتبات. لكل مكتبة، تعرض علامة التبويب الاسم والإصدار، والنوع، وحالة التثبيت، والملف المصدر، إذا تم تحميله.

تحديث مكتبة مثبتة على نظام المجموعة

لتحديث مكتبة مثبتة على نظام المجموعة، قم بإلغاء تثبيت الإصدار القديم من المكتبة وتثبيت إصدار جديد.

إشعار

لا تتطلب الملفات Requirements.txt إلغاء التثبيت وإعادة التشغيل. إذا قمت بتعديل محتويات ملف requirements.txt، يمكنك ببساطة إعادة تثبيته لتحديث محتويات الملف المثبت.