Instalar ou atualizar a CLI do Databricks
Observação
Esta informação se aplica às versões 0.205 e acima do Databricks CLI, que estão em Public Preview. 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 acima:
Linux ou macOS: use compilações Homebrew, curl ou source.
Windows: Use WinGet, Chocolatey, Windows Subsystem for Linux (WSL) ou compilações de origem.
A CLI da Databricks também está disponível na interface de usuário da Databricks workspace. Veja como executar a CLI do Databricks em um espaço de trabalho do Databricks.
Atualizar
Para atualizar uma instalação anterior do Databricks CLI versão 0.205 ou acima:
Linux ou macOS: use compilações Homebrew, curl ou source.
Windows: Use WinGet, Chocolatey, Windows Subsystem for Linux (WSL) ou compilações de origem.
Instalação do Homebrew para Linux ou macOS
Para esta opção de instalação, você usa o Homebrew para downloads e instalar automaticamente a versão executável da CLI do Databricks mais recente.
Do seu terminal, basta executar os dois comandos Homebrew a seguir para instalar a CLI:
brew tap databricks/tap
brew install databricks
Em seguida, continue com Autenticação para a CLI do Databricks.
Se você não tem certeza se o Homebrew está instalado ou se o comando anterior do Homebrew falhou, siga estas instruções mais longas:
Verifique se o Homebrew já está instalado executando o seguinte comando em um prompt de shell do Linux ou no terminal macOS. Se o Homebrew estiver instalado, o número da versão do Homebrew 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 Homebrew Tap disponíveis, executando o seguinte comando:
brew tap databricks/tap
Use o Homebrew para instruir o repositório
databricks/homebrew-tap
a downloads 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, view 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 um número de versão 0.205.0 ou acima estiver listado, significa que a CLI do Databricks está instalada corretamente.
Observação
Se você executar
databricks
mas obtiver um erro comocommand not found: databricks
, ou se executardatabricks -v
e um número de versão 0,18 ou abaixo estiver 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 Verifique a instalação da CLI.Continue com Autenticação para a CLI do Databricks.
Instalação do WinGet para Windows
Para esta opção de instalação, você usa winget para baixar e instalar automaticamente a versão executável da CLI do Databricks mais recente.
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, view 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 um número de versão 0.205.0 ou acima estiver listado, significa que a CLI do Databricks está instalada corretamente.
Observação
Se você executar
databricks
mas obtiver um erro comocommand not found: databricks
, ou se executardatabricks -v
e um número de versão 0,18 ou abaixo estiver 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 Verifique a instalação da CLI.Continue com Autenticação para a CLI do Databricks.
Instalação chocolatey para Windows
Observação
Instalar a CLI do Databricks com Chocolatey é experimental.
Para esta opção de instalação, você usa o Chocolatey para baixar e instalar automaticamente a versão executável da CLI do Databricks mais recente.
No 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, view 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 um número de versão 0.205.0 ou acima estiver listado, significa que a CLI do Databricks está instalada corretamente.
Observação
Se você executar
databricks
mas obtiver um erro comocommand not found: databricks
, ou se executardatabricks -v
e um número de versão 0,18 ou abaixo estiver 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 Verifique a instalação da CLI.Continue com Autenticação para a CLI do Databricks.
instalação curl para Linux, macOS e Windows
Para esta opção de instalação, você usa curl para downloads e instalar a versão executável da CLI do Databricks mais recente.
Para Windows, a 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, ignore este procedimento e use o prompt de comando ou o PowerShell para instalar a CLI do Databricks a partir da origem .
curl
Deve ser instalado. Você pode verificar securl
já está instalado executando o seguinte comando em um prompt de shell do Linux, terminal macOS ou Bash no WSL. Securl
estiver instalado, o número da versãocurl
será exibido:curl -V
Se
curl
ainda não estiver instalado, instale-o seguindo as instruções na páginacurl
Versões e downloads para seu sistema operacional e arquitetura. Para obter a arquitetura da sua máquina, consulte a documentação do 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 downloads e instalar o executável da CLI 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 view o conteúdo do script antes de executá-lo, consulte o arquivo install.sh no repositório de instalação da CLI do Databricks no GitHub.
Para Windows, você deve executar este comando como administrador.
Para Linux e macOS, se uma mensagem de erro indicar que
/usr/local/bin
não é gravável, execute o comando novamente comsudo
.Este comando downloads 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, o seguinte erro aparecerá: “O 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, view 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 um número de versão 0.205.0 ou acima estiver listado, significa que a CLI do Databricks está instalada corretamente.
Observação
Se você executar
databricks
mas obtiver um erro comocommand not found: databricks
, ou se executardatabricks -v
e um número de versão 0,18 ou abaixo estiver 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 Verifique a instalação da CLI.Continue com Autenticação para a CLI do Databricks.
Instalação de origem para Linux, macOS e Windows
Para esta opção de instalação, você downloads manualmente um arquivo .zip
e depois extrai manualmente o executável da CLI do Databricks do arquivo .zip
de downloads .
downloads em sua máquina de desenvolvimento local o arquivo CLI
.zip
do Databricks mais recente, conforme listado na seção Versões do repositório CLI do Databricks no GitHub. O lançamento mais recente tem um rótuloLatest
próximo a ele na lista de lançamentos. O pré-lançamento mais recente tem um rótuloPre-release
e é mais adequado para experimentação e primeiros usuários. O arquivo.zip
downloads da seçãoAssets
da 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 de 64 bits /
x86_64
databricks_cli_X.Y.Z_darwin_arm64.zip
macOS, Apple Silicon / Série
M
/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 de 64 bits /
arm64
databricks_cli_X.Y.Z_windows_386.zip
Windows, Intel de 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 da sua máquina, consulte a documentação do seu sistema operacional. Por exemplo:
Linux: O comando do terminal
uname -m
,lscpu
ousudo lshw -c cpu
.macOS: menu do ícone Apple > Sobre este Mac ou o comando Terminal
uname -m
.Windows: o prompt de comando ou comando do PowerShell
echo %PROCESSOR_ARCHITECTURE%
.
Se você precisar verificar a integridade de um desses arquivos
.zip
, o Databricks fornece 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 checksum, consulte a documentação do seu sistema operacional.Extraia o conteúdo do arquivo downloads
.zip
. Para extrair o arquivo.zip
, consulte a documentação do seu sistema operacional.No conteúdo extraído, aparece uma pasta com o mesmo nome do arquivo
.zip
. Dentro desta pasta está o executável da CLI do Databricks. Você pode deixar o executável da CLI do Databricks lá ou copiá-lo ou movê-lo para outro local.Confirme se a CLI do Databricks está instalada corretamente. Para fazer isso, em um prompt de shell do Linux, terminal macOS ou prompt de comando do Windows, view 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 um número de versão 0.205.0 ou acima estiver listado, significa que a CLI do Databricks está instalada corretamente.
Observação
Se você executar
databricks
mas obtiver um erro comocommand not found: databricks
, ou se executardatabricks -v
e um número de versão 0,18 ou abaixo estiver 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 Verifique a instalação da CLI.Para macOS, talvez seja necessário autorizar seu sistema para poder executar a CLI do Databricks primeiro. Consulte Abrir um aplicativo Mac de um desenvolvedor não identificado.
Continue com Autenticação para a CLI do Databricks.
Atualização do Homebrew para Linux ou macOS
Para esta opção de atualização, você usa o Homebrew para atualizar automaticamente uma instalação anterior do Databricks CLI versão 0.205 ou acima para a versão mais recente.
A partir de um prompt de shell do Linux ou do Terminal macOS, use o Homebrew para downloads e atualizar para a versão mais recente do executável CLI do Databricks executando o seguinte comando:
brew upgrade databricks
Confirme se a CLI do Databricks está atualizada corretamente. Para fazer isso, view 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 o número de versão atualizado esperado for exibido, então a CLI do Databricks está instalada corretamente.
Para obter uma lista de versões CLI do Databricks, consulte a seção Releases do repositório CLI do Databricks no GitHub. A versão mais recente tem um rótulo
Latest
próximo a ela na lista de versões.Observação
Se você executar
databricks
mas obtiver um erro comocommand not found: databricks
, ou se executardatabricks -v
e um número de versão 0,18 ou abaixo estiver 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 Verifique a instalação da CLI.
Atualização WinGet para Windows
Para esta opção de atualização, você usa winget para baixar e atualizar automaticamente uma versão anterior do Databricks CLI versão 0.205 ou superior para a versão mais recente.
No prompt de comando, use
winget
para baixar e atualizar para a versão mais recente do executável da CLI do Databricks executando o seguinte comando:winget upgrade Databricks.DatabricksCLI
Confirme se a CLI do Databricks está instalada corretamente. Para fazer isso, view 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 o número de versão atualizado esperado for exibido, então a CLI do Databricks está instalada corretamente.
Para obter uma lista de versões CLI do Databricks, consulte a seção Releases do repositório CLI do Databricks no GitHub. A versão mais recente tem um rótulo
Latest
próximo a ela na lista de versões.Observação
Se você executar
databricks
mas obtiver um erro comocommand not found: databricks
, ou se executardatabricks -v
e um número de versão 0,18 ou abaixo estiver 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 Verifique a instalação da CLI.
Atualização achocolatada para Windows
Observação
Atualizar a CLI do Databricks com Chocolatey é experimental.
Para esta opção de atualização, você usa o Chocolatey para baixar e atualizar automaticamente uma versão anterior do Databricks CLI versão 0.205 ou superior para a versão mais recente.
No prompt de comando, use
choco
para baixar e atualizar para a versão mais recente do executável da CLI do Databricks executando o seguinte comando:choco upgrade databricks-cli
Confirme se a CLI do Databricks está instalada corretamente. Para fazer isso, view 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 o número de versão atualizado esperado for exibido, então a CLI do Databricks está instalada corretamente.
Para obter uma lista de versões CLI do Databricks, consulte a seção Releases do repositório CLI do Databricks no GitHub. A versão mais recente tem um rótulo
Latest
próximo a ela na lista de versões.Observação
Se você executar
databricks
mas obtiver um erro comocommand not found: databricks
, ou se executardatabricks -v
e um número de versão 0,18 ou abaixo estiver 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 Verifique a instalação da CLI.
atualização curl para Linux, macOS e Windows
Para esta opção de atualização, você usa curl para downloads e atualizar automaticamente uma instalação anterior do Databricks CLI versão 0.205 ouacima para a versão mais recente.
Para Windows, a Databricks recomenda que você use o Windows Subsystem for Linux (WSL). Você deve ter unzip
instalado. Para obter instruções de instalação, consulte a documentação do seu sistema operacional. Se não puder usar o WSL, ignore este procedimento e use o prompt de comando ou o PowerShell para atualizar a CLI do Databricks a partir da origem .
Exclua a instalação existente do executável da CLI do Databricks do caminho
/usr/local/bin/databricks
no macOS e Linux ouC:\Windows\databricks.exe
no Windows.Em um prompt de shell do Linux, terminal macOS ou prompt de comando do Windows, use
curl
para downloads e instalar a versão mais recente do executável CLI do Databricks executando o comando a seguir (observe que você deve 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 view o conteúdo do script antes de executá-lo, consulte o arquivo install.sh no repositório de instalação da CLI do Databricks no GitHub.
Para Windows, você deve executar este comando como administrador.
Para Linux e macOS, se uma mensagem de erro indicar que
/usr/local/bin
não é gravável, execute o comando novamente comsudo
.Este comando downloads 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 seguinte erro aparecer, você deverá excluir manualmente o executável da CLI do Databricks do caminho anterior e, em seguida, executar o comando
curl
novamente: “O caminho de destino<path>
já existe”.Confirme se a CLI do Databricks está atualizada corretamente. Para fazer isso, no seu terminal, view 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 o número de versão atualizado esperado for exibido, então a CLI do Databricks está instalada corretamente.
Para obter uma lista de versões CLI do Databricks, consulte a seção Releases do repositório CLI do Databricks no GitHub. A versão mais recente tem um rótulo
Latest
próximo a ela na lista de versões.Observação
Se você executar
databricks
mas obtiver um erro comocommand not found: databricks
, ou se executardatabricks -v
e um número de versão 0,18 ou abaixo estiver 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 Verifique a instalação da CLI.
Atualização de origem para Linux, macOS e Windows
Para esta opção de atualização, você downloads manualmente um arquivo .zip
e depois extrai manualmente o executável da CLI do Databricks do arquivo .zip
downloads .
Opcionalmente, exclua o executável da CLI do Databricks, o arquivo
.zip
e a pasta extraída do arquivo.zip
de qualquer procedimento de instalação manual de origem anterior.Continue seguindo as instruções em Instalação de origem para Linux, macOS e Windows.
executar a CLI do Databricks em um espaço de trabalho do Databricks
O senhor pode acessar o Databricks CLI a partir do terminal da Web dentro de um Notebook que esteja conectado a um cluster em execução ou diretamente do terminal da Web para um cluster em execução. A CLI disponível é sempre a versão mais recente, e a autenticação é baseada no usuário atual. Os clusters devem atender aos seguintes requisitos:
Os clusters devem ter o Databricks Runtime 15.0 ou acima instalado.
Os clusters devem usar um modo de acesso aos clusters de Usuário único ou Sem isolamento compartilhado. Não há suporte para o modo de acesso a clusters compartilhados.
serverless compute não é suportado.
O endereço workspace não deve estar ativado para o PrivateLink.
Para acessar a CLI do terminal da Web para um Notebook, faça o seguinte:
Conecte o Notebook a um cluster que atenda aos requisitos anteriores.
Na parte inferior da barra lateral direita do site Notebook, clique no ícone Open bottom panel (Abrir painel inferior ) .
Use a CLI no painel Terminal que aparece. Por exemplo, o comando a seguir imprime informações sobre o usuário atual:
databricks current-user me
Para acessar a CLI do terminal da Web para um cluster, faça o seguinte:
Na barra lateral do site workspace, clique em compute.
No All-purpose compute tab, clique no nome de um cluster que atenda aos requisitos anteriores.
Clique em começar.
Depois que os clusters começarem, no Apps tab, clique em Web Terminal.
Use a CLI no terminal da Web do Databricks que é exibido. Por exemplo, o comando a seguir imprime informações sobre o usuário atual:
databricks current-user me