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

Примечание.

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

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

Установка

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

• Linux или macOS: использование homebrew, curl или исходных сборок.
• Windows: используйте WinGet, Chocolatey, подсистема Windows для Linux (WSL) или исходные сборки.

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

Обновить

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

• Linux или macOS: использование homebrew, curl или исходных сборок.
• Windows: используйте WinGet, Chocolatey, подсистема Windows для Linux (WSL) или исходные сборки.

Установка 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 установлен правильно.

   Примечание.

   Если вы выполняете, но получите ошибку, напримерcommand not found: databricks, или если вы запускаете databricksdatabricks -v, а номер версии 0.18 или ниже указан, это означает, что компьютер не может найти правильную версию исполняемого файла Интерфейса командной строки Databricks. Чтобы устранить эту проблему, см . статью "Проверка установки CLI".

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

Установка 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 установлен правильно.

   Примечание.

   Если вы выполняете, но получите ошибку, напримерcommand not found: databricks, или если вы запускаете databricksdatabricks -v, а номер версии 0.18 или ниже указан, это означает, что компьютер не может найти правильную версию исполняемого файла Интерфейса командной строки Databricks. Чтобы устранить эту проблему, см . статью "Проверка установки CLI".

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

Установка шоколада для Windows

Примечание.

Установка интерфейса командной строки Databricks с помощью 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 установлен правильно.

   Примечание.

   Если вы выполняете, но получите ошибку, напримерcommand not found: databricks, или если вы запускаете databricksdatabricks -v, а номер версии 0.18 или ниже указан, это означает, что компьютер не может найти правильную версию исполняемого файла Интерфейса командной строки Databricks. Чтобы устранить эту проблему, см . статью "Проверка установки CLI".

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

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

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

   Эта команда загружает и устанавливает исполняемый файл Интерфейса командной строки 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 установлен правильно.

   Примечание.

   Если вы выполняете, но получите ошибку, напримерcommand not found: databricks, или если вы запускаете databricksdatabricks -v, а номер версии 0.18 или ниже указан, это означает, что компьютер не может найти правильную версию исполняемого файла Интерфейса командной строки Databricks. Чтобы устранить эту проблему, см . статью "Проверка установки CLI".

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

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

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

1. Скачайте на локальный компьютер разработки последний файл ИНТЕРФЕЙСА командной строки Databricks, как указано в разделе "Выпуски" репозитория CLI .zip Databricks в 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 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 About This Mac или команда терминалаuname -m.
   • Windows: командная строка или команда echo %PROCESSOR_ARCHITECTURE%PowerShell.

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

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 установлен правильно.

   Примечание.

   Если вы выполняете, но получите ошибку, напримерcommand not found: databricks, или если вы запускаете databricksdatabricks -v, а номер версии 0.18 или ниже указан, это означает, что компьютер не может найти правильную версию исполняемого файла Интерфейса командной строки Databricks. Чтобы устранить эту проблему, см . статью "Проверка установки CLI".

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

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

Обновление 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
   

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

   Список версий интерфейса командной строки Databricks см . в разделе "Выпуски " репозитория CLI Databricks в GitHub. Последняя версия содержит метку рядом с ней Latest в списке выпусков.

   Примечание.

   Если вы выполняете, но получите ошибку, напримерcommand not found: databricks, или если вы запускаете databricksdatabricks -v, а номер версии 0.18 или ниже указан, это означает, что компьютер не может найти правильную версию исполняемого файла Интерфейса командной строки Databricks. Чтобы устранить эту проблему, см . статью "Проверка установки CLI".

Обновление 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
   

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

   Список версий интерфейса командной строки Databricks см . в разделе "Выпуски " репозитория CLI Databricks в GitHub. Последняя версия содержит метку рядом с ней Latest в списке выпусков.

   Примечание.

   Если вы выполняете, но получите ошибку, напримерcommand not found: databricks, или если вы запускаете databricksdatabricks -v, а номер версии 0.18 или ниже указан, это означает, что компьютер не может найти правильную версию исполняемого файла Интерфейса командной строки Databricks. Чтобы устранить эту проблему, см . статью "Проверка установки CLI".

Обновление шоколада для Windows

Примечание.

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

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

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

   choco upgrade databricks-cli
   

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

   databricks -v
   
   # Or:
   databricks version
   

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

   Список версий интерфейса командной строки Databricks см . в разделе "Выпуски " репозитория CLI Databricks в GitHub. Последняя версия содержит метку рядом с ней Latest в списке выпусков.

   Примечание.

   Если вы выполняете, но получите ошибку, напримерcommand not found: databricks, или если вы запускаете databricksdatabricks -v, а номер версии 0.18 или ниже указан, это означает, что компьютер не может найти правильную версию исполняемого файла Интерфейса командной строки Databricks. Чтобы устранить эту проблему, см . статью "Проверка установки CLI".

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

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

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

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

2. В командной строке оболочки Linux, терминале macOS или командной строке Windows используйте 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помощью .

   Эта команда загружает и устанавливает исполняемый файл Интерфейса командной строки 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
   

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

   Список версий интерфейса командной строки Databricks см . в разделе "Выпуски " репозитория CLI Databricks в GitHub. Последняя версия содержит метку рядом с ней Latest в списке выпусков.

   Примечание.

   Если вы выполняете, но получите ошибку, напримерcommand not found: databricks, или если вы запускаете databricksdatabricks -v, а номер версии 0.18 или ниже указан, это означает, что компьютер не может найти правильную версию исполняемого файла Интерфейса командной строки Databricks. Чтобы устранить эту проблему, см . статью "Проверка установки CLI".

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

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

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

Запуск интерфейса командной строки Databricks из рабочей области Azure Databricks

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

• Кластер должен установить Databricks Runtime 15.0 или более поздней версии.
• Кластер должен использовать режимдоступа к кластеру одного пользователя или без общей изоляции. Режим доступа к общему кластеру не поддерживается.
• Бессерверные вычисления не поддерживаются.
• Рабочая область не должна быть включена для Приватный канал.

Чтобы получить доступ к интерфейсу командной строки из веб-терминала для записной книжки, сделайте следующее:

1. Подключение записную книжку в кластер, соответствующий предыдущим требованиям.

2. В нижней части правой боковой панели записной книжки щелкните значок "Открыть нижней панели".

3. Используйте интерфейс командной строки в появившейся области терминала . Например, следующая команда выводит сведения о текущем пользователе:

   databricks current-user me
   

Чтобы получить доступ к интерфейсу командной строки из веб-терминала для кластера, сделайте следующее:

1. На боковой панели рабочей области щелкните " Вычисления".

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

3. Щелкните Начать.

4. После запуска кластера на вкладке "Приложения " щелкните веб-терминал.

5. Используйте интерфейс командной строки в появившемся веб-терминале Databricks. Например, следующая команда выводит сведения о текущем пользователе:

   databricks current-user me