مشاركة عبر

الحصول على معرفات لكائنات مساحة العمل

  • مقالة

تشرح هذه المقالة كيفية الحصول على مساحة العمل، الكتلة، الدليل، النموذج، دفتر الملاحظات، ومعرفات الوظائف وعناوين URL في Azure Databricks.

أسماء مثيلات مساحة العمل وعناوين URL ومعرفاتها

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

مساحة عمل Azure Databricks هي المكان الذي تعمل فيه منصة Azure Databricks وحيث يمكنك إنشاء مجموعات Spark وجدولة أحمال العمل. تحتوي مساحة العمل على معرف مساحة عمل رقمي فريد.

عنوان URL لكل مساحة عمل

يحتوي عنوان URL الفريد لكل مساحة عمل على التنسيق adb-<workspace-id>.<random-number>.azuredatabricks.net. يظهر معرف مساحة العمل مباشرة بعد adb- وقبل "النقطة" (.). بالنسبة إلى عنوان URL https://adb-5555555555555555.19.azuredatabricks.net/لكل مساحة عمل:

  • اسم المثيل هو adb-5555555555555555.19.azuredatabricks.net.
  • معرف مساحة العمل هو 5555555555555555.

تحديد عنوان URL لكل مساحة عمل

يمكنك تحديد عنوان URL لكل مساحة عمل لمساحة العمل الخاصة بك:

عنوان URL الإقليمي القديم

هام

تجنب استخدام عناوين URL الإقليمية القديمة. قد لا تعمل لمساحات عمل جديدة، وتكون أقل موثوقية، وتظهر أداء أقل من عناوين URL لكل مساحة عمل.

يتكون عنوان URL الإقليمي القديم من المنطقة التي يتم فيها نشر مساحة عمل Azure Databricks بالإضافة إلى المجال azuredatabricks.net، على سبيل المثال، https://westus.azuredatabricks.net/.

  • إذا قمت بتسجيل الدخول إلى عنوان URL إقليمي قديم مثل https://westus.azuredatabricks.net/، فإن اسم المثيل هو westus.azuredatabricks.net.
  • يظهر معرف مساحة العمل في عنوان URL فقط بعد تسجيل الدخول باستخدام عنوان URL إقليمي قديم. يظهر بعد o=. في عنوان URL https://<databricks-instance>/?o=6280049833385130، معرف مساحة العمل هو 6280049833385130.

عنوان URL للمجموعة ومعرفها

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

للحصول على معرف نظام المجموعة، انقر فوق علامة التبويب Clusters في الشريط الجانبي ثم حدد اسم نظام المجموعة. معرف نظام المجموعة هو الرقم بعد /clusters/ المكون في عنوان URL لهذه الصفحة

https://<databricks-instance>/#/setting/clusters/<cluster-id>

في لقطة الشاشة التالية، معرف نظام المجموعة هو 0831-211914-clean632.

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

عنوان URL لدفتر الملاحظات ومعرفه

دفتر الملاحظات هو واجهة مستندة إلى الويب لمستند يحتوي على تعليمات برمجية قابلة للتشغيل وتصورات ونص سردي. دفاتر الملاحظات هي واجهة واحدة للتفاعل مع Azure Databricks. يحتوي كل دفتر ملاحظات على معرف فريد. يحتوي عنوان URL لدفتر الملاحظات على معرف دفتر الملاحظات، ومن ثم يكون عنوان URL لدفتر الملاحظات فريدا لدفتر الملاحظات. يمكن مشاركته مع أي شخص على النظام الأساسي Azure Databricks مع إذن لعرض دفتر الملاحظات وتحريره. بالإضافة إلى ذلك، يحتوي كل أمر دفتر ملاحظات (خلية) على عنوان URL مختلف.

للبحث عن عنوان URL أو معرف دفتر ملاحظات، افتح دفتر ملاحظات. للبحث عن عنوان URL للخلية، انقر فوق محتويات الأمر.

  • مثال على عنوان URL لدفتر الملاحظات:

    https://adb-62800498333851.30.azuredatabricks.net/?o=6280049833385130#notebook/1940481404050342`

  • مثال معرف دفتر الملاحظات: 1940481404050342.

  • مثال على عنوان URL للأمر (الخلية):

    https://adb-62800498333851.30.azuredatabricks.net/?o=6280049833385130#notebook/1940481404050342/command/2432220274659491

معرف المجلد

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

لاسترداد directory_id ، استخدم واجهة برمجة تطبيقات مساحة العمل:

curl -n -X GET -H 'Content-Type: application/json' -d '{"path": "/Users/me@example.com/MyFolder"}' \
https://<databricks-instance>/api/2.0/workspace/get-status

هذا مثال على استجابة استدعاء واجهة برمجة التطبيقات:

{
  "object_type": "DIRECTORY",
  "path": "/Users/me@example.com/MyFolder",
  "object_id": 123456789012345
}

معرف النموذج

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

للحصول على معرف نموذج مسجل، يمكنك استخدام نقطة mlflow/databricks/registered-models/getنهاية واجهة برمجة تطبيقات مساحة العمل . على سبيل المثال، ترجع التعليمات البرمجية التالية كائن النموذج المسجل بخصائصه، بما في ذلك معرفه:

curl -n -X GET -H 'Content-Type: application/json' -d '{"name": "model_name"}' \
https://<databricks-instance>/api/2.0/mlflow/databricks/registered-models/get

تحتوي القيمة التي تم إرجاعها على التنسيق:

{
  "registered_model_databricks": {
    "name":"model_name",
    "id":"ceb0477eba94418e973f170e626f4471"
  }
}

عنوان URL للمهمة ومعرفها

الوظيفة هي طريقة لتشغيل دفتر ملاحظات أو JAR إما على الفور أو على أساس مجدول.

للحصول على عنوان URL لوظيفة، انقر فوق أيقونة مهام سير العمل مهام سير العمل في الشريط الجانبي وانقر فوق اسم وظيفة. معرف الوظيفة هو بعد النص #job/ في عنوان URL. عنوان URL للوظيفة مطلوب لاستكشاف السبب الجذري لتشغيل المهمة الفاشلة وإصلاحها.

في لقطة الشاشة التالية، عنوان URL للوظيفة هو:

https://westus.azuredatabricks.net/?o=6280049833385130#job/1

في هذا المثال، معرف الوظيفة هو 1.

عنوان URL للوظيفة