Instalar ou atualizar a CLI da Databricks

nota

Databricks CLI O uso está sujeito à LicençaDatabricks e ao Aviso de PrivacidadeDatabricks, incluindo qualquer provisionamento de Dados de Uso.

Esta página descreve como instalar ou atualizar a CLI do Databricks. Consulte 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:

• macOS : Use Homebrew.
• Linux : Use curl ou compilações de origem.
• Windows : Use WinGet, Chocolatey, Windows Subsystem for Linux (WSL) ou compilações de código-fonte.

A CLI do Databricks também está disponível no workspace do Databricks. Consulte Execução de comandos da CLI do Databricks.

Atualizar

Para atualizar uma instalação anterior da CLI do Databricks versão 0.205 ou acima:

• macOS : Use Homebrew.
• Linux : Use 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 macOS

Para esta opção de instalação, use Homebrew para baixar e instalar automaticamente a versão mais recente da CLI do Databricks.

No seu terminal, execute os comandos Homebrew a seguir para instalar a CLI:

Bash

brew tap databricks/tap
brew trust databricks/tap
brew install databricks

O comando brew trust é necessário a partir do Homebrew 6.0.0, que exige que os taps de terceiros sejam explicitamente confiáveis antes que o Homebrew carregue suas fórmulas. Usuários existentes que adicionaram o tap antes de atualizar para o Homebrew 6.0.0 também devem executar brew trust databricks/tap.

Você também pode instalar em um único passo sem confiar em todo o recurso:

Bash

brew install databricks/tap/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:

1. 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:

   Bash

   brew -v

2. 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:

   Bash

   brew -v

3. 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:

   Bash

   brew tap databricks/tap

4. Deve-se confiar na fonte. A partir do Homebrew 6.0.0, os taps de terceiros precisam ser explicitamente confiados antes que o Homebrew carregue suas fórmulas. Execute o seguinte comando:

   Bash

   brew trust databricks/tap

   Usuários existentes que fizeram o 'tap' antes de atualizar para o Homebrew 6.0.0 também devem executar este comando.

5. Use o Homebrew para instruir o repositório databricks/homebrew-tap a fazer o download e instalar a CLI do Databricks executando o seguinte comando:

   Bash

   brew install databricks

6. Confirme se a CLI do Databricks está instalada corretamente. Para fazer isso, consulte a versão da CLI do Databricks utilizando a opção -v ou executando o comando version:

   Bash

   databricks -v
   
   # Or:
   databricks version

   Se a versão listada for 0.205.0 ou superior, o Databricks CLI está instalado corretamente.

7. Continue com a autenticação para a CLI da Databricks.

Instalação do WinGet para Windows

Para esta opção de instalação, utilize winget para baixar e instalar automaticamente a versão mais recente da CLI do Databricks.

1. No prompt de comando, execute os dois comandos winget a seguir para instalar a CLI e reinicie o prompt de comando:

   Bash

   winget search databricks
   winget install Databricks.DatabricksCLI

2. Confirme se a CLI do Databricks está instalada corretamente. Para fazer isso, visualize a versão da CLI do Databricks usando a opção -v ou executando o comando version:

   Bash

   databricks -v
   
   # Or:
   databricks version

Se a versão exibida for 0.205.0 ou superior, o Databricks CLI está instalado corretamente.

1. Continue com a autenticação para a CLI da Databricks.

Instalação do Chocolatey para Windows

nota

A instalação da CLI da Databricks com o Chocolatey é experimental.

Para esta opção de instalação, use Chocolatey para baixar e instalar automaticamente a versão mais recente da CLI do Databricks.

1. No seu prompt de comando, execute o seguinte comando choco para instalar a CLI:

   Bash

   choco install databricks-cli

2. Confirme se a CLI do Databricks está instalada corretamente. Para fazer isso, visualize a versão da CLI do Databricks usando a opção -v ou executando o comando version:

   Bash

   databricks -v
   
   # Or:
   databricks version

   Se a versão exibida for 0.205.0 ou superior, o Databricks CLI está instalado corretamente.

3. 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 invocar um script para instalar a versão 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.

1. curl deve ser instalado. Você pode verificar se o curl já está instalado executando o seguinte comando em um prompt de shell do Linux, no Terminal macOS ou no Bash em WSL. Se curl estiver instalado, o número da versão curl será exibido:

   Bash

   curl -V

2. Se o site curl ainda não estiver instalado, instale-o seguindo as instruções da página curl Releases and 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 :

   Bash

   curl -V

3. Use curl para baixar e instalar a CLI do Databricks executando o seguinte comando. Este comando diferencia maiúsculas de minúsculas.

   Bash

   curl -fsSL https://raw.githubusercontent.com/databricks/setup-cli/main/install.sh | sh

nota

Para view o conteúdo do script antes de executá-lo, consulte o arquivo install.sh no repositório Databricks CLI Setup em 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.

Este comando baixa e instala a 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 será exibido: “Caminho de destino <path> já existe.” Para corrigir isso, você deve excluir manualmente a 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, visualize a versão da CLI do Databricks usando a opção -v ou executando o comando version:

Bash

databricks -v

# Or:
databricks version

Se a versão exibida for 0.205.0 ou superior, o Databricks CLI está instalado corretamente. 5. 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 a CLI do Databricks do arquivo .zip baixado.

1. 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ótulo Latest ao lado dela na lista de versões. O pré-lançamento mais recente tem um rótulo Pre-release e é mais adequado para experimentação e para os primeiros usuários. O arquivo .zip que o senhor download da seção Assets 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

   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 da sua máquina, consulte a documentação do seu sistema operacional. Por exemplo:

   • Linux: os comandos de terminal uname -m, lscpu ou sudo 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 o senhor precisar verificar a integridade de um desses arquivos .zip, a Databricks fornece um arquivo de soma de verificação denominado databricks_cli_X.Y.Z_SHA256SUMS na mesma lista que os arquivos .zip. Para executar uma verificação de checksum, consulte a documentação do seu sistema operacional.

2. Extraia o conteúdo do arquivo de downloads .zip. Para extrair o arquivo .zip, consulte a documentação do seu sistema operacional.

3. No conteúdo extraído, uma pasta aparece com o mesmo nome do arquivo .zip. Dentro desta pasta está a CLI do Databricks. Você pode deixar a CLI do Databricks lá, ou pode copiá-la ou movê-la para outro local.

4. Confirme se a CLI do Databricks está instalada corretamente. Para fazer isso, em um prompt do shell do Linux, Terminal do macOS ou Prompt de Comando do Windows, exiba a versão da CLI do Databricks usando a opção -v ou executando o comando version:

   Bash

   databricks -v
   
   # Or:
   databricks version

   Se a versão exibida for 0.205.0 ou superior, o Databricks CLI está instalado corretamente.

nota

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.

5. 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.

1. Em um prompt do shell do Linux ou no terminal do macOS, use o Homebrew para baixar e atualizar para a versão mais recente da CLI do Databricks executando o seguinte comando:

   Bash

   brew upgrade databricks

2. Confirme se a CLI do Databricks foi atualizada corretamente. Para fazer isso, consulte a versão da CLI do Databricks utilizando a opção -v ou executando o comando version:

   Bash

   databricks -v
   
   # Or:
   databricks version

   Se a versão exibida for 0.205.0 ou superior, o Databricks CLI está instalado 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.

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.

1. No prompt de comando, utilize winget para baixar e atualizar para a versão mais recente da CLI do Databricks executando o seguinte comando:

   Bash

   winget upgrade Databricks.DatabricksCLI

2. Confirme se a CLI do Databricks está instalada corretamente. Para fazer isso, visualize a versão da CLI do Databricks usando a opção -v ou executando o comando version:

   Bash

   databricks -v
   
   # Or:
   databricks version

   Se a versão exibida for 0.205.0 ou superior, o Databricks CLI está instalado 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.

Atualização de chocolate para Windows

nota

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.

1. No prompt de comando, utilize choco para baixar e atualizar para a versão mais recente da CLI do Databricks executando o seguinte comando:

   Bash

   choco upgrade databricks-cli

2. Confirme se a CLI do Databricks está instalada corretamente. Para fazer isso, visualize a versão da CLI do Databricks usando a opção -v ou executando o comando version:

   Bash

   databricks -v
   
   # Or:
   databricks version

   Se a versão exibida for 0.205.0 ou superior, o Databricks CLI está instalado 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.

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.

1. Exclua a instalação existente da CLI do Databricks no caminho /usr/local/bin/databricks no macOS e Linux, ou C:\Windows\databricks.exe no Windows.

2. Em um prompt do shell do Linux, Terminal do macOS ou prompt de Comando do Windows, use curl para baixar e instalar a versão mais recente da CLI do Databricks executando o seguinte comando (observe que você deve especificar os caracteres maiúsculos e minúsculos corretos para -fsSL):

   Bash

   curl -fsSL https://raw.githubusercontent.com/databricks/setup-cli/main/install.sh | sh

nota

Para view o conteúdo do script antes de executá-lo, consulte o arquivo install.sh no repositório Databricks CLI Setup em 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.

Este comando baixa e instala a 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, exclua manualmente a 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 da CLI do Databricks utilizando a opção -v ou executando o comando version:

Bash

databricks -v

# Or:
databricks version

Se a versão exibida for 0.205.0 ou superior, o Databricks CLI está instalado 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.

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.

1. Opcionalmente, exclua o executável da CLI do Databricks, o arquivo .zip e a pasta extraída do arquivo .zip, de qualquer instalação de origem manual anterior.
2. Continue seguindo as instruções na instalação do código-fonte para Linux, macOS e Windows.