Pular para o conteúdo principal
Última atualização em

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:

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:

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

    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.

  1. 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.
Nesta página