Установка или обновление интерфейса командной строки Databricks

Примечание.

Эта информация относится к Интерфейсу командной строки Databricks версии 0.205 и выше. Интерфейс командной строки Databricks находится в общедоступной предварительной версии.

Использование интерфейса командной строки Databricks распространяется на лицензию Databricks и уведомление о конфиденциальности Databricks, включая все положения об использовании.

В этой статье описывается установка или обновление интерфейса командной строки Databricks. См. интерфейс командной строки Databricks. Сведения о настройке проверки подлинности для интерфейса командной строки Databricks см. в разделе "Проверка подлинности" для интерфейса командной строки Databricks.

Установка

Чтобы установить Databricks CLI версии 0.205 или более поздней, выполните указанные ниже действия.

• Linux или macOS: использование homebrew, curl или исходных сборок.
• Windows: используйте WinGetChocolatey, Windows Subsystem for Linux (WSL) или source builds.

Интерфейс командной строки Databricks также доступен в пользовательском интерфейсе рабочей области Azure Databricks. См команды CLI для запуска Databricks.

Обновление

Чтобы обновить более раннюю установку Интерфейса командной строки Databricks версии 0.205 или более поздней:

• Linux или macOS: использование homebrew, curl или исходных сборок.
• Windows: используйте WinGetChocolatey, Windows Subsystem for Linux (WSL) или source builds.

Установка Homebrew для Linux или macOS

Для этого параметра установки вы используете Homebrew для автоматической загрузки и установки последнего исполняемого выпуска Cli Databricks.

В терминале выполните следующие две команды Homebrew для установки интерфейса командной строки:

brew tap databricks/tap
brew install databricks

Затем перейдите к проверке подлинности для интерфейса командной строки Databricks.

Если вы не уверены, установлен ли у вас Homebrew или если предыдущие команды Homebrew завершаются ошибкой, выполните следующие более длительные инструкции:

1. Проверьте, установлен ли Homebrew, выполнив следующую команду из командной строки Linux или терминала macOS. Если установлен 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, выполнив следующую команду:

   brew install databricks
   

5. Убедитесь, что интерфейс командной строки Databricks установлен правильно. Для этого просмотрите версию исполняемого файла CLI Databricks с помощью -v параметра или выполните version команду:

   databricks -v
   
   # Or:
   databricks version
   

   Если указан номер версии 0.205.0 или более поздней версии, интерфейс командной строки Databricks установлен правильно.

6. Продолжайте с аутентификацией для Databricks CLI.

установка WinGet для Windows

Для этого параметра установки вы используете winget для автоматического скачивания и установки последнего исполняемого выпуска Databricks CLI.

1. В командной строке выполните следующие две winget команды, чтобы установить интерфейс командной строки, а затем перезапустите командную строку:

   winget search databricks
   winget install Databricks.DatabricksCLI
   

2. Убедитесь, что интерфейс командной строки Databricks установлен правильно. Для этого просмотрите версию исполняемого файла CLI Databricks с помощью -v параметра или выполните version команду:

   databricks -v
   
   # Or:
   databricks version
   

Если выходные данные имеют версию 0.205.0 или более поздней, интерфейс командной строки Databricks установлен правильно.

1. Продолжайте с аутентификацией для Databricks CLI.

установка Chocolatey для Windows

Примечание.

Установка интерфейса командной строки Databricks с помощью Chocolatey является экспериментальной.

Для этого варианта установки используйте Chocolatey для автоматической загрузки и установки последней версии исполнимого файла Databricks CLI.

1. В командной строке выполните следующую choco команду, чтобы установить CLI:

   choco install databricks-cli
   

2. Убедитесь, что интерфейс командной строки Databricks установлен правильно. Для этого просмотрите версию исполняемого файла CLI Databricks с помощью -v параметра или выполните version команду:

   databricks -v
   
   # Or:
   databricks version
   

   Если выходные данные имеют версию 0.205.0 или более поздней, интерфейс командной строки Databricks установлен правильно.

3. Продолжайте с аутентификацией для Databricks CLI.

установка curl для Linux, macOS и Windows

Для этой опции установки используйте curl, чтобы скачать и установить последнюю версию исполняемого файла Databricks CLI.

Для Windows Databricks рекомендует использовать Windows Subsystem for Linux (WSL). Необходимо также установить unzip. Инструкции по установке см. в документации по операционной системе. Если вы не можете использовать WSL, пропустите эту процедуру и используйте командную строку или PowerShell для установки интерфейса командной строки Databricks из источника .

1. curl необходимо установить. Вы можете проверить curl , уже ли установлено, выполнив следующую команду из командной строки Linux, терминала macOS или Bash в WSL. Если curl установлен, отображается номер версии curl.

   curl -V
   

2. curlЕсли он еще не установлен, установите его, следуя инструкциям на curlстранице "Выпуски и загрузки" для вашей операционной системы и архитектуры. Чтобы получить архитектуру компьютера, ознакомьтесь с документацией операционной системы.

   Затем выполните следующую команду, чтобы проверить установку curl, и отобразится номер версии curl.

   curl -V
   

3. Используйте curl для скачивания и установки исполняемого файла CLI Databricks, выполнив следующую команду (обратите внимание, что необходимо указать правильные символы верхнего и нижнего регистра для -fsSL всех операционных систем):

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

   Примечание.

   Чтобы просмотреть содержимое скрипта перед его запуском, см. файл install.sh в репозитории установки CLI Databricks в GitHub.

   Для Windows выполните эту команду от имени администратора.

   Для Linux и macOS, если сообщение об ошибке указывает, что /usr/local/bin не является доступным для записи, затем выполните команду снова с помощью sudo.

   Эта команда скачивает и устанавливает исполняемый файл Cli Databricks в пути /usr/local/bin/databricks в macOS и Linux и C:\Windows\databricks.exe в Windows.

   Если по какой-то причине интерфейс командной строки Databricks уже установлен, появится следующая ошибка: "Целевой путь <path> уже существует". Чтобы устранить эту проблему, необходимо вручную удалить исполняемый файл Интерфейса командной строки Databricks из предыдущего пути, а затем снова выполнить curl команду.

4. Убедитесь, что интерфейс командной строки Databricks установлен правильно. Для этого просмотрите версию исполняемого файла CLI Databricks с помощью -v параметра или выполните version команду:

   databricks -v
   
   # Or:
   databricks version
   

   Если выходные данные имеют версию 0.205.0 или более поздней, интерфейс командной строки Databricks установлен правильно.

5. Продолжайте с аутентификацией для Databricks CLI.

установка из исходников для Linux, macOS и Windows

Для данного параметра установки вы вручную скачиваете .zip файл, а затем вручную извлекаете исполняемый файл Databricks CLI из скачанного .zip файла.

1. Скачайте на локальную машину разработки последний файл Databricks CLI .zip, как указано в разделе Releases репозитория Databricks CLI на GitHub. В списке выпусков у последней версии есть метка Latest рядом с ней. Последняя предварительная версия имеет Pre-release метку и более подходит для экспериментов и ранних пользователей. Файл .zip скачанный из раздела Assets для выпуска, должен соответствовать операционной системе и архитектуре вашего компьютера для разработки.

   Имя файла	Архитектура
   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 Серия / 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, >About This Mac, или команда в терминалеuname -m.
   • Windows: командная строка или команда PowerShell echo %PROCESSOR_ARCHITECTURE%.

   Если необходимо проверить целостность одного из этих .zip файлов, Databricks предоставляет файл контрольной суммы под названием databricks_cli_X.Y.Z_SHA256SUMS в том же списке, как и файлы .zip. Чтобы запустить проверку контрольной суммы, ознакомьтесь с документацией операционной системы.

2. Извлеките содержимое скачаемого .zip файла. Чтобы извлечь .zip файл, ознакомьтесь с документацией операционной системы.

3. В извлеченном содержимом папка отображается с тем же именем, что и файл .zip. Внутри этой папки находится исполняемый файл Интерфейса командной строки Databricks. Вы можете оставить исполняемый файл CLI Databricks там, или скопировать или переместить его в другое расположение.

4. Убедитесь, что интерфейс командной строки Databricks установлен правильно. Для этого в командной строке Linux, терминале macOS или командной строке Windows просмотрите версию исполняемого файла Cli Databricks с помощью параметра -v или выполнив команду version:

   databricks -v
   
   # Or:
   databricks version
   

   Если выходные данные имеют версию 0.205.0 или более поздней, интерфейс командной строки Databricks установлен правильно.

   Примечание.

   Для macOS может потребоваться авторизовать систему, чтобы сначала запустить интерфейс командной строки Databricks. См. статью "Открыть приложение Mac" от неопознанного разработчика.

5. Продолжайте с аутентификацией для Databricks CLI.

Обновление Homebrew для Linux или macOS

Для этого параметра обновления используется Homebrew для автоматического обновления предыдущей установки Databricks CLI версии 0.205 или более поздней до последней версии.

1. В командной строке оболочки Linux или терминале macOS используйте Homebrew для скачивания и обновления до последней версии исполняемого файла Cli Databricks, выполнив следующую команду:

   brew upgrade databricks
   

2. Убедитесь, что интерфейс командной строки Databricks обновлен правильно. Для этого просмотрите версию исполняемого файла CLI Databricks с помощью -v параметра или выполните version команду:

   databricks -v
   
   # Or:
   databricks version
   

   Если выходные данные имеют версию 0.205.0 или более поздней, интерфейс командной строки Databricks установлен правильно.

   Список версий cli Databricks см. в разделе Releases репозитория CLI Databricks в GitHub. В списке выпусков у последней версии есть метка Latest рядом с ней.

Совет

Чтобы изменить версию интерфейса командной строки Databricks, см. инструкции в репозитории databricks/homebrew-tap в GitHub.

обновление WinGet для Windows

Для этого параметра обновления используется winget для автоматического скачивания и обновления предыдущей версии Интерфейса командной строки Databricks версии 0.205 или более поздней до последней версии.

1. В командной строке используйте winget для скачивания и обновления до последней версии исполняемого файла Cli Databricks, выполнив следующую команду:

   winget upgrade Databricks.DatabricksCLI
   

2. Убедитесь, что интерфейс командной строки Databricks установлен правильно. Для этого просмотрите версию исполняемого файла CLI Databricks с помощью -v параметра или выполните version команду:

   databricks -v
   
   # Or:
   databricks version
   

   Если выходные данные имеют версию 0.205.0 или более поздней, интерфейс командной строки Databricks установлен правильно.

   Список версий cli Databricks см. в разделе Releases репозитория CLI Databricks в GitHub. В списке выпусков у последней версии есть метка Latest рядом с ней.

обновление Chocolatey для Windows

Примечание.

Обновление интерфейса командной строки Databricks с помощью Chocolatey является экспериментальным.

Для этого параметра обновления вы используете Chocolatey, чтобы автоматически скачивать и обновлять предыдущую версию Интерфейса командной строки Databricks версии 0.205 или более поздней до последней версии.

1. В командной строке используйте choco для скачивания и обновления до последней версии исполняемого файла Cli Databricks, выполнив следующую команду:

   choco upgrade databricks-cli
   

2. Убедитесь, что интерфейс командной строки Databricks установлен правильно. Для этого просмотрите версию исполняемого файла CLI Databricks с помощью -v параметра или выполните version команду:

   databricks -v
   
   # Or:
   databricks version
   

   Если выходные данные имеют версию 0.205.0 или более поздней, интерфейс командной строки Databricks установлен правильно.

   Список версий cli Databricks см. в разделе Releases репозитория CLI Databricks в GitHub. В списке выпусков у последней версии есть метка Latest рядом с ней.

обновление curl для Linux, macOS и Windows

Для этого параметра обновления вы используете curl для автоматического скачивания и обновления предыдущей установки Databricks CLI версии 0.205 или более поздней до последней версии.

Для Windows Databricks рекомендует использовать Windows Subsystem for 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 или командной строке Windows используйте curl, чтобы скачать и установить последнюю версию исполняемого файла Databricks CLI, выполнив следующую команду (обратите внимание, что для -fsSL необходимо правильно указать символы с учетом регистра букв):

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

   Примечание.

   Чтобы просмотреть содержимое скрипта перед его запуском, см. файл install.sh в репозитории установки CLI Databricks в GitHub.

   Для Windows выполните эту команду от имени администратора.

   Для Linux и macOS, если сообщение об ошибке указывает, что /usr/local/bin не является доступным для записи, затем выполните команду снова с помощью sudo.

   Эта команда скачивает и устанавливает исполняемый файл Cli Databricks в пути /usr/local/bin/databricks в macOS и Linux и C:\Windows\databricks.exe в Windows.

   Если появится следующая ошибка, необходимо вручную удалить исполняемый файл Интерфейса командной строки Databricks из предыдущего пути, а затем снова выполнить команду: "Целевой curl путь <path> уже существует".

3. Убедитесь, что интерфейс командной строки Databricks обновлен правильно. Для этого в терминале просмотрите версию исполняемого файла Cli Databricks с помощью -v параметра или выполнив version команду:

   databricks -v
   
   # Or:
   databricks version
   

   Если выходные данные имеют версию 0.205.0 или более поздней, интерфейс командной строки Databricks установлен правильно.

   Список версий cli Databricks см. в разделе Releases репозитория CLI Databricks в GitHub. В списке выпусков у последней версии есть метка Latest рядом с ней.

Обновление кода для Linux, macOS и Windows

Для этого параметра обновления вы вручную скачиваете .zip файл, а затем вручную извлекаете исполняемый файл Databricks CLI из скачанного .zip файла.

1. При необходимости удалите исполняемый файл Databricks CLI, файл .zip и извлеченную папку файла .zip после любой ранее выполненной процедуры ручной установки.
2. Выполните инструкции по установке Source для Linux, macOS и Windows.