مكتبات مساحة العمل (قديمة)

  • مقالة

هام

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

إشعار

تم إهمال مكتبات مساحة العمل ولا ينبغي استخدامها. ومع ذلك، فإن تخزين المكتبات كملفات مساحة عمل مميز عن مكتبات مساحة العمل ولا يزال مدعوما بالكامل. يمكنك تثبيت المكتبات المخزنة كملفات مساحة عمل مباشرة لحساب المهام أو مهامها.

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

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

تتوفر مكتبات مساحة العمل في المجلد Shared لجميع المستخدمين في مساحة العمل، بينما تتوفر مكتبات مساحة العمل في مجلد مستخدم لهذا المستخدم فقط.

هام

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

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

كيف تختلف مكتبات مساحة العمل عن المكتبات المخزنة مع ملفات مساحة العمل؟

يشير مصطلح "مكتبات مساحة العمل" إلى أي مكتبة مسجلة في مساحة عمل. تظهر مكتبات مساحة العمل جنبا إلى جنب مع دفاتر الملاحظات وملفات مساحة العمل واتبع قواعد ACL للدليل الذي يحتوي عليها.

يشير مصطلح "ملفات مساحة العمل" إلى أي ملف عشوائي مخزن في مساحة العمل. يمكنك تخزين حزم Python .whl كملفات مساحة عمل ثم تسجيلها كمكتبات مساحة عمل. راجع ما هي ملفات مساحة العمل؟.

يمكنك تحميل المكتبات كملفات مساحة عمل. راجع الاستخدام الأساسي لملفات مساحة العمل.

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

في Databricks Runtime 13.3 LTS وما فوق، يمكنك استخدام %pip لتثبيت ملفات عجلة Python المخزنة كملفات مساحة عمل. راجع تثبيت حزمة مخزنة كملف مساحة عمل باستخدام ٪pip.

إنشاء مكتبة مساحة عمل

تحذير

لم تعد هذه الوظيفة متوفرة. راجع لم يعد إنشاء مكتبات مساحة العمل وتثبيتها متوفرا.

  1. انقر بزر الماوس الأيمن فوق مجلد مساحة العمل حيث تريد تخزين المكتبة.
  2. حدد إنشاء > مكتبة. يظهر مربع الحوار إنشاء مكتبة.
  3. حدد مصدر المكتبة واتبع الإجراء المناسب:

تحميل ملف عجلة Jar أو Python أو Python

إشعار

يتم إهمال تثبيت ملفات بيض Python وستتم إزالتها في إصدار وقت تشغيل Databricks في المستقبل.

هام

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

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

  1. في قائمة الزر مصدر المكتبة، حدد تحميل.
  2. حدد Jar أو Python Egg أو Python Whl.
  3. أدخل اسم مكتبة اختياريا.
  4. اسحب Jar أو Egg أو Whl إلى مربع الإفلات أو انقر فوق مربع الإفلات وانتقل إلى ملف. يتم تحميل الملف إلى dbfs:/FileStore/jars.
  5. انقر فوق Create. تظهر شاشة حالة المكتبة.

الرجوع إلى ملف JAR أو Python أو ملف عجلة Python الذي تم تحميله

يمكنك إنشاء مكتبة مساحة عمل جديدة عن طريق الرجوع إلى JAR أو بيضة Python أو ملفات عجلة Python المخزنة في جذر DBFS أو على تخزين الكائن أو مع ملفات مساحة العمل. يؤدي اتباع سير العمل هذا إلى تسجيل مؤشر إلى مكتبة دون تحميل الملفات أو نقلها.

باستخدام Databricks Runtime 13.2 وما فوق، يمكنك أيضا الرجوع إلى وحدة تخزين في كتالوج Unity. هذه الإمكانية في المعاينة العامة.

بالنسبة لوضع الوصول المشترك، يجب إضافة JARs إلى allowlist. راجع Allowlist libraries and init scripts on shared compute.

  1. حدد مسار الملف/ADLS في قائمة زر مصدر المكتبة.
  2. حدد Jar أو Python Egg أو Python Whl.
  3. أدخل اسم مكتبة اختياريا.
  4. حدد المسار إلى المكتبة، مثل الأمثلة التالية:
    • abfss://container-name@storage-account-name.dfs.core.windows.net/path/to/library.whl
    • /Workspace/path/to/library.whl
    • dbfs:/path/to/library.whl
    • /Volumes/<catalog>/<schema>/<volume>/<path_to_library_file>
  5. انقر فوق Create. تظهر شاشة حالة المكتبة.

لمزيد من المعلومات حول العمل مع المكتبات في تخزين الكائنات، راجع تثبيت المكتبات من تخزين الكائنات.

لمزيد من المعلومات حول ملفات مساحة العمل، راجع العمل مع الملفات على Azure Databricks.

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

إشعار

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

هام

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

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

في وضع وصول مستخدم واحد، يتم استخدام هوية الأساسي المعين (مستخدم أو كيان خدمة). في وضع الوصول المشترك، تستخدم المكتبات هوية المستخدم الذي قام بتثبيت المكتبة. لا يدعم وضع الوصول المشترك بدون عزل وحدات التخزين، ولكنه يستخدم نفس تعيين الهوية مثل وضع الوصول المشترك.

للاطلاع على جميع الخيارات لتثبيت المكتبات على أنظمة المجموعات، راجع مكتبات نظام المجموعة.

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

نظام المجموعة

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

مكتبة

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

عرض تفاصيل مكتبة مساحة العمل

إشعار

توفر مجلدات مساحة العمل الراحة لاكتشاف مكتبات مساحة العمل وإدارة قوائم التحكم في الوصول.

  1. انتقل إلى مجلد مساحة العمل الذي يحتوي على المكتبة.
  2. انقر فوق اسم المكتبة.

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

نقل مكتبة مساحة عمل

إشعار

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

  1. انتقل إلى مجلد مساحة العمل الذي يحتوي على المكتبة.
  2. انقر بزر الماوس الأيمن فوق اسم المكتبة وحدد نقل. يتم عرض مستعرض مجلد.
  3. انقر فوق المجلد الوجهة.
  4. انقر فوق نقل.

حذف مكتبة مساحة عمل

هام

قبل حذف مكتبة مساحة عمل، يجب إلغاء تثبيتها من كافة المجموعات.

لحذف مكتبة مساحة عمل:

  1. نقل المكتبة إلى مجلد سلة المهملات.
  2. إما حذف المكتبة نهائيا في مجلد سلة المهملات أو إفراغ مجلد سلة المهملات.