مشاركة عبر

البرنامج التعليمي ل Databricks CLI

  • مقالة

إشعار

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

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

توفر واجهة سطر الأوامر Databricks (المعروفة أيضا باسم Databricks CLI) واجهة سهلة الاستخدام لأتمتة النظام الأساسي Azure Databricks من المحطة الطرفية أو موجه الأوامر أو البرامج النصية التلقائية.

توضح هذه المقالة كيفية استخدام جهاز التطوير المحلي للبدء بسرعة مع Databricks CLI. راجع ما هو Databricks CLI؟.

يفترض البرنامج التعليمي العملي التالي:

  • بالنسبة إلى Linux أو macOS، لديك Homebrew مثبت.

    إشعار

    إذا لم تتمكن من استخدام Homebrew، للحصول على طرق أخرى لتثبيت CLI، راجع تثبيت Databricks CLI أو تحديثه.

  • بالنسبة إلى Windows، لديك winget أو Chocolatey أو نظام Windows الفرعي لـ Linux (WSL) مثبت. للحصول على إرشادات التثبيت، راجع وثائق نظام التشغيل.

    إشعار

    تثبيت Databricks CLI مع Chocolatey تجريبي.

    إذا لم تتمكن من استخدام wingetأو Chocolatey أو WSL، للحصول على طرق أخرى لتثبيت CLI، راجع تثبيت Databricks CLI أو تحديثه.

أكمل الخطوات التالية:

  1. إذا لم يكن مثبتا بالفعل، فقم بتثبيت Databricks CLI كما يلي:

    Linux وmacOS

    استخدم Homebrew لتثبيت Databricks CLI عن طريق تشغيل الأمرين التاليين:

    brew tap databricks/tap
brew install databricks

    Windows

    يمكنك استخدام winget أو Chocolatey أو نظام Windows الفرعي لـ Linux (WSL) لتثبيت Databricks CLI. إذا لم تتمكن من استخدام wingetأو Chocolatey أو WSL، يجب تخطي هذا الإجراء واستخدام موجه الأوامر أو PowerShell لتثبيت Databricks CLI من المصدر بدلا من ذلك.

    إشعار

    تثبيت Databricks CLI مع Chocolatey تجريبي.

    لاستخدام winget لتثبيت Databricks CLI، قم بتشغيل الأمرين التاليين، ثم أعد تشغيل موجه الأوامر:

    winget search databricks
winget install Databricks.DatabricksCLI

    لاستخدام Chocolatey لتثبيت Databricks CLI، قم بتشغيل الأمر التالي:

    choco install databricks-cli

    لاستخدام WSL لتثبيت Databricks CLI:

    1. تثبيت curl ومن zip خلال WSL. لمزيد من المعلومات، راجع وثائق نظام التشغيل الخاص بك.

    2. استخدم WSL لتثبيت Databricks CLI عن طريق تشغيل الأمر التالي:

      curl -fsSL https://raw.githubusercontent.com/databricks/setup-cli/main/install.sh | sh

  2. تأكد من تثبيت Databricks CLI عن طريق تشغيل الأمر التالي، والذي يعرض الإصدار الحالي من Databricks CLI المثبت. يجب أن يكون هذا الإصدار 0.205.0 أو أعلى:

    databricks -v

    إشعار

    إذا قمت بتشغيل databricks ولكن تلقيت خطأ مثل command not found: databricks، أو إذا قمت بتشغيل databricks -v وكان رقم الإصدار 0.18 أو أدناه مدرجا، فهذا يعني أن جهازك لا يمكنه العثور على الإصدار الصحيح من Databricks CLI القابل للتنفيذ. لإصلاح ذلك، راجع التحقق من تثبيت CLI.

بعد تثبيت Databricks CLI، أكمل الخطوات التالية:

إشعار

يفترض هذا البرنامج التعليمي أنك تريد استخدام مصادقة OAuth من مستخدم إلى جهاز (U2M) لمصادقة CLI باستخدام حساب مستخدم Azure Databricks. لتكوين CLI لاستخدام أنواع مصادقة Databricks الأخرى، راجع المصادقة ل Databricks CLI.

  1. استخدم Databricks CLI لبدء إدارة الرمز المميز OAuth محليا عن طريق تشغيل الأمر التالي لكل حساب هدف أو مساحة عمل.

    بالنسبة للعمليات على مستوى الحساب، في الأمر التالي، استبدل العناصر النائبة التالية:

    databricks auth login --host <account-console-url> --account-id <account-id>

    بالنسبة للعمليات على مستوى مساحة العمل، في الأمر التالي، استبدل <workspace-url> بعنوان URL Azure Databricks لكل مساحة عمل، على سبيل المثال https://adb-1234567890123456.7.azuredatabricks.net.

    databricks auth login --host <workspace-url>

  2. يطالبك Databricks CLI بحفظ المعلومات التي أدخلتها كملف تعريف تكوين Azure Databricks. اضغط Enter لقبول اسم ملف التعريف المقترح، أو أدخل اسم ملف تعريف جديد أو موجود. تتم الكتابة فوق أي ملف تعريف موجود بنفس الاسم بالمعلومات التي أدخلتها. يمكنك استخدام ملفات التعريف لتبديل سياق المصادقة بسرعة بين حسابات أو مساحات عمل متعددة.

    للحصول على قائمة بأي ملفات تعريف موجودة، في محطة طرفية منفصلة أو موجه أوامر، استخدم Databricks CLI لتشغيل الأمر databricks auth profiles. لعرض الإعدادات الموجودة لملف تعريف معين، قم بتشغيل الأمر databricks auth env --profile <profile-name>.

  3. في مستعرض الويب، أكمل الإرشادات التي تظهر على الشاشة لتسجيل الدخول إلى حساب أو مساحة عمل Azure Databricks.

  4. لعرض قيمة رمز OAuth المميز الحالي لملف التعريف والطوابع الزمنية لانتهاء الصلاحية القادمة للرمز المميز، قم بتشغيل أحد الأوامر التالية:

    بالنسبة للعمليات على مستوى الحساب، قم بتشغيل الأوامر التالية:

    • databricks auth token -p <profile-name>
    • databricks auth token --host <workspace-url> --account-id <account-id>
    • databricks auth token --host <workspace-url> --account-id <account-id> -p <profile-name>

    إذا كان لديك ملفات تعريف متعددة بنفس --host القيم والقيم--account-id، فقد تحتاج إلى تحديد --account-id--hostالخيارات و و -p معا لمساعدة Databricks CLI في العثور على معلومات الرمز المميز OAuth المتطابقة الصحيحة.

    بالنسبة للعمليات على مستوى مساحة العمل، قم بتشغيل الأوامر التالية:

    • databricks auth token -p <profile-name>
    • databricks auth token --host <workspace-url>
    • databricks auth token --host <workspace-url> -p <profile-name>

    إذا كان لديك ملفات تعريف متعددة بنفس --host القيم، فقد تحتاج إلى تحديد --host الخيارات و -p معا لمساعدة Databricks CLI في العثور على معلومات الرمز المميز OAuth المتطابقة الصحيحة.

الخطوات التالية

بعد إعداد Databricks CLI: