Pular para o conteúdo principal

Instalar ou atualizar a CLI da Databricks

nota

Essas informações se aplicam ao site Databricks CLI versões 0.205 e superiores. A CLI da Databricks está em visualização pública.

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

Este artigo descreve como instalar ou atualizar o site Databricks CLI. 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:

O Databricks CLI também está disponível na interface de usuário Databricks workspace . Veja execução Databricks CLI comando.

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:

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

    Bash
    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:

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

nota

Se o senhor executar databricks, mas receber um erro como command not found: databricks, ou se executar databricks -v e for listado um número de versão 0.18 ou abaixo, isso significa que o computador não consegue encontrar a versão correta do executável Databricks CLI . Para corrigir isso, consulte Verificar a instalação da CLI.

  1. Continue com a autenticação para a CLI da 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:

    Bash
    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:

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

nota

Se o senhor executar databricks, mas receber um erro como command not found: databricks, ou se executar databricks -v e for listado um número de versão 0.18 ou abaixo, isso significa que o computador não consegue encontrar a versão correta do executável Databricks CLI . Para corrigir isso, consulte Verificar a instalação da CLI.

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

    Bash
    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:

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

nota

Se o senhor executar databricks, mas receber um erro como command not found: databricks, ou se executar databricks -v e for listado um número de versão 0.18 ou abaixo, isso significa que o computador não consegue encontrar a versão correta do executável Databricks CLI . Para corrigir isso, consulte Verificar a instalação da CLI.

  1. 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 instalar a versão executável 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 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 :

    Bash
    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):

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

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:

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

nota

Se o senhor executar databricks, mas receber um erro como command not found: databricks, ou se executar databricks -v e for listado um número de versão 0.18 ou abaixo, isso significa que o computador não consegue encontrar a versão correta do executável Databricks CLI . Para corrigir isso, consulte Verificar a instalação da CLI.

  1. 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 o executável da 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 arquivoArquitetura
    databricks_cli_X.Y.Z_darwin_amd64.zipmacOS, Intel 64 bits / x86_64
    databricks_cli_X.Y.Z_darwin_arm64.zipmacOS, Apple Silicon / M Series / arm64
    databricks_cli_X.Y.Z_linux_amd64.zipLinux, Intel 64 bits / x86_64
    databricks_cli_X.Y.Z_linux_arm64.zipLinux, ARM 64 bits / arm64
    databricks_cli_X.Y.Z_windows_386.zipWindows, Intel 32 bits / x86
    databricks_cli_X.Y.Z_windows_amd64.zipWindows, Intel 64 bits / AMD64
    databricks_cli_X.Y.Z_windows_arm64.zipWindows, 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 :

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

nota

Se o senhor executar databricks, mas receber um erro como command not found: databricks, ou se executar databricks -v e for listado um número de versão 0.18 ou abaixo, isso significa que o computador não consegue encontrar a versão correta do executável Databricks CLI . Para corrigir isso, consulte Verificar a 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.

  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 atualizar para a versão mais recente do executável 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 do executável da CLI do Databricks utilizando a opção -v ou executando o comando version:

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

nota

Se o senhor executar databricks, mas receber um erro como command not found: databricks, ou se executar databricks -v e for listado um número de versão 0.18 ou abaixo, isso significa que o computador não consegue encontrar a versão correta do executável Databricks CLI . Para corrigir isso, consulte Verificar a 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:

    Bash
    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:

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

nota

Se o senhor executar databricks, mas receber um erro como command not found: databricks, ou se executar databricks -v e for listado um número de versão 0.18 ou abaixo, isso significa que o computador não consegue encontrar a versão correta do executável Databricks CLI . Para corrigir isso, consulte Verificar a instalação da CLI.

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, use choco para fazer download e atualizar para a versão mais recente da CLI executável do Databricks executando o seguinte comando:

    Bash
    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:

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

nota

Se o senhor executar databricks, mas receber um erro como command not found: databricks, ou se executar databricks -v e for listado um número de versão 0.18 ou abaixo, isso significa que o computador não consegue encontrar a versão correta do executável Databricks CLI . Para corrigir isso, consulte Verificar a 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 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 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):

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

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:

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

nota

Se o senhor executar databricks, mas receber um erro como command not found: databricks, ou se executar databricks -v e for listado um número de versão 0.18 ou abaixo, isso significa que o computador não consegue encontrar a versão correta do executável Databricks CLI . Para corrigir isso, consulte Verificar a 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 na instalação do código-fonte para Linux, macOS e Windows.