Compartilhar via

Instalar ou atualizar a CLI do Databricks

  • Artigo

Observação

Essas informações se aplicam às versões da CLI do Databricks 0.205 e superiores, que estão em Versão Prévia Pública. Para localizar sua versão da CLI do Databricks, execute databricks -v.

Esse artigo descreve como instalar ou atualizar a CLI do Databricks. Confira O que é a CLI do Databricks?.

Instalar

Para instalar a CLI do Databricks versão 0.205 ou superior:

A CLI do Databricks também está disponível na interface do usuário do workspace do Azure Databricks. Consulte Executar a CLI do Databricks em um workspace do Azure 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, você usará o Homebrew para baixar e instalar automaticamente a versão mais recente do executável da CLI do Databricks.

A partir do 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 tiver certeza se já tem o Homebrew instalado ou se os comandos do Homebrew anteriores falharem, siga essas instruções mais longas:

  1. Verifique se Homebrew já está instalado executando o comando a seguir de um prompt de shell do Linux ou do Terminal do macOS. Se o Homebrew estiver instalado, o número de versão do Homebrew será exibido:

    brew -v

  2. Se o Homebrew ainda não estiver instalado, instale-o ao executar 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 de versão Homebrew:

    brew -v

  3. Use Homebrew para adicionar o repositório databricks/homebrew-tap no GitHub à sua lista de repositórios disponíveis Homebrew Tap executando o seguinte comando:

    brew tap databricks/tap

  4. Use Homebrew para instruir o databricks/homebrew-tap repositório 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, 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 um número de versão 0.205.0 ou superior estiver listado, isso significa que a CLI do Databricks foi 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 estiver listado, isso significa que seu computador não poderá encontrar a versão correta do executável da CLI do Databricks. Para corrigir isso, confira: Verificar sua instalação da CLI.

  6. Prossiga com a Autenticação para a CLI do Databricks.

instalação do WinGet para Windows

Para essa opção de instalação, você usará o winget para baixar e instalar automaticamente a versão mais recente do 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, 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 um número de versão 0.205.0 ou superior estiver listado, isso significa que a CLI do Databricks foi 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 estiver listado, isso significa que seu computador não poderá encontrar a versão correta do executável da CLI do Databricks. Para corrigir isso, confira: 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

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

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

  1. No 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, 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 um número de versão 0.205.0 ou superior estiver listado, isso significa que a CLI do Databricks foi 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 estiver listado, isso significa que seu computador não poderá encontrar a versão correta do executável da CLI do Databricks. Para corrigir isso, confira: Verificar sua instalação da CLI.

  3. Prossiga com a Autenticação para a CLI do Databricks.

Instalação do curl para Linux, macOS e Windows

Para essa opção de instalação, você usará o curl para baixar e instalar automaticamente a versão mais recente do executável da CLI do Databricks.

Para o Windows, o Databricks recomenda que você use o Subsistema do Windows para Linux (WSL). Você também deve ter unzip instalado. Para obter instruções de instalação, confira a documentação do 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 da origem.

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

    curl -V

  2. Se curl ainda não estiver instalado, instale-o seguindo as instruções na página curlVersões e downloads do sistema operacional e da arquitetura. Para obter a arquitetura do computador, confira a documentação do sistema operacional.

    Em seguida, execute o seguinte comando para verificar a instalação curl, que exibe o número da versão curl:

    curl -V

  3. Use curl para baixar 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 ver o conteúdo do script antes de executá-lo, confira o arquivo install.sh no repositório da Instalação da CLI do Databricks no GitHub.

    Para o Windows, você deve executar esse comando como administrador.

    Para o Linux ou macOS, se uma mensagem de erro indicar que /usr/local/bin não é gravável, execute o comando novamente com o sudo.

    Esse comando baixa e instala o executável da CLI do Databricks no caminho /usr/local/bin/databricks no macOS e no Linux e C:\Windows\databricks.exe no Windows.

    Se, por algum motivo, a CLI do Databricks já estiver instalada, o seguinte erro será exibido: "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.

  4. Confirme se a CLI do Databricks está instalada corretamente. Para fazer isso, 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 um número de versão 0.205.0 ou superior estiver listado, isso significa que a CLI do Databricks foi 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 estiver listado, isso significa que seu computador não poderá encontrar a versão correta do executável da CLI do Databricks. Para corrigir isso, confira: Verificar sua instalação da CLI.

  5. Prossiga com a Autenticação para a CLI do Databricks.

Instalação de origem para Linux, macOS e Windows

Para essa opção de instalação, baixe manualmente um .zip arquivo e, em seguida, extraia manualmente o executável da CLI do Databricks do arquivo baixado .zip.

  1. Baixe o arquivo .zip mais recente da CLI do Databricks no seu computador 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 na lista de versões. A versão de pré-lançamento mais recente tem um rótulo Pre-release e é mais adequada para experimentação e para usuários pioneiros. O arquivo .zip que você baixa da seção Assets para a versão deve corresponder ao sistema operacional e à arquitetura do seu computador de desenvolvimento:

    Filename Arquitetura
    databricks_cli_X.Y.Z_darwin_amd64.zip macOS, Intel 64-bit/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-bit/x86_64
    databricks_cli_X.Y.Z_linux_arm64.zip Linux, ARM 64-bit/arm64
    databricks_cli_X.Y.Z_windows_386.zip Windows, Intel 32-bit/x86
    databricks_cli_X.Y.Z_windows_amd64.zip Windows, Intel 64-bit/AMD64
    databricks_cli_X.Y.Z_windows_arm64.zip Windows, ARM 64-bit/ARM64

    Para obter a arquitetura do computador, confira a documentação do sistema operacional. Por exemplo:

    • Linux: comandos do terminal uname -m, lscpu ou sudo lshw -c cpu.
    • macOS: ícone de menu da Apple>Sobre esse Mac ou o comando uname -m do Terminal.
    • Windows: Prompt de Comando ou o comando echo %PROCESSOR_ARCHITECTURE% do PowerShell.

    Se você precisar verificar a integridade de um desses .zip arquivos, o Databricks fornecerá um arquivo de soma de verificação chamado databricks_cli_X.Y.Z_SHA256SUMS na mesma lista que os .zip arquivos. Para executar uma verificação de soma de verificação, consulte a documentação do sistema operacional.

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

  3. No conteúdo extraído, uma pasta aparece com o mesmo nome que o .zip arquivo. Dentro dessa 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.

  4. Confirme se a CLI do Databricks está instalada corretamente. Para fazer isso, de um prompt de shell do Linux, do Terminal do macOS ou do Prompt de Comando do Windows, veja 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 superior estiver listado, isso significa que a CLI do Databricks foi 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 estiver listado, isso significa que seu computador não poderá encontrar a versão correta do executável da CLI do Databricks. Para corrigir isso, confira: Verificar sua instalação da CLI.

    Para o macOS, talvez você precise primeiro autorizar seu sistema a executar a CLI do Databricks. Confira Abrir um aplicativo Mac a partir 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, você usará 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. De um prompt de shell do Linux ou do Terminal do macOS, use o Homebrew para baixar e 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, 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 o número de versão atualizado esperado for exibido, a CLI do Databricks será instalada corretamente.

    Para obter uma lista das versões da CLI do Databricks, consulte a página Versões do repositório da CLI do Databricks no GitHub. A versão mais recente tem um rótulo Latest ao lado 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 estiver listado, isso significa que seu computador não poderá encontrar a versão correta do executável da CLI do Databricks. Para corrigir isso, confira: Verificar sua 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 do WinGet para Windows

Para essa 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 superior para a versão mais recente.

  1. No prompt de comando, use winget para fazer download e atualizar para a versão mais recente do executável da CLI da Databricks, executando o seguinte comando:

    winget upgrade Databricks.DatabricksCLI

  2. Confirme se a CLI do Databricks está instalada corretamente. Para fazer isso, 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 o número de versão atualizado esperado for exibido, a CLI do Databricks será instalada corretamente.

    Para obter uma lista das versões da CLI do Databricks, consulte a página Versões do repositório da CLI do Databricks no GitHub. A versão mais recente tem um rótulo Latest ao lado 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 estiver listado, isso significa que seu computador não poderá encontrar a versão correta do executável da CLI do Databricks. Para corrigir isso, confira: Verificar sua instalação da CLI.

Atualização do Chocolatey para Windows

Observação

A atualização da CLI do Databricks com o Chocolatey é Experimental.

Para essa 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 superior para a versão mais recente.

  1. No prompt de comando, use choco para fazer download e atualizar para a versão mais recente do executável da CLI da Databricks, executando o seguinte comando:

    choco upgrade databricks-cli

  2. Confirme se a CLI do Databricks está instalada corretamente. Para fazer isso, 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 o número de versão atualizado esperado for exibido, a CLI do Databricks será instalada corretamente.

    Para obter uma lista das versões da CLI do Databricks, consulte a página Versões do repositório da CLI do Databricks no GitHub. A versão mais recente tem um rótulo Latest ao lado 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 estiver listado, isso significa que seu computador não poderá encontrar a versão correta do executável da CLI do Databricks. Para corrigir isso, confira: Verificar sua instalação da CLI.

Atualização do curl para Linux, macOS e Windows

Para essa opção de atualização, você usará 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, o Databricks recomenda que você use o Subsistema do Windows para Linux (WSL). Você deve ter unzip instalado. Para obter instruções de instalação, confira a documentação do 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 a partir da origem.

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

  2. De um prompt de shell do Linux, do Terminal do macOS ou do Prompt de Comando do Windows, use o curl para baixar e instalar a versão mais recente do executável da CLI do Databricks executando o comando a seguir (observe que você precisa especificar as letras maiúsculas e minúsculas corretas para o -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, confira o arquivo install.sh no repositório da Instalação da CLI do Databricks no GitHub.

    Para o Windows, você deve executar esse comando como administrador.

    Para o Linux ou macOS, se uma mensagem de erro indicar que /usr/local/bin não é gravável, execute o comando novamente com o sudo.

    Esse comando baixa e instala o executável da CLI do Databricks no caminho /usr/local/bin/databricks no macOS e no Linux e C:\Windows\databricks.exe no Windows.

    Se o erro a seguir aparecer, você deverá excluir manualmente o executável da CLI do Databricks do caminho anterior e executar o comando curl novamente: "O caminho de destino <path> já existe".

  3. Confirme se a CLI do Databricks foi atualizada corretamente. Para fazê-lo, a partir do seu terminal, veja 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, a CLI do Databricks será instalada corretamente.

    Para obter uma lista das versões da CLI do Databricks, consulte a página Versões do repositório da CLI do Databricks no GitHub. A versão mais recente tem um rótulo Latest ao lado 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 estiver listado, isso significa que seu computador não poderá encontrar a versão correta do executável da CLI do Databricks. Para corrigir isso, confira: Verificar sua instalação da CLI.

Atualização de origem para Linux, macOS e Windows

Para essa opção de instalação, você irá baixar manualmente um arquivo .zip e, em seguida, extrair 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 procedimento de instalação de origem manual anterior.
  2. Prossiga seguindo as instruções contidas em Instalação de origem para Linux, macOS e Windows.

Executar a CLI do Databricks em um workspace do Azure Databricks .

Você pode acessar a CLI do Databricks do terminal Web em um notebook conectado a um cluster em execução ou diretamente do terminal da Web de um cluster em execução. A CLI disponível é sempre a versão mais recente e a autenticação é baseada no usuário atual. O cluster deve atender aos seguintes requisitos:

  • O cluster deve ter o Databricks Runtime 15.0 ou superior instalado.
  • O cluster deve usar um modo de acesso de cluster de Usuário único ou Sem isolamento compartilhado. Não há suporte para o modo de acesso Compartilhado do cluster.
  • Não há suporte para a computação sem servidor.
  • O workspace não deve ser habilitado no Link Privado.

Para acessar a CLI do terminal Web de um notebook, faça o seguinte:

  1. Conecte o notebook a um cluster que atenda aos requisitos anteriores.

  2. Na parte inferior da barra lateral direita do notebook, clique no ícone Abrir painel inferiorAbra o painel inferior no notebook.

  3. Use a CLI no painel do 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 Web de um cluster, faça o seguinte:

  1. Na barra lateral do workspace, clique em Computação.

  2. Na guia Computação para todos os fins, clique no nome de um cluster que atenda aos requisitos anteriores.

  3. Clique em Iniciar.

  4. Depois que o cluster for iniciado, na guia Aplicativos, clique em Terminal da Web.

  5. Use a CLI no terminal Web do Databricks que aparece. Por exemplo, o comando a seguir imprime informações sobre o usuário atual:

    databricks current-user me