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

Примечание.

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

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

Установка

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

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

Обновление

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

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

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

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

brew tap databricks/tap
brew trust databricks/tap
brew install databricks

Команда brew trust требуется по состоянию на Homebrew 6.0.0, что требует, чтобы сторонние касания были явно доверенными, прежде чем Homebrew загрузит их формулы. Пользователи, которые подключили tap-репозиторий до обновления до Homebrew 6.0.0, также должны выполнить brew trust databricks/tap.

Вы также можете выполнить установку в один шаг, не доверяя всему tap-репозиторию:

brew install databricks/tap/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 6.0.0 сторонние касания должны быть явно доверенными, прежде чем Homebrew загрузит свою формулу. Выполните следующую команду:

    brew trust databricks/tap
    

    Существующие пользователи, которые коснулись перед обновлением до Homebrew 6.0.0, также должны выполнить эту команду.

  5. Используйте Homebrew, чтобы указать использовать репозиторий databricks/homebrew-tap для загрузки и установки CLI Databricks, выполнив следующую команду:

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

    databricks -v
    
    # Or:
    databricks version
    

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

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

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

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

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

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

    databricks -v
    
    # Or:
    databricks version
    

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

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

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

Примечание.

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

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

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

    choco install databricks-cli
    
  2. Убедитесь, что интерфейс командной строки Databricks установлен правильно. Для этого просмотрите версию интерфейса командной строки 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 для 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, выполнив следующую команду. Эта команда учитывает регистр.

    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.

    Эта команда загружает и устанавливает Databricks CLI в путь /usr/local/bin/databricks в macOS и Linux, а в Windows — в путь C:\Windows\databricks.exe.

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

  4. Убедитесь, что интерфейс командной строки Databricks установлен правильно. Для этого просмотрите версию интерфейса командной строки 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. Вы можете оставить интерфейс командной строки Databricks там, или скопировать или переместить его в другое расположение.

  4. Убедитесь, что интерфейс командной строки Databricks установлен правильно. Для этого в командной строке Linux, терминале macOS или командной строке Windows просмотрите версию интерфейса командной строки 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 для скачивания и обновления до последней версии интерфейса командной строки Databricks, выполнив следующую команду:

    brew upgrade databricks
    
  2. Убедитесь, что интерфейс командной строки Databricks обновлен правильно. Для этого просмотрите версию интерфейса командной строки 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 для скачивания и обновления последней версии интерфейса командной строки Databricks, выполнив следующую команду:

    winget upgrade Databricks.DatabricksCLI
    
  2. Убедитесь, что интерфейс командной строки Databricks установлен правильно. Для этого просмотрите версию интерфейса командной строки 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 для скачивания и обновления последней версии интерфейса командной строки Databricks, выполнив следующую команду:

    choco upgrade databricks-cli
    
  2. Убедитесь, что интерфейс командной строки Databricks установлен правильно. Для этого просмотрите версию интерфейса командной строки 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 для Linux (WSL). У вас должно быть установлено unzip. Инструкции по установке см. в документации по операционной системе. Если вы не можете использовать WSL, следует пропустить эту процедуру и использовать командную строку или PowerShell для обновления Databricks CLI из исходного кода.

  1. Удалите существующую установку интерфейса командной строки Databricks из пути /usr/local/bin/databricks в macOS и Linux или C:\Windows\databricks.exe в Windows.

  2. В командной строке оболочки Linux, терминале macOS или командной строке Windows используйте curl для скачивания и установки последней версии интерфейса командной строки 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, а в Windows — по пути C:\Windows\databricks.exe.

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

  3. Убедитесь, что интерфейс командной строки Databricks обновлен правильно. Для этого в терминале просмотрите версию интерфейса командной строки 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.