configure مجموعة الأوامر
إشعار
تنطبق هذه المعلومات على إصدارات Databricks CLI 0.205 والإصدارات الأحدث، الموجودة في المعاينة العامة. للعثور على إصدار Databricks CLI الخاص بك، قم بتشغيل databricks -v.
configure تمكنك مجموعة الأوامر داخل Databricks CLI من مصادقة Databricks CLI مع Azure Databricks باستخدام رموز الوصول الشخصية Azure Databricks أو رموز Microsoft Entra ID (المعروف سابقا ب Azure Active Directory).
إشعار
كأفضل ممارسة أمان، عند المصادقة باستخدام الأدوات والأنظمة والبرامج النصية والتطبيقات التلقائية، توصي Databricks باستخدام رموز الوصول الشخصية التي تنتمي إلى كيانات الخدمة بدلا من مستخدمي مساحة العمل. لإنشاء رموز مميزة لكيانات الخدمة، راجع إدارة الرموز المميزة لكيان الخدمة.
لاحظ أن هذه المقالة تغطي فقط رمز الوصول الشخصي Azure Databricks ومصادقة الرمز المميز لمعرف Microsoft Entra لتمكين استدعاء الأوامر على مستوى مساحة العمل. للحصول على خيارات تكوين مصادقة إضافية، راجع المصادقة ل Databricks CLI.
هام
قبل تشغيل هذا الأمر، تأكد من إعداد Databricks CLI.
يمكنك تشغيل configure الأوامر عن طريق إلحاقها ب databricks configure. لعرض تعليمات الأمر configure ، قم بتشغيل databricks configure -h.
إنشاء ملف تعريف تكوين
ملف تعريف التكوين هو مجموعة من الإعدادات التي تحتوي على معلومات المصادقة مثل عنوان URL لمساحة عمل Azure Databricks وقيمة الرمز المميز للوصول. يحتوي ملف تعريف التكوين على اسم برمجي، مثل DEFAULTأو DEVأو PROD.
لإنشاء ملف تعريف تكوين، قم بتشغيل configure الأمر كما يلي:
databricks configure --host <workspace-url>
بالنسبة إلى <workspace-url>، أدخل عنوان URL لكل مساحة عمل، بالتنسيق https://adb-<workspace-id>.<random-number>.azuredatabricks.net. للحصول على عنوان URL لكل مساحة عمل، راجع عنوان URL لكل مساحة عمل.
يطالبك الأمر بإدخال رمز الوصول الشخصي Azure Databricks أو الرمز المميز لمعرف Microsoft Entra (المعروف سابقا ب Azure Active Directory) الذي يعين إلى <workspace-url>المحدد :
✔ Databricks Token:
بعد إدخال الرمز المميز للوصول الخاص بك، يتم تخزين رمز الوصول الخاص بك في الملف ~/.databrickscfg على Linux أو macOS، أو %USERPROFILE%\.databrickscfg على Windows بشكل افتراضي. يحتوي الملف على إدخال ملف تعريف اتصال افتراضي يسمى DEFAULT:
[DEFAULT]
host = <workspace-url>
token = <access-token>
لاستخدام اسم مختلف لملف تعريف الاتصال بدلا من DEFAULT، أضف --profile الخيار إلى configure الأمر ، على سبيل المثال:
databricks configure --host <workspace-url> --profile <profile-name>
تلميح
يمكنك الضغط Tab بعد --profile أو -p لعرض قائمة بملفات تعريف التكوين المتوفرة الحالية للاختيار من بينها، بدلا من إدخال اسم ملف تعريف التكوين يدويا.
تتم الكتابة فوق أي معلومات مضيف ورمز مميز موجودة داخل ملف تعريف الاتصال المحدد بمعلومات المضيف والرمز المميز الجديد.
تمكنك إضافة ملفات تعريف اتصال متعددة إلى .databrickscfg الملف من تشغيل الأوامر بسرعة عبر مساحات عمل مختلفة عن طريق تحديد اسم ملف تعريف الاتصال الهدف في خيار الأمر --profile . إذا لم تحدد الخيار في --profile أمر يدعم هذا الخيار، فسيستخدم DEFAULT الأمر ملف تعريف الاتصال بشكل افتراضي.
على سبيل المثال، يمكن أن يكون لديك ملف تعريف اتصال يسمى DEV يشير إلى مساحة عمل Azure Databricks التي تستخدمها لأحمال عمل التطوير وملف تعريف اتصال منفصل يسمى PROD ملف تعريف الاتصال الذي يشير إلى مساحة عمل Azure Databricks مختلفة تستخدمها لأحمال عمل الإنتاج.
يمكنك تغيير المسار الافتراضي لهذا .databrickscfg الملف عن طريق تعيين متغير DATABRICKS_CONFIG_FILEالبيئة . لمعرفة كيفية تعيين متغيرات البيئة، راجع وثائق نظام التشغيل الخاص بك.
للحصول على معلومات حول ملفات تعريف التكوين الموجودة، استخدم مجموعة أوامر المصادقة.