تثبيت Databricks CLI أو تحديثه

إشعار

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

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

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

تثبيت

لتثبيت Databricks CLI الإصدار 0.205 أو أعلى:

• Linux أو macOS: استخدم Homebrew أو curl أو إصدارات المصدر.
• Windows: استخدم WinGet أو Chocolatey أو نظام Windows الفرعي لـ Linux (WSL) أو إصدارات المصدر.

يتوفر Databricks CLI أيضا من داخل واجهة مستخدم مساحة عمل Azure Databricks. راجع تشغيل أوامر Databricks CLI.

Update

لتحديث تثبيت سابق من Databricks CLI الإصدار 0.205 أو أعلى:

• Linux أو macOS: استخدم Homebrew أو curl أو إصدارات المصدر.
• Windows: استخدم WinGet أو Chocolatey أو نظام Windows الفرعي لـ Linux (WSL) أو إصدارات المصدر.

تثبيت Homebrew لنظام التشغيل Linux أو macOS

بالنسبة لخيار التثبيت هذا، يمكنك استخدام Homebrew لتنزيل وتثبيت أحدث إصدار قابل للتنفيذ ل Databricks CLI تلقائيا.

من المحطة الطرفية الخاصة بك، ما عليك سوى تشغيل الأمرين Homebrew التاليين لتثبيت CLI:

brew tap databricks/tap
brew install databricks

ثم تابع المصادقة ل Databricks CLI.

إذا لم تكن متأكدا مما إذا كان Homebrew مثبتا لديك، أو إذا فشلت أوامر Homebrew السابقة، فاتبع هذه الإرشادات الأطول:

1. تحقق مما إذا كان Homebrew مثبتا بالفعل عن طريق تشغيل الأمر التالي من موجه Linux shell أو macOS Terminal. إذا تم تثبيت Homebrew، يتم عرض رقم إصدار Homebrew:

   brew -v
   

2. إذا لم يكن Homebrew مثبتا بالفعل، فقم بتثبيته عن طريق تشغيل الأمر التالي:

   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
   

   ثم قم بتشغيل الأمر التالي للتحقق من تثبيت Homebrew، والذي يعرض رقم إصدار Homebrew:

   brew -v
   

3. استخدم Homebrew لإضافة مستودع databricks/homebrew-tap في GitHub إلى قائمة مستودعات Homebrew Tap المتوفرة، عن طريق تشغيل الأمر التالي:

   brew tap databricks/tap
   

4. استخدم Homebrew لإرشاد databricks/homebrew-tap المستودع لتنزيل وتثبيت Databricks CLI القابل للتنفيذ، عن طريق تشغيل الأمر التالي:

   brew install databricks
   

5. تأكد من تثبيت Databricks CLI بشكل صحيح. للقيام بذلك، اعرض إصدار Databricks CLI القابل للتنفيذ باستخدام -v الخيار أو عن طريق تشغيل version الأمر:

   databricks -v
   
   # Or:
   databricks version
   

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

   إشعار

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

6. تابع المصادقة ل Databricks CLI.

تثبيت WinGet ل Windows

بالنسبة إلى خيار التثبيت هذا، يمكنك استخدام winget لتنزيل وتثبيت أحدث إصدار قابل للتنفيذ ل Databricks CLI تلقائيا.

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

   winget search databricks
   winget install Databricks.DatabricksCLI
   

2. تأكد من تثبيت Databricks CLI بشكل صحيح. للقيام بذلك، اعرض إصدار Databricks CLI القابل للتنفيذ باستخدام -v الخيار أو عن طريق تشغيل version الأمر:

   databricks -v
   
   # Or:
   databricks version
   

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

   إشعار

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

3. تابع المصادقة ل Databricks CLI.

تثبيت Chocolatey لنظام التشغيل Windows

إشعار

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

بالنسبة إلى خيار التثبيت هذا، يمكنك استخدام Chocolatey لتنزيل وتثبيت أحدث إصدار قابل للتنفيذ من Databricks CLI تلقائيا.

1. من موجه الأوامر، قم بتشغيل الأمر التالي choco لتثبيت CLI:

   choco install databricks-cli
   

2. تأكد من تثبيت Databricks CLI بشكل صحيح. للقيام بذلك، اعرض إصدار Databricks CLI القابل للتنفيذ باستخدام -v الخيار أو عن طريق تشغيل version الأمر:

   databricks -v
   
   # Or:
   databricks version
   

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

   إشعار

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

3. تابع المصادقة ل Databricks CLI.

تثبيت curl ل Linux وmacOS وWindows

بالنسبة لخيار التثبيت هذا، يمكنك استخدام curl لتنزيل وتثبيت أحدث إصدار قابل للتنفيذ ل Databricks CLI.

بالنسبة إلى Windows، توصي Databricks باستخدام نظام Windows الفرعي لـ Linux (WSL). يجب أن تكون قد قمت unzip أيضا بتثبيت. للحصول على إرشادات التثبيت، راجع وثائق نظام التشغيل. إذا لم تتمكن من استخدام WSL، فتخط هذا الإجراء واستخدم موجه الأوامر أو PowerShell لتثبيت Databricks CLI من المصدر بدلا من ذلك.

1. curl يجب تثبيته. يمكنك التحقق مما إذا كان curl مثبتا بالفعل عن طريق تشغيل الأمر التالي من موجه Linux shell أو macOS Terminal أو Bash على WSL. إذا curl تم تثبيته، curl يتم عرض رقم الإصدار:

   curl -V
   

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

   ثم قم بتشغيل الأمر التالي للتحقق من curl التثبيت، والذي يعرض curl رقم الإصدار:

   curl -V
   

3. استخدم curl لتنزيل وتثبيت Databricks CLI القابل للتنفيذ عن طريق تشغيل الأمر التالي (لاحظ أنه يجب عليك تحديد الأحرف الكبيرة والصغيرة الصحيحة على -fsSL جميع أنظمة التشغيل):

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

   إشعار

   لعرض محتويات البرنامج النصي قبل تشغيله، راجع ملف install.sh في مستودع إعداد Databricks CLI في GitHub.

   بالنسبة إلى Windows، يجب تشغيل هذا الأمر كمسؤول.

   بالنسبة إلى Linux وmacOS، إذا كانت رسالة الخطأ تشير إلى أن /usr/local/bin غير قابل للكتابة، فقم بتشغيل الأمر مرة أخرى باستخدام sudo.

   يقوم هذا الأمر بتنزيل وتثبيت Databricks CLI القابل للتنفيذ في المسار /usr/local/bin/databricks على macOS وLinux، وعلى C:\Windows\databricks.exe Windows.

   إذا كان Databricks CLI مثبتا بالفعل لسبب ما، يظهر الخطأ التالي: "المسار <path> الهدف موجود بالفعل." لإصلاح ذلك، يجب حذف Databricks CLI القابل للتنفيذ يدويا من المسار السابق، ثم تشغيل curl الأمر مرة أخرى.

4. تأكد من تثبيت Databricks CLI بشكل صحيح. للقيام بذلك، اعرض إصدار Databricks CLI القابل للتنفيذ باستخدام -v الخيار أو عن طريق تشغيل version الأمر:

   databricks -v
   
   # Or:
   databricks version
   

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

   إشعار

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

5. تابع المصادقة ل Databricks CLI.

تثبيت المصدر ل Linux وmacOS وWindows

بالنسبة لخيار التثبيت هذا، يمكنك تنزيل .zip ملف يدويا ثم استخراج Databricks CLI القابل للتنفيذ يدويا من الملف الذي تم تنزيله .zip .

1. قم بتنزيل أحدث ملف Databricks CLI .zip على جهاز التطوير المحلي، كما هو موضح في قسم Releases في مستودع Databricks CLI في GitHub. يحتوي الإصدار الأخير على Latest تسمية بجانبه في قائمة الإصدارات. أحدث ما قبل الإصدار له Pre-release تسمية وأكثر ملاءمة للتجريب والمتبنين الأوائل. .zip يجب أن يتطابق الملف الذي تقوم بتنزيله Assets من قسم الإصدار مع نظام تشغيل جهاز التطوير الخاص بك وهندسته:

   Filename	بناء الأنظمة
   databricks_cli_X.Y.Z_darwin_amd64.zip	macOS، Intel 64 بت / x86_64
   databricks_cli_X.Y.Z_darwin_arm64.zip	macOS وApple Silicon / M Series / arm64
   databricks_cli_X.Y.Z_linux_amd64.zip	Linux، Intel 64 بت / x86_64
   databricks_cli_X.Y.Z_linux_arm64.zip	Linux، ARM 64 بت / arm64
   databricks_cli_X.Y.Z_windows_386.zip	Windows، Intel 32 بت / x86
   databricks_cli_X.Y.Z_windows_amd64.zip	Windows، Intel 64 بت / AMD64
   databricks_cli_X.Y.Z_windows_arm64.zip	Windows، ARM 64 بت / ARM64

   للحصول على بنية جهازك، راجع وثائق نظام التشغيل الخاص بك. على سبيل المثال:

   • Linux: أوامر المحطة الطرفية uname -mأو lscpuأو sudo lshw -c cpu.
   • macOS: قائمة >أيقونة Apple حول هذا Mac، أو الأمر uname -mTerminal .
   • Windows: الأمر echo %PROCESSOR_ARCHITECTURE%موجه الأوامر أو PowerShell .

   إذا كنت بحاجة إلى التحقق من تكامل أحد هذه .zip الملفات، يوفر Databricks ملف المجموع الاختباري المسمى databricks_cli_X.Y.Z_SHA256SUMS في نفس القائمة مثل الملفات .zip . لتشغيل التحقق من المجموع الاختباري، راجع وثائق نظام التشغيل الخاص بك.

2. استخراج محتويات الملف الذي تم تنزيله .zip . لاستخراج .zip الملف، راجع وثائق نظام التشغيل الخاص بك.

3. في المحتوى المستخرج، يظهر مجلد بنفس اسم .zip الملف. يوجد داخل هذا المجلد Databricks CLI قابل للتنفيذ. يمكنك ترك Databricks CLI قابلا للتنفيذ هناك، أو يمكنك نسخه أو نقله إلى موقع آخر.

4. تأكد من تثبيت Databricks CLI بشكل صحيح. للقيام بذلك، من موجه Linux shell أو macOS Terminal أو موجه أوامر Windows، اعرض إصدار Databricks CLI القابل للتنفيذ باستخدام -v الخيار أو عن طريق تشغيل version الأمر:

   databricks -v
   
   # Or:
   databricks version
   

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

   إشعار

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

   بالنسبة لنظام التشغيل macOS، قد تحتاج إلى تخويل النظام الخاص بك ليكون قادرا على تشغيل Databricks CLI أولا. راجع فتح تطبيق Mac من مطور غير معروف.

5. تابع المصادقة ل Databricks CLI.

تحديث Homebrew لنظام التشغيل Linux أو macOS

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

1. من موجه Linux shell أو macOS Terminal، استخدم Homebrew لتنزيل أحدث إصدار من Databricks CLI القابل للتنفيذ وتحديثه عن طريق تشغيل الأمر التالي:

   brew upgrade databricks
   

2. تأكد من تحديث Databricks CLI بشكل صحيح. للقيام بذلك، اعرض إصدار Databricks CLI القابل للتنفيذ باستخدام -v الخيار أو عن طريق تشغيل version الأمر:

   databricks -v
   
   # Or:
   databricks version
   

   إذا تم عرض رقم الإصدار المحدث المتوقع، تثبيت Databricks CLI بشكل صحيح.

   للحصول على قائمة بإصدارات Databricks CLI، راجع قسم الإصدارات في مستودع Databricks CLI في GitHub. يحتوي الإصدار الأخير على Latest تسمية بجانبه في قائمة الإصدارات.

   إشعار

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

تلميح

للرجوع إلى إصدار Databricks CLI، راجع الإرشادات الموجودة في مستودع databricks/homebrew-tap في GitHub.

تحديث WinGet لنظام التشغيل Windows

بالنسبة لخيار التحديث هذا، يمكنك استخدام winget لتنزيل وتحديث إصدار سابق من Databricks CLI الإصدار 0.205 أو أعلى تلقائيا إلى أحدث إصدار.

1. من موجه الأوامر، استخدم winget لتنزيل أحدث إصدار من Databricks CLI القابل للتنفيذ وتحديثه عن طريق تشغيل الأمر التالي:

   winget upgrade Databricks.DatabricksCLI
   

2. تأكد من تثبيت Databricks CLI بشكل صحيح. للقيام بذلك، اعرض إصدار Databricks CLI القابل للتنفيذ باستخدام -v الخيار أو عن طريق تشغيل version الأمر:

   databricks -v
   
   # Or:
   databricks version
   

   إذا تم عرض رقم الإصدار المحدث المتوقع، تثبيت Databricks CLI بشكل صحيح.

   للحصول على قائمة بإصدارات Databricks CLI، راجع قسم الإصدارات في مستودع Databricks CLI في GitHub. يحتوي الإصدار الأخير على Latest تسمية بجانبه في قائمة الإصدارات.

   إشعار

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

تحديث Chocolatey لنظام التشغيل Windows

إشعار

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

بالنسبة لخيار التحديث هذا، يمكنك استخدام Chocolatey لتنزيل وتحديث إصدار سابق من Databricks CLI الإصدار 0.205 أو أعلى تلقائيا إلى أحدث إصدار.

1. من موجه الأوامر، استخدم choco لتنزيل أحدث إصدار من Databricks CLI القابل للتنفيذ وتحديثه عن طريق تشغيل الأمر التالي:

   choco upgrade databricks-cli
   

2. تأكد من تثبيت Databricks CLI بشكل صحيح. للقيام بذلك، اعرض إصدار Databricks CLI القابل للتنفيذ باستخدام -v الخيار أو عن طريق تشغيل version الأمر:

   databricks -v
   
   # Or:
   databricks version
   

   إذا تم عرض رقم الإصدار المحدث المتوقع، تثبيت Databricks CLI بشكل صحيح.

   للحصول على قائمة بإصدارات Databricks CLI، راجع قسم الإصدارات في مستودع Databricks CLI في GitHub. يحتوي الإصدار الأخير على Latest تسمية بجانبه في قائمة الإصدارات.

   إشعار

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

تحديث curl ل Linux وmacOS وWindows

بالنسبة لخيار التحديث هذا، يمكنك استخدام curl لتنزيل وتحديث تثبيت سابق من Databricks CLI الإصدار 0.205 أو أعلى تلقائيا إلى أحدث إصدار.

بالنسبة إلى Windows، توصي Databricks باستخدام نظام Windows الفرعي لـ Linux (WSL). يجب أن تكون قد قمت unzip بتثبيته. للحصول على إرشادات التثبيت، راجع وثائق نظام التشغيل. إذا لم تتمكن من استخدام WSL، يجب تخطي هذا الإجراء واستخدام موجه الأوامر أو PowerShell لتحديث Databricks CLI من المصدر بدلا من ذلك.

1. احذف التثبيت الحالي ل Databricks CLI القابل للتنفيذ من المسار /usr/local/bin/databricks على macOS وLinux، أو C:\Windows\databricks.exe على Windows.

2. من موجه Linux shell أو macOS Terminal أو موجه أوامر Windows، استخدم curl لتنزيل أحدث إصدار من Databricks CLI القابل للتنفيذ وتثبيته عن طريق تشغيل الأمر التالي (لاحظ أنه يجب عليك تحديد الأحرف الكبيرة والصغيرة الصحيحة ل -fsSL):

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

   إشعار

   لعرض محتويات البرنامج النصي قبل تشغيله، راجع ملف install.sh في مستودع إعداد Databricks CLI في GitHub.

   بالنسبة إلى Windows، يجب تشغيل هذا الأمر كمسؤول.

   بالنسبة إلى Linux وmacOS، إذا كانت رسالة الخطأ تشير إلى أن /usr/local/bin غير قابل للكتابة، فقم بتشغيل الأمر مرة أخرى باستخدام sudo.

   يقوم هذا الأمر بتنزيل وتثبيت Databricks CLI القابل للتنفيذ في المسار /usr/local/bin/databricks على macOS وLinux، وعلى C:\Windows\databricks.exe Windows.

   إذا ظهر الخطأ التالي، يجب حذف Databricks CLI القابل للتنفيذ يدويا من المسار السابق، ثم تشغيل curl الأمر مرة أخرى: "المسار <path> الهدف موجود بالفعل."

3. تأكد من تحديث Databricks CLI بشكل صحيح. للقيام بذلك، من المحطة الطرفية الخاصة بك، اعرض إصدار Databricks CLI القابل للتنفيذ باستخدام -v الخيار أو عن طريق تشغيل version الأمر:

   databricks -v
   
   # Or:
   databricks version
   

   إذا تم عرض رقم الإصدار المحدث المتوقع، تثبيت Databricks CLI بشكل صحيح.

   للحصول على قائمة بإصدارات Databricks CLI، راجع قسم الإصدارات في مستودع Databricks CLI في GitHub. يحتوي الإصدار الأخير على Latest تسمية بجانبه في قائمة الإصدارات.

   إشعار

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

تحديث المصدر ل Linux وmacOS وWindows

بالنسبة لخيار التحديث هذا، يمكنك تنزيل .zip ملف يدويا ثم استخراج Databricks CLI القابل للتنفيذ يدويا من الملف الذي تم تنزيله .zip .

1. اختياريا، احذف Databricks CLI القابل للتنفيذ والملف .zip والمجلد .zip المستخرج للملف من أي إجراء تثبيت يدوي سابق للمصدر.
2. تابع باتباع الإرشادات الواردة في تثبيت المصدر ل Linux وmacOS وWindows.