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.

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 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 comando version:
```
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 como command not found: databricks, ou se executar databricks -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 comando version:
```
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 como command not found: databricks, ou se executar databricks -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 comando version:
```
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 como command not found: databricks, ou se executar databricks -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 se curl já está instalado executando o seguinte comando em um prompt de shell do Linux, terminal macOS ou Bash no WSL. Se curl estiver instalado, o número da versão curl será exibido:
```
curl -V
```
Se curl ainda não estiver instalado, instale-o seguindo as instruções na página curl 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ão curl :
```
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 com sudo.

Este comando downloads 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, 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 comando curl 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 comando version:
```
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 como command not found: databricks, ou se executar databricks -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ótulo Latest próximo a ele na lista de lançamentos. O pré-lançamento mais recente tem um rótulo Pre-release e é mais adequado para experimentação e primeiros usuários. O arquivo .zip downloads da seção Assets 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 ou sudo 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 chamado databricks_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 comando version:
```
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 como command not found: databricks, ou se executar databricks -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 comando version:
```
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 como command not found: databricks, ou se executar databricks -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.

Dica

Para fazer downgrade da versão da CLI do Databricks, consulte as instruções no repositório databricks/homebrew-tap no GitHub.

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 comando version:
```
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 como command not found: databricks, ou se executar databricks -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 comando version:
```
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 como command not found: databricks, ou se executar databricks -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 ou C:\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 com sudo.

Este comando downloads 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 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 comando version:
```
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 como command not found: databricks, ou se executar databricks -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.