مشاركة عبر

ملفات تعريف التكوين ل Databricks CLI

  • مقالة

إشعار

تنطبق هذه المعلومات على إصدارات Databricks CLI 0.205 والإصدارات الأحدث. Databricks CLI في المعاينة العامة.

يخضع استخدام Databricks CLI لترخيص Databricks وإشعار خصوصية Databricks، بما في ذلك أي أحكام لبيانات الاستخدام.

توضح هذه المقالة كيفية إعداد المصادقة بين Databricks CLI وحسابات Azure Databricks ومساحات العمل. راجع ما هو Databricks CLI؟.

تفترض هذه المقالة أنك قمت بالفعل بتثبيت Databricks CLI وإعداد CLI للمصادقة. راجع:

الحصول على معلومات حول ملفات تعريف التكوين

تمكنك إضافة ملفات تعريف تكوين متعددة إلى .databrickscfg الملف من تشغيل الأوامر بسرعة عبر مساحات عمل مختلفة عن طريق تحديد اسم ملف تعريف التكوين الهدف في الأمر --profile أو -p الخيار، لتلك الأوامر التي تدعم هذا الخيار. إذا لم تحدد --profile الخيار أو -p في أمر يدعم هذا الخيار، فسيستخدم DEFAULT الأمر ملف تعريف التكوين بشكل افتراضي.

تلميح

يمكنك الضغط Tab بعد --profile أو -p لعرض قائمة بملفات تعريف التكوين المتوفرة الحالية للاختيار من بينها، بدلا من إدخال اسم ملف تعريف التكوين يدويا.

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

بشكل افتراضي، يبحث Databricks CLI عن .databrickscfg الملف في ~ مجلد (الصفحة الرئيسية للمستخدم) على Unix أو Linux أو macOS أو %USERPROFILE% مجلد (الصفحة الرئيسية للمستخدم) على Windows. يمكنك تغيير المسار الافتراضي للملف .databrickscfg عن طريق تعيين متغير DATABRICKS_CONFIG_FILEالبيئة . لمعرفة كيفية تعيين متغيرات البيئة، راجع وثائق نظام التشغيل الخاص بك.

للحصول على معلومات حول ملف تعريف تكوين موجود، قم بتشغيل auth env الأمر :

databricks auth env --profile <configuration-profile-name>

# Or:
databricks auth env --host <account-console-url>

# Or:
databricks auth env --host <workspace-url>

على سبيل المثال، فيما يلي إخراج ملف تعريف تم تكوينه باستخدام مصادقة رمز الوصول الشخصي Azure Databricks:

{
  "env": {
    "DATABRICKS_AUTH_TYPE": "pat",
    "DATABRICKS_CONFIG_PROFILE": "<configuration-profile-name>",
    "DATABRICKS_HOST": "<workspace-url>",
    "DATABRICKS_TOKEN": "<token-value>"
  }
}

للحصول على معلومات حول جميع ملفات التعريف المتوفرة auth profiles ، قم بتشغيل الأمر:

databricks auth profiles

الإخراج (تمثل علامات الحذف محتوى محذفا، للإيجاز):

{
  "profiles": [
    {
      "name": "<configuration-profile-name>",
      "host": "<workspace-url>",
      "cloud": "<cloud-id>",
      "auth_type": "<auth-type>",
      "valid": true
    },
    {
      "...": "..."
    }
  ]
}

لا يعرض إخراج auth profiles الأمر أي رموز مميزة للوصول. لعرض رمز مميز للوصول، قم بتشغيل الأمر السابق auth env .

هام

لا يعمل Databricks CLI مع ملف .netrc. يمكنك الحصول على .netrc ملف في بيئتك لأغراض أخرى، ولكن لن يستخدم Databricks CLI هذا .netrc الملف.

اختبار إعداد ملف تعريف التكوين الافتراضي

للتحقق مما إذا كنت تقوم بإعداد المصادقة بشكل صحيح، يمكنك تشغيل أمر مثل ما يلي، والذي يسرد إصدارات وقت تشغيل Databricks المتوفرة لمساحة عمل Azure Databricks المقترنة بملف التعريف الخاص بك DEFAULT .

يفترض الاستدعاء التالي أنه ليس لديك أي مجموعة متغيرات بيئة خاصة، والتي لها الأسبقية على الإعدادات في ملف التعريف الخاص بك DEFAULT . لمزيد من المعلومات، راجع ترتيب المصادقة للتقييم.

databricks clusters spark-versions

اختبار ملفات تعريف التكوين الخاصة بك

للتحقق مما إذا كنت تقوم بإعداد أي ملفات تعريف تكوين بشكل صحيح، يمكنك تشغيل أمر مثل ما يلي باستخدام أحد أسماء ملفات تعريف التكوين على مستوى مساحة العمل. يسرد هذا الأمر إصدارات وقت تشغيل Databricks المتوفرة لمساحة عمل Azure Databricks المقترنة بملف تعريف التكوين المحدد، ممثلة هنا بواسطة العنصر <configuration-profile-name>النائب :

databricks clusters spark-versions -p <configuration-profile-name>

تلميح

يمكنك الضغط Tab بعد --profile أو -p لعرض قائمة بملفات تعريف التكوين المتوفرة الحالية للاختيار من بينها، بدلا من إدخال اسم ملف تعريف التكوين يدويا.

لسرد تفاصيل ملف تعريف معين، قم بتشغيل الأمر التالي:

databricks auth env --profile <configuration-profile-name>

لسرد تفاصيل جميع ملفات التعريف المتوفرة، قم بتشغيل الأمر التالي:

databricks auth profiles