تثبيت Databricks CLI أو تحديثه
إشعار
تنطبق هذه المعلومات على إصدارات Databricks CLI 0.205 والإصدارات الأحدث، الموجودة في المعاينة العامة. للعثور على إصدار Databricks CLI الخاص بك، قم بتشغيل databricks -v
.
توضح هذه المقالة كيفية تثبيت 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 السابقة، فاتبع هذه الإرشادات الأطول:
تحقق مما إذا كان Homebrew مثبتا بالفعل عن طريق تشغيل الأمر التالي من موجه Linux shell أو macOS Terminal. إذا تم تثبيت Homebrew، يتم عرض رقم إصدار Homebrew:
brew -v
إذا لم يكن Homebrew مثبتا بالفعل، فقم بتثبيته عن طريق تشغيل الأمر التالي:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
ثم قم بتشغيل الأمر التالي للتحقق من تثبيت Homebrew، والذي يعرض رقم إصدار Homebrew:
brew -v
استخدم Homebrew لإضافة مستودع databricks/homebrew-tap في GitHub إلى قائمة مستودعات Homebrew Tap المتوفرة، عن طريق تشغيل الأمر التالي:
brew tap databricks/tap
استخدم Homebrew لإرشاد
databricks/homebrew-tap
المستودع لتنزيل وتثبيت Databricks CLI القابل للتنفيذ، عن طريق تشغيل الأمر التالي:brew install databricks
تأكد من تثبيت 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.تابع المصادقة ل Databricks CLI.
تثبيت WinGet ل Windows
بالنسبة إلى خيار التثبيت هذا، يمكنك استخدام winget لتنزيل وتثبيت أحدث إصدار قابل للتنفيذ ل Databricks CLI تلقائيا.
من موجه الأوامر، قم بتشغيل الأمرين التاليين
winget
لتثبيت CLI، ثم أعد تشغيل موجه الأوامر:winget search databricks winget install Databricks.DatabricksCLI
تأكد من تثبيت 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.تابع المصادقة ل Databricks CLI.
تثبيت Chocolatey لنظام التشغيل Windows
بالنسبة إلى خيار التثبيت هذا، يمكنك استخدام Chocolatey لتنزيل وتثبيت أحدث إصدار قابل للتنفيذ من Databricks CLI تلقائيا.
من موجه الأوامر، قم بتشغيل الأمر التالي
choco
لتثبيت CLI:choco install databricks-cli
تأكد من تثبيت 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.تابع المصادقة ل Databricks CLI.
تثبيت curl ل Linux وmacOS وWindows
بالنسبة لخيار التثبيت هذا، يمكنك استخدام curl لتنزيل وتثبيت أحدث إصدار قابل للتنفيذ ل Databricks CLI.
بالنسبة إلى Windows، توصي Databricks باستخدام نظام Windows الفرعي لـ Linux (WSL). يجب أن تكون قد قمت unzip
أيضا بتثبيت. للحصول على إرشادات التثبيت، راجع وثائق نظام التشغيل. إذا لم تتمكن من استخدام WSL، فتخط هذا الإجراء واستخدم موجه الأوامر أو PowerShell لتثبيت Databricks CLI من المصدر بدلا من ذلك.
curl
يجب تثبيته. يمكنك التحقق مما إذا كانcurl
مثبتا بالفعل عن طريق تشغيل الأمر التالي من موجه Linux shell أو macOS Terminal أو Bash على WSL. إذاcurl
تم تثبيته،curl
يتم عرض رقم الإصدار:curl -V
إذا
curl
لم يكن مثبتا بالفعل، فقم بتثبيته باتباع الإرشادات الموجودة فيcurl
صفحة الإصدارات والتنزيلات لنظام التشغيل والهندسة. للحصول على بنية جهازك، راجع وثائق نظام التشغيل الخاص بك.ثم قم بتشغيل الأمر التالي للتحقق من
curl
التثبيت، والذي يعرضcurl
رقم الإصدار:curl -V
استخدم
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
الأمر مرة أخرى.تأكد من تثبيت 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.تابع المصادقة ل Databricks CLI.
تثبيت المصدر ل Linux وmacOS وWindows
بالنسبة لخيار التثبيت هذا، يمكنك تنزيل .zip
ملف يدويا ثم استخراج Databricks CLI القابل للتنفيذ يدويا من الملف الذي تم تنزيله .zip
.
قم بتنزيل أحدث ملف 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 -m
Terminal . - Windows: الأمر
echo %PROCESSOR_ARCHITECTURE%
موجه الأوامر أو PowerShell .
إذا كنت بحاجة إلى التحقق من تكامل أحد هذه
.zip
الملفات، يوفر Databricks ملف المجموع الاختباري المسمىdatabricks_cli_X.Y.Z_SHA256SUMS
في نفس القائمة مثل الملفات.zip
. لتشغيل التحقق من المجموع الاختباري، راجع وثائق نظام التشغيل الخاص بك.- Linux: أوامر المحطة الطرفية
استخراج محتويات الملف الذي تم تنزيله
.zip
. لاستخراج.zip
الملف، راجع وثائق نظام التشغيل الخاص بك.في المحتوى المستخرج، يظهر مجلد بنفس اسم
.zip
الملف. يوجد داخل هذا المجلد Databricks CLI قابل للتنفيذ. يمكنك ترك Databricks CLI قابلا للتنفيذ هناك، أو يمكنك نسخه أو نقله إلى موقع آخر.تأكد من تثبيت 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 من مطور غير معروف.
تابع المصادقة ل Databricks CLI.
تحديث Homebrew لنظام التشغيل Linux أو macOS
بالنسبة لخيار التحديث هذا، يمكنك استخدام Homebrew لتحديث تثبيت سابق من Databricks CLI الإصدار 0.205 أو أعلى تلقائيا إلى أحدث إصدار.
من موجه Linux shell أو macOS Terminal، استخدم Homebrew لتنزيل أحدث إصدار من Databricks CLI القابل للتنفيذ وتحديثه عن طريق تشغيل الأمر التالي:
brew upgrade databricks
تأكد من تحديث 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 أو أعلى تلقائيا إلى أحدث إصدار.
من موجه الأوامر، استخدم
winget
لتنزيل أحدث إصدار من Databricks CLI القابل للتنفيذ وتحديثه عن طريق تشغيل الأمر التالي:winget upgrade Databricks.DatabricksCLI
تأكد من تثبيت 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
بالنسبة لخيار التحديث هذا، يمكنك استخدام Chocolatey لتنزيل وتحديث إصدار سابق من Databricks CLI الإصدار 0.205 أو أعلى تلقائيا إلى أحدث إصدار.
من موجه الأوامر، استخدم
choco
لتنزيل أحدث إصدار من Databricks CLI القابل للتنفيذ وتحديثه عن طريق تشغيل الأمر التالي:choco upgrade databricks-cli
تأكد من تثبيت 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 من المصدر بدلا من ذلك.
احذف التثبيت الحالي ل Databricks CLI القابل للتنفيذ من المسار
/usr/local/bin/databricks
على macOS وLinux، أوC:\Windows\databricks.exe
على Windows.من موجه 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>
الهدف موجود بالفعل."تأكد من تحديث 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
.
- اختياريا، احذف Databricks CLI القابل للتنفيذ والملف
.zip
والمجلد.zip
المستخرج للملف من أي إجراء تثبيت يدوي سابق للمصدر. - تابع باتباع الإرشادات الواردة في تثبيت المصدر ل Linux وmacOS وWindows.
الملاحظات
https://aka.ms/ContentUserFeedback.
قريبًا: خلال عام 2024، سنتخلص تدريجيًا من GitHub Issues بوصفها آلية إرسال ملاحظات للمحتوى ونستبدلها بنظام ملاحظات جديد. لمزيد من المعلومات، راجعإرسال الملاحظات وعرضها المتعلقة بـ