Instalar ou atualizar a CLI da Databricks
Essas informações se aplicam ao site Databricks CLI versões 0.205 e superiores. A CLI da Databricks está em visualização pública.
Databricks CLI O uso está sujeito à LicençaDatabricks e ao Aviso de PrivacidadeDatabricks, incluindo qualquer provisionamento de Dados de Uso.
Este artigo descreve como instalar ou atualizar o site Databricks CLI. Consulte O que é a CLI do Databricks? Para configurar a autenticação para a CLI do Databricks, consulte Autenticação para 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 compilações de código-fonte.
O Databricks CLI também está disponível na interface de usuário Databricks workspace . Veja execução Databricks CLI comando.
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 compilações de código-fonte.
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, continue com Authentication for the Databricks CLI.
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 do Homebrew será exibido:
Bashbrew -v
-
Se o Homebrew ainda não estiver instalado, instale-o executando o seguinte comando:
Bash/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:
Bashbrew -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:
Bashbrew 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:Bashbrew 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
:Bashdatabricks -v
# Or:
databricks versionSe for apresentado o número de versão 0.205.0 ou superior, isso significa que a CLI do Databricks está instalada corretamente.
Se o senhor executar databricks
, mas receber um erro como command not found: databricks
, ou se executar databricks -v
e for listado um número de versão 0.18 ou abaixo, isso significa que o computador não consegue encontrar a versão correta do executável Databricks CLI . Para corrigir isso, consulte Verificar a instalação da CLI.
- Continue com a autenticação para a CLI da 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:Bashwinget 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
:Bashdatabricks -v
# Or:
databricks versionSe for apresentado o número de versão 0.205.0 ou superior, isso significa que a CLI do Databricks está instalada corretamente.
Se o senhor executar databricks
, mas receber um erro como command not found: databricks
, ou se executar databricks -v
e for listado um número de versão 0.18 ou abaixo, isso significa que o computador não consegue encontrar a versão correta do executável Databricks CLI . Para corrigir isso, consulte Verificar a instalação da CLI.
- Continue com a autenticação para a CLI da Databricks.
Instalação do Chocolatey para Windows
A instalação da CLI da Databricks com o 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:Bashchoco 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
:Bashdatabricks -v
# Or:
databricks versionSe for apresentado o número de versão 0.205.0 ou superior, isso significa que a CLI do Databricks está instalada corretamente.
Se o senhor executar databricks
, mas receber um erro como command not found: databricks
, ou se executar databricks -v
e for listado um número de versão 0.18 ou abaixo, isso significa que o computador não consegue encontrar a versão correta do executável Databricks CLI . Para corrigir isso, consulte Verificar a instalação da CLI.
- Continue com a autenticação para a CLI da Databricks.
Instalação do 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 o Windows, a Databricks recomenda que o senhor use o Windows Subsystem for Linux (WSL). Você também deve ter o unzip
instalado. Para obter instruções de instalação, consulte a documentação do seu sistema operacional. Se o senhor não puder usar a WSL, ignore este procedimento e use o prompt de comando ou o PowerShell para instalar a CLI da Databricks a partir da 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:Bashcurl -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
:Bashcurl -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):Bashcurl -fsSL https://raw.githubusercontent.com/databricks/setup-cli/main/install.sh | sh
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 com sudo
.
Esse comando baixa e instala o executável da CLI do Databricks no caminho /usr/local/bin/databricks
no macOS e Linux e C:\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 comando curl
novamente.
4. 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 comando version
:
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.
Se o senhor executar databricks
, mas receber um erro como command not found: databricks
, ou se executar databricks -v
e for listado um número de versão 0.18 ou abaixo, isso significa que o computador não consegue encontrar a versão correta do executável Databricks CLI . Para corrigir isso, consulte Verificar a instalação da CLI.
- Continue com a autenticação para a CLI da Databricks.
Instalação do 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.
-
Faça o download em sua máquina de desenvolvimento local do arquivo mais recente da Databricks CLI
.zip
, conforme listado na seção Releases do repositório da Databricks CLI no GitHub. A versão mais recente tem um rótuloLatest
ao lado dela na lista de versões. O pré-lançamento mais recente tem um rótuloPre-release
e é mais adequado para experimentação e para os primeiros usuários. O arquivo.zip
que o senhor download da seçãoAssets
para a versão deve corresponder ao sistema operacional e à arquitetura da sua 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. - Linux: os comandos de terminal
-
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
:Bashdatabricks -v
# Or:
databricks versionSe for apresentado o número de versão 0.205.0 ou superior, isso significa que a CLI do Databricks está instalada corretamente.
Se o senhor executar databricks
, mas receber um erro como command not found: databricks
, ou se executar databricks -v
e for listado um número de versão 0.18 ou abaixo, isso significa que o computador não consegue encontrar a versão correta do executável Databricks CLI . Para corrigir isso, consulte Verificar a 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.
- Continue com a autenticação para a CLI da 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:
Bashbrew 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
:Bashdatabricks -v
# Or:
databricks versionSe 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.
Se o senhor executar databricks
, mas receber um erro como command not found: databricks
, ou se executar databricks -v
e for listado um número de versão 0.18 ou abaixo, isso significa que o computador não consegue encontrar a versão correta do executável Databricks CLI . Para corrigir isso, consulte Verificar a instalação da CLI.
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:Bashwinget 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
:Bashdatabricks -v
# Or:
databricks versionSe 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.
Se o senhor executar databricks
, mas receber um erro como command not found: databricks
, ou se executar databricks -v
e for listado um número de versão 0.18 ou abaixo, isso significa que o computador não consegue encontrar a versão correta do executável Databricks CLI . Para corrigir isso, consulte Verificar a instalação da CLI.
Atualização de chocolate para Windows
A atualização da 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:Bashchoco 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
:Bashdatabricks -v
# Or:
databricks versionSe 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.
Se o senhor executar databricks
, mas receber um erro como command not found: databricks
, ou se executar databricks -v
e for listado um número de versão 0.18 ou abaixo, isso significa que o computador não consegue encontrar a versão correta do executável Databricks CLI . Para corrigir isso, consulte Verificar a 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 o Windows, a Databricks recomenda que o senhor use o Windows Subsystem for Linux (WSL). Você deve ter o unzip
instalado. Para obter instruções de instalação, consulte a documentação do seu sistema operacional. Se não for possível usar a WSL, o senhor deve ignorar este procedimento e usar o prompt de comando ou o PowerShell para atualizar a CLI do Databricks a partir da 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
):Bashcurl -fsSL https://raw.githubusercontent.com/databricks/setup-cli/main/install.sh | sh
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 com sudo
.
Esse comando baixa e instala o executável da CLI do Databricks no caminho /usr/local/bin/databricks
no macOS e Linux e C:\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”.
3. 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 comando version
:
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.
Se o senhor executar databricks
, mas receber um erro como command not found: databricks
, ou se executar databricks -v
e for listado um número de versão 0.18 ou abaixo, isso significa que o computador não consegue encontrar a versão correta do executável Databricks CLI . Para corrigir isso, consulte Verificar a 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 na instalação do código-fonte para Linux, macOS e Windows.