Partilhar via

Instalar ou atualizar a CLI do Databricks

  • Artigo

Nota

Essas informações se aplicam às versões 0.205 e superiores da CLI do Databricks. A CLI do Databricks está em Visualização Pública.

O uso da CLI do Databricks está sujeito à Licença do Databricks e ao Aviso de Privacidade do Databricks, incluindo quaisquer disposições de Dados de Uso.

Este artigo descreve como instalar ou atualizar a CLI do Databricks. Consulte O que é 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:

A CLI do Databricks também está disponível na interface do usuário do espaço de trabalho do Azure 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 esta opção de instalação, você usa o Homebrew para baixar e instalar automaticamente a versão executável mais recente da CLI do Databricks.

A partir do seu terminal, basta executar os seguintes dois comandos Homebrew 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 tiver certeza 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 a partir de um prompt de shell do Linux ou do Terminal macOS. Se o Homebrew estiver instalado, o número da versão do Homebrew 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 Homebrew Tap disponíveis, executando o seguinte comando:

    brew tap databricks/tap

  4. Use o 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 -v opção ou executando o version comando:

    databricks -v

# Or:
databricks version

    Se um número de versão de 0.205.0 ou superior estiver listado, isso significa que a CLI do Databricks está instalada corretamente.

    Nota

    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 de 0,18 ou abaixo estiver listado, isso significa que sua máquina não pode encontrar a versão correta do executável da CLI do Databricks. Para corrigir isso, consulte Verificar a instalação da CLI.

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

Instalação do WinGet para Windows

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

  1. No prompt de comando, execute os dois winget comandos 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 -v opção ou executando o version comando:

    databricks -v

# Or:
databricks version

    Se um número de versão de 0.205.0 ou superior estiver listado, isso significa que a CLI do Databricks está instalada corretamente.

    Nota

    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 de 0,18 ou abaixo estiver listado, isso significa que sua máquina não pode encontrar a versão correta do executável da CLI do Databricks. Para corrigir isso, consulte Verificar a instalação da CLI.

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

Instalação Chocolatey para Windows

Nota

Instalar a CLI 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 mais recente da CLI do Databricks.

  1. No prompt de comando, execute o seguinte choco comando 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 -v opção ou executando o version comando:

    databricks -v

# Or:
databricks version

    Se um número de versão de 0.205.0 ou superior estiver listado, isso significa que a CLI do Databricks está instalada corretamente.

    Nota

    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 de 0,18 ou abaixo estiver listado, isso significa que sua máquina não pode encontrar a versão correta do executável da CLI do Databricks. Para corrigir isso, consulte Verificar a instalação da CLI.

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

instalação curl para Linux, macOS e Windows

Para esta opção de instalação, use 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 Subsistema Windows para Linux (WSL). Você também deve ter unzip instalado. Para obter instruções de instalação, consulte 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 a partir do código-fonte .

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

    curl -V

  2. Se curl ainda não estiver instalado, instale-o curl seguindo as instruções na página Versões e Downloads do 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 curl instalação, que exibe o número da curl versão:

    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

    Nota

    Para exibir 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 esse 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 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, o seguinte erro será exibido: "O caminho <path> de destino já existe". Para corrigir isso, você deve excluir manualmente o executável da CLI do Databricks do caminho anterior e, em seguida, execute o curl comando 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 -v opção ou executando o version comando:

    databricks -v

# Or:
databricks version

    Se um número de versão de 0.205.0 ou superior estiver listado, isso significa que a CLI do Databricks está instalada corretamente.

    Nota

    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 de 0,18 ou abaixo estiver listado, isso significa que sua máquina não pode encontrar a versão correta do executável da CLI do Databricks. Para corrigir isso, consulte Verificar a instalação da CLI.

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

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

Para esta opção de instalação, você baixa manualmente um .zip arquivo e, em seguida, extrai manualmente o executável da CLI do Databricks do arquivo baixado .zip .

  1. Transfira para a sua máquina de desenvolvimento local o ficheiro mais recente da CLI .zip do Databricks, conforme listado na secção Releases do repositório da CLI do Databricks no GitHub. O último lançamento tem um Latest selo ao lado na lista de lançamentos. O último pré-lançamento tem um Pre-release rótulo e é mais adequado para experimentação e early adopters. O .zip arquivo baixado da Assets seção para a versão deve corresponder ao sistema operacional e à arquitetura da máquina de desenvolvimento:

    Nome do ficheiro 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 / M Série / arm64
    databricks_cli_X.Y.Z_linux_amd64.zip Linux, Intel de 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 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 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 uname -mdo terminal , lscpuou sudo lshw -c cpu.
    • macOS: menu> do ícone da Apple Sobre este Mac ou o comando uname -mTerminal .
    • Windows: O comando echo %PROCESSOR_ARCHITECTURE%Prompt de Comando ou PowerShell .

    Se você precisar verificar a integridade de um desses .zip arquivos, o Databricks fornece um arquivo de soma de verificação nomeado 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 ficheiro, consulte a .zip documentação do seu sistema operativo.

  3. No conteúdo extraído, uma pasta aparece com o mesmo nome do .zip arquivo. Dentro desta pasta está o executável da CLI do Databricks. 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 de shell do Linux, Terminal macOS ou Prompt de Comando do Windows, visualize a versão do executável da CLI do Databricks usando a -v opção ou executando o version comando:

    databricks -v

# Or:
databricks version

    Se um número de versão de 0.205.0 ou superior estiver listado, isso significa que a CLI do Databricks está instalada corretamente.

    Nota

    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 de 0,18 ou abaixo estiver listado, isso significa que sua máquina não pode encontrar a versão correta do executável da CLI do Databricks. Para corrigir isso, consulte Verificar a instalação da CLI.

    Para macOS, talvez seja necessário autorizar seu sistema para poder executar a CLI do Databricks primeiro. Consulte Abrir uma aplicação Mac a partir de um programador não identificado.

  5. Continue com a 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 da CLI do Databricks versão 0.205 ou superior para a versão mais recente.

  1. A partir de um prompt de shell do Linux ou do Terminal 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 está atualizada corretamente. Para fazer isso, exiba a versão do executável da CLI do Databricks usando a -v opção ou executando o version comando:

    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 de versões da CLI do Databricks, consulte a seção Releases do repositório da CLI do Databricks no GitHub. O último lançamento tem um Latest selo ao lado na lista de lançamentos.

    Nota

    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 de 0,18 ou abaixo estiver listado, isso significa que sua máquina não pode encontrar a versão correta do executável da CLI do Databricks. Para corrigir isso, consulte Verificar a instalação da CLI.

Gorjeta

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 esta opção de atualização, você usa o winget para baixar 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 baixar e atualizar para a versão mais recente do executável da CLI do 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 -v opção ou executando o version comando:

    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 de versões da CLI do Databricks, consulte a seção Releases do repositório da CLI do Databricks no GitHub. O último lançamento tem um Latest selo ao lado na lista de lançamentos.

    Nota

    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 de 0,18 ou abaixo estiver listado, isso significa que sua máquina não pode encontrar a versão correta do executável da CLI do Databricks. Para corrigir isso, consulte Verificar a instalação da CLI.

Atualização Chocolatey para Windows

Nota

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

Para esta opção de atualização, use o Chocolatey para baixar 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 baixar e atualizar para a versão mais recente do executável da CLI do 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 -v opção ou executando o version comando:

    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 de versões da CLI do Databricks, consulte a seção Releases do repositório da CLI do Databricks no GitHub. O último lançamento tem um Latest selo ao lado na lista de lançamentos.

    Nota

    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 de 0,18 ou abaixo estiver listado, isso significa que sua máquina não pode encontrar a versão correta do executável da CLI do Databricks. Para corrigir isso, consulte Verificar a instalação da CLI.

atualização curl para Linux, macOS e Windows

Para esta opção de atualização, você usa 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 Subsistema Windows para Linux (WSL). Você deve ter unzip instalado. Para obter instruções de instalação, consulte a documentação do 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 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. Em um prompt de shell do Linux, Terminal macOS ou Prompt de Comando do Windows, use curl para baixar e instalar a versão mais recente do 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):

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

    Nota

    Para exibir 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 esse 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 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 seguinte erro aparecer, você deve excluir manualmente o executável da CLI do Databricks do caminho anterior e, em seguida, execute o curl comando novamente: "O caminho <path> de destino já existe".

  3. Confirme se a CLI do Databricks está atualizada corretamente. Para fazer isso, a partir do seu terminal, visualize a versão do executável da CLI do Databricks usando a -v opção ou executando o version comando:

    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 de versões da CLI do Databricks, consulte a seção Releases do repositório da CLI do Databricks no GitHub. O último lançamento tem um Latest selo ao lado na lista de lançamentos.

    Nota

    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 de 0,18 ou abaixo estiver listado, isso significa que sua máquina não pode encontrar a versão correta do executável da CLI do Databricks. Para corrigir isso, consulte Verificar a instalação da CLI.

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

Para essa opção de atualização, você baixa manualmente um .zip arquivo e, em seguida, extrai manualmente o executável da CLI do Databricks do arquivo baixado .zip .

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