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:

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:

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:

  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 dele será exibido:

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

    brew tap databricks/tap
    
  4. 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
    
  5. 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.

    Observação

    Se você executar databricks mas receber um erro como command not found: databricks, ou se você executar databricks -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.

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

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

    Observação

    Se você executar databricks mas receber um erro como command not found: databricks, ou se você executar databricks -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.

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

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

    choco install databricks-cli
    
  2. 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.

    Observação

    Se você executar databricks mas receber um erro como command not found: databricks, ou se você executar databricks -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.

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

  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:

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

    curl -V
    
  3. 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 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.

    Observação

    Se você executar databricks mas receber um erro como command not found: databricks, ou se você executar databricks -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.

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

  1. 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ótulo Latest ao lado dela na lista de versões. A pré-versão mais recente tem um rótulo Pre-release e é mais adequada para experimentação e primeiros usuários. O arquivo .zip a ser baixado da seção Assets 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 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 você precisar verificar a integridade de um desses arquivos .zip, o Databricks disponibiliza 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 soma de verificação, consulte a documentação de seu sistema operacional.

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

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

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

    Observação

    Se você executar databricks mas receber um erro como command not found: databricks, ou se você executar databricks -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.

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

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

    Observação

    Se você executar databricks mas receber um erro como command not found: databricks, ou se você executar databricks -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.

  1. 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
    
  2. 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 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 como command not found: databricks, ou se você executar databricks -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.

  1. 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
    
  2. 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 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 como command not found: databricks, ou se você executar databricks -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 .

  1. Exclua a instalação existente do executável 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, 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 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.

    Observação

    Se você executar databricks mas receber um erro como command not found: databricks, ou se você executar databricks -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.

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

  2. Continue seguindo as instruções em Instalação da origem para Linux, macOS e Windows.