Instalar ou atualizar a CLI do Databricks
Observação
Essas informações se aplicam às versões 0.205 e superiores da CLI do Databricks, que estão em Pré-visualização pública. Para encontrar sua versão da CLI do Databricks, execute databricks -v
.
Este artigo descreve como instalar ou atualizar a CLI do Databricks. Consulte O que é a CLI do Databricks?.
Instalar
Para instalar a CLI do Databricks versão 0.205 ou superior:
Linux ou macOS: use Homebrew, curl ou compilações de origem.
Windows: use WinGet, Chocolatey, Windows Subsystem for Linux (WSL), ou source builds.
A CLI do Databricks está disponível também na interface de usuário do workspace do Databricks. Consulte Executar comandos da CLI do Databricks.
Atualizar
Para atualizar uma instalação anterior da CLI do Databricks versão 0.205 ou superior:
Linux ou macOS: use Homebrew, curl ou compilações de origem.
Windows: use WinGet, Chocolatey, Windows Subsystem for Linux (WSL), ou source builds.
Instalação do Homebrew para Linux ou macOS
Para essa opção de instalação, utilize o Homebrew para baixar e instalar automaticamente a versão mais recente do executável da CLI do Databricks.
Em seu terminal, basta executar os dois comandos do Homebrew a seguir para instalar a CLI:
brew tap databricks/tap
brew install databricks
Em seguida, prossiga com a Autenticação para a CLI do Databricks.
Se você não souber se tem o Homebrew instalado ou se os comandos anteriores do Homebrew falharem, siga estas instruções mais longas:
Verifique se o Homebrew já está instalado executando o seguinte comando em um prompt de shell Linux ou no Terminal do macOS. Se o Homebrew estiver instalado, o número da versão dele será exibido:
brew -v
Se o Homebrew ainda não estiver instalado, instale-o executando o seguinte comando:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
Em seguida, execute o seguinte comando para verificar a instalação do Homebrew, que exibe o número da versão do Homebrew:
brew -v
Use o Homebrew para adicionar o repositório databricks/homebrew-tap no GitHub à sua lista de repositórios disponíveis do Homebrew Tap, executando o seguinte comando:
brew tap databricks/tap
Use o Homebrew para instruir o repositório
databricks/homebrew-tap
a baixar e instalar o executável da CLI do Databricks, executando o seguinte comando:brew install databricks
Confirme se a CLI do Databricks está instalada corretamente. Para fazer isso, consulte a versão do executável da CLI do Databricks utilizando a opção
-v
ou executando o comandoversion
:databricks -v # Or: databricks version
Se for apresentado o número de versão 0.205.0 ou superior, isso significa que a CLI do Databricks está instalada corretamente.
Observação
Se você executar
databricks
mas receber um erro comocommand not found: databricks
, ou se você executardatabricks -v
e um número de versão 0.18 ou inferior for listado, isso significa que sua máquina não consegue encontrar a versão correta do executável da CLI do Databricks. Para corrigir isso, consulte Verificar sua instalação da CLI.Prossiga com a Autenticação para a CLI do Databricks.
Instalação do WinGet para Windows
Para esta opção de instalação, use winget para fazer download e instalar automaticamente a última versão executável da CLI do Databricks.
No prompt de comando, execute os dois comandos
winget
a seguir para instalar a CLI e reinicie o prompt de comando:winget search databricks winget install Databricks.DatabricksCLI
Confirme se a CLI do Databricks está instalada corretamente. Para fazer isso, consulte a versão do executável da CLI do Databricks utilizando a opção
-v
ou executando o comandoversion
:databricks -v # Or: databricks version
Se for apresentado o número de versão 0.205.0 ou superior, isso significa que a CLI do Databricks está instalada corretamente.
Observação
Se você executar
databricks
mas receber um erro comocommand not found: databricks
, ou se você executardatabricks -v
e um número de versão 0.18 ou inferior for listado, isso significa que sua máquina não consegue encontrar a versão correta do executável da CLI do Databricks. Para corrigir isso, consulte Verificar sua instalação da CLI.Prossiga com a Autenticação para a CLI do Databricks.
Instalação do Chocolatey para Windows
Observação
Instalar a CLI do Databricks com Chocolatey é Experimental.
Para esta opção de instalação, use Chocolatey para fazer download e instalar automaticamente a versão mais recente da CLI executável do Databricks.
No seu prompt de comando, execute o seguinte comando
choco
para instalar a CLI:choco install databricks-cli
Confirme se a CLI do Databricks está instalada corretamente. Para fazer isso, consulte a versão do executável da CLI do Databricks utilizando a opção
-v
ou executando o comandoversion
:databricks -v # Or: databricks version
Se for apresentado o número de versão 0.205.0 ou superior, isso significa que a CLI do Databricks está instalada corretamente.
Observação
Se você executar
databricks
mas receber um erro comocommand not found: databricks
, ou se você executardatabricks -v
e um número de versão 0.18 ou inferior for listado, isso significa que sua máquina não consegue encontrar a versão correta do executável da CLI do Databricks. Para corrigir isso, consulte Verificar sua instalação da CLI.Prossiga com a Autenticação para a CLI do Databricks.
instalação com curl para Linux, macOS e Windows
Para essa opção de instalação, use o curl para baixar e instalar a versão executável mais recente da CLI do Databricks.
Para Windows, o Databricks recomenda que você use o Windows Subsystem for Linux (WSL). Você também deve ter unzip
instalado. Para obter instruções de instalação, consulte a documentação do seu sistema operacional. Se você não puder usar o WSL, pule este procedimento e use o prompt de comando ou o PowerShell para instalar a CLI do Databricks a partir do código-fonte .
curl
deve ser instalado. Você pode verificar se ocurl
já está instalado executando o seguinte comando em um prompt de shell do Linux, no Terminal macOS ou no Bash em WSL. Securl
estiver instalado, o número da versãocurl
será exibido:curl -V
Se o
curl
ainda não estiver instalado, instale-o seguindo as instruções na páginacurl
Versões and downloads para o seu sistema operacional e arquitetura. Para obter a arquitetura de sua máquina, consulte a documentação de seu sistema operacional.Em seguida, execute o seguinte comando para verificar a instalação do
curl
, que exibe o número da versãocurl
:curl -V
Use
curl
para fazer download e instalar a CLI executável do Databricks executando o seguinte comando (observe que você deve especificar os caracteres maiúsculos e minúsculos corretos para-fsSL
em todos os sistemas operacionais):curl -fsSL https://raw.githubusercontent.com/databricks/setup-cli/main/install.sh | sh
Observação
Para ver o conteúdo do script antes de executá-lo, consulte o arquivo install.sh no repositório de configuração da CLI do Databricks no GitHub.
No Windows, é necessário executar esse comando como administrador.
Para Linux e macOS, se uma mensagem de erro informar que não é possível gravar em
/usr/local/bin
, execute o comando novamente comsudo
.Esse comando baixa e instala o executável da CLI do Databricks no caminho
/usr/local/bin/databricks
no macOS e Linux eC:\Windows\databricks.exe
no Windows.Se, por algum motivo, a CLI do Databricks já estiver instalada, será exibido o seguinte erro: “Caminho de destino
<path>
já existe”. Para corrigir isso, você deve excluir manualmente o executável da CLI do Databricks do caminho anterior e, em seguida, executar o comandocurl
novamente.Confirme se a CLI do Databricks está instalada corretamente. Para fazer isso, consulte a versão do executável da CLI do Databricks utilizando a opção
-v
ou executando o comandoversion
:databricks -v # Or: databricks version
Se for apresentado o número de versão 0.205.0 ou superior, isso significa que a CLI do Databricks está instalada corretamente.
Observação
Se você executar
databricks
mas receber um erro comocommand not found: databricks
, ou se você executardatabricks -v
e um número de versão 0.18 ou inferior for listado, isso significa que sua máquina não consegue encontrar a versão correta do executável da CLI do Databricks. Para corrigir isso, consulte Verificar sua instalação da CLI.Prossiga com a Autenticação para a CLI do Databricks.
Instalação pelo código-fonte para Linux, macOS e Windows
Para essa opção de instalação, baixe manualmente um arquivo .zip
e depois extraia manualmente o executável da CLI do Databricks do arquivo .zip
baixado.
Baixe o arquivo
.zip
mais recente da CLI do Databricks em sua máquina de desenvolvimento local, conforme listado na seção Versões do repositório da CLI do Databricks no GitHub. A versão mais recente tem um rótuloLatest
ao lado dela na lista de versões. A pré-versão mais recente tem um rótuloPre-release
e é mais adequada para experimentação e primeiros usuários. O arquivo.zip
a ser baixado da seçãoAssets
para a versão deve corresponder ao sistema operacional e à arquitetura da máquina de desenvolvimento:Nome do arquivo
Arquitetura
databricks_cli_X.Y.Z_darwin_amd64.zip
macOS, Intel 64 bits /
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 bits /
x86_64
databricks_cli_X.Y.Z_linux_arm64.zip
Linux, ARM 64 bits /
arm64
databricks_cli_X.Y.Z_windows_386.zip
Windows, Intel 32 bits /
x86
databricks_cli_X.Y.Z_windows_amd64.zip
Windows, Intel 64 bits /
AMD64
databricks_cli_X.Y.Z_windows_arm64.zip
Windows, ARM de 64 bits /
ARM64
Para obter a arquitetura de sua máquina, consulte a documentação de seu sistema operacional. Por exemplo:
Linux: os comandos de terminal
uname -m
,lscpu
ousudo lshw -c cpu
.macOS: menu do ícone Apple > Sobre este Mac ou o comando
uname -m
do terminal.Windows: prompt de comando ou comando do PowerShell
echo %PROCESSOR_ARCHITECTURE%
.
Se você precisar verificar a integridade de um desses arquivos
.zip
, o Databricks disponibiliza um arquivo de soma de verificação chamadodatabricks_cli_X.Y.Z_SHA256SUMS
na mesma lista dos arquivos.zip
. Para executar uma verificação de soma de verificação, consulte a documentação de seu sistema operacional.Extraia o conteúdo do arquivo
.zip
baixado. Para extrair o arquivo.zip
, consulte a documentação de seu sistema operacional.No conteúdo extraído, haverá uma pasta com o mesmo nome do arquivo
.zip
. O executável da CLI do Databricks fica dentro dessa pasta. Você pode deixar o executável da CLI do Databricks lá, ou pode copiá-lo ou movê-lo para outro local.Confirme se a CLI do Databricks está instalada corretamente. Para fazer isso, em um prompt do shell do Linux, no terminal do macOS ou no prompt de comando do Windows, exiba a versão do executável da CLI do Databricks usando a opção
-v
ou executando o comandoversion
:databricks -v # Or: databricks version
Se for apresentado o número de versão 0.205.0 ou superior, isso significa que a CLI do Databricks está instalada corretamente.
Observação
Se você executar
databricks
mas receber um erro comocommand not found: databricks
, ou se você executardatabricks -v
e um número de versão 0.18 ou inferior for listado, isso significa que sua máquina não consegue encontrar a versão correta do executável da CLI do Databricks. Para corrigir isso, consulte Verificar sua instalação da CLI.No macOS, pode ser necessário autorizar seu sistema para poder executar a CLI do Databricks primeiro. Consulte Abrir um aplicativo do Mac de um desenvolvedor não identificado.
Prossiga com a Autenticação para a CLI do Databricks.
Atualização do Homebrew para Linux ou macOS
Para essa opção de atualização, use o Homebrew para atualizar automaticamente uma instalação anterior da CLI do Databricks versão 0.205 ou superior para a versão mais recente.
Em um prompt do shell do Linux ou no terminal do macOS, use o Homebrew para atualizar para a versão mais recente do executável da CLI do Databricks executando o seguinte comando:
brew upgrade databricks
Confirme se a CLI do Databricks foi atualizada corretamente. Para fazer isso, consulte a versão do executável da CLI do Databricks utilizando a opção
-v
ou executando o comandoversion
:databricks -v # Or: databricks version
Se o número da versão atualizada esperada for exibido, significa que a CLI do Databricks está instalada corretamente.
Para ver uma lista com as versões da CLI do Databricks, consulte a seção Versões do repositório da CLI do Databricks no GitHub. A versão mais recente tem um rótulo
Latest
ao lado dela na lista de versões.Observação
Se você executar
databricks
mas receber um erro comocommand not found: databricks
, ou se você executardatabricks -v
e um número de versão 0.18 ou inferior for listado, isso significa que sua máquina não consegue encontrar a versão correta do executável da CLI do Databricks. Para corrigir isso, consulte Verificar sua instalação da CLI.
Dica
Para fazer o downgrade da versão da CLI do Databricks , consulte as instruções no repositório databricks/homebrew-tap no GitHub.
Atualização do WinGet para Windows
Para esta opção de atualização, use winget para fazer download e atualizar automaticamente uma versão anterior da CLI do Databricks versão 0.205 ou acima para a versão mais recente.
No prompt de comando, use
winget
para fazer download e atualizar para a versão mais recente da CLI executável do Databricks executando o seguinte comando:winget upgrade Databricks.DatabricksCLI
Confirme se a CLI do Databricks está instalada corretamente. Para fazer isso, consulte a versão do executável da CLI do Databricks utilizando a opção
-v
ou executando o comandoversion
:databricks -v # Or: databricks version
Se o número da versão atualizada esperada for exibido, significa que a CLI do Databricks está instalada corretamente.
Para ver uma lista com as versões da CLI do Databricks, consulte a seção Versões do repositório da CLI do Databricks no GitHub. A versão mais recente tem um rótulo
Latest
ao lado dela na lista de versões.Observação
Se você executar
databricks
mas receber um erro comocommand not found: databricks
, ou se você executardatabricks -v
e um número de versão 0.18 ou inferior for listado, isso significa que sua máquina não consegue encontrar a versão correta do executável da CLI do Databricks. Para corrigir isso, consulte Verificar sua instalação da CLI.
Atualização do Chocolatey para Windows
Observação
Atualizar a CLI do Databricks com o Chocolatey é Experimental.
Para esta opção de atualização, use Chocolatey para fazer download e atualizar automaticamente uma versão anterior da CLI do Databricks versão 0.205 ou acima para a versão mais recente.
No prompt de comando, use
choco
para fazer download e atualizar para a versão mais recente da CLI executável do Databricks executando o seguinte comando:choco upgrade databricks-cli
Confirme se a CLI do Databricks está instalada corretamente. Para fazer isso, consulte a versão do executável da CLI do Databricks utilizando a opção
-v
ou executando o comandoversion
:databricks -v # Or: databricks version
Se o número da versão atualizada esperada for exibido, significa que a CLI do Databricks está instalada corretamente.
Para ver uma lista com as versões da CLI do Databricks, consulte a seção Versões do repositório da CLI do Databricks no GitHub. A versão mais recente tem um rótulo
Latest
ao lado dela na lista de versões.Observação
Se você executar
databricks
mas receber um erro comocommand not found: databricks
, ou se você executardatabricks -v
e um número de versão 0.18 ou inferior for listado, isso significa que sua máquina não consegue encontrar a versão correta do executável da CLI do Databricks. Para corrigir isso, consulte Verificar sua instalação da CLI.
atualização do curl para Linux, macOS e Windows
Para esta opção de atualização, use o curl para baixar e atualizar automaticamente uma instalação anterior da CLI do Databricks versão 0.205 ou superior para a versão mais recente.
Para Windows, o Databricks recomenda que você use o Windows Subsystem for Linux (WSL). Você precisa ter unzip
instalado. Para obter instruções de instalação, consulte a documentação do seu sistema operacional. Se você não puder usar o WSL, ignore este procedimento e use o prompt de comando ou o PowerShell para atualizar a CLI do Databricks do código-fonte .
Exclua a instalação existente do executável da CLI do Databricks no caminho
/usr/local/bin/databricks
no macOS e Linux ouC:\Windows\databricks.exe
no Windows.Em um prompt do shell do Linux, no terminal do macOS ou no prompt de comando do Windows, utilize
curl
para baixar e instalar a versão mais recente do executável da CLI do Databricks executando o seguinte comando (é necessário especificar os caracteres maiúsculos e minúsculos corretos para-fsSL
):curl -fsSL https://raw.githubusercontent.com/databricks/setup-cli/main/install.sh | sh
Observação
Para ver o conteúdo do script antes de executá-lo, consulte o arquivo install.sh no repositório de configuração da CLI do Databricks no GitHub.
No Windows, é necessário executar esse comando como administrador.
Para Linux e macOS, se uma mensagem de erro informar que não é possível gravar em
/usr/local/bin
, execute o comando novamente comsudo
.Esse comando baixa e instala o executável da CLI do Databricks no caminho
/usr/local/bin/databricks
no macOS e Linux eC:\Windows\databricks.exe
no Windows.Se o erro a seguir ocorrer, exclua manualmente o executável da CLI do Databricks do caminho anterior e, em seguida, execute o comando
curl
novamente: “O caminho de destino<path>
já existe”.Confirme se a CLI do Databricks foi atualizada corretamente. Para fazer isso, no seu terminal, consulte a versão do executável da CLI do Databricks utilizando a opção
-v
ou executando o comandoversion
:databricks -v # Or: databricks version
Se o número da versão atualizada esperada for exibido, significa que a CLI do Databricks está instalada corretamente.
Para ver uma lista com as versões da CLI do Databricks, consulte a seção Versões do repositório da CLI do Databricks no GitHub. A versão mais recente tem um rótulo
Latest
ao lado dela na lista de versões.Observação
Se você executar
databricks
mas receber um erro comocommand not found: databricks
, ou se você executardatabricks -v
e um número de versão 0.18 ou inferior for listado, isso significa que sua máquina não consegue encontrar a versão correta do executável da CLI do Databricks. Para corrigir isso, consulte Verificar sua instalação da CLI.
Atualização do código-fonte para Linux, macOS e Windows
Para essa opção de atualização, baixe manualmente um arquivo .zip
e depois extraia manualmente o executável da CLI do Databricks do arquivo .zip
baixado.
Ou então, exclua o executável da CLI do Databricks, o arquivo
.zip
e a pasta extraída do arquivo.zip
de qualquer procedimento anterior de instalação manual a partir do código-fonte.Continue seguindo as instruções em Instalação da origem para Linux, macOS e Windows.