Instalar ou atualizar a CLI do Databricks

Nota

Essas informações se aplicam às versões 0.205 e superiores da CLI do Databricks. A CLI do Databricks está em Pré-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. Ver Databricks CLI. 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 Databricks também está disponível dentro da interface de utilizador do Azure Databricks workspace. 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 em 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 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, a CLI do Databricks será instalada corretamente.

  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 a saída for a versão 0.205.0 ou superior, a CLI do Databricks está instalada corretamente.

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

Instalação do 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 a saída for a versão 0.205.0 ou superior, a CLI do Databricks está instalada corretamente.

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

A instalação do 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 uses Windows Subsystem for 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 curlseguindo 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 visualizar o conteúdo do script antes de o executar, consulte o ficheiro install.sh no repositório de configuração da CLI Databricks em GitHub.

    No Windows, deve executar este 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 descarrega e instala o executável da CLI 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 a saída for a versão 0.205.0 ou superior, a CLI do Databricks está instalada corretamente.

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

Instalação a partir do código fonte 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. Descarregue para a sua máquina local de desenvolvimento o ficheiro mais recente da CLI Databricks .zip, conforme listado na secção Releases do repositório CLI Databricks em GitHub. O último lançamento tem um rótulo Latest 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 adotantes iniciais. O .zip arquivo que você baixa da Assets secção para o lançamento deve ser compatível com o sistema operacional e a arquitetura da máquina de desenvolvimento.

    Nome do ficheiro Arquitetura
    databricks_cli_X.Y.Z_darwin_amd64.zip macOS, arquitetura 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 64-bit / 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 Apple>Sobre Este Mac, ou o comando uname -m.
    • Windows: A Linha de Comandos ou o comando PowerShell echo %PROCESSOR_ARCHITECTURE%.

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

  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 isso, a partir de um prompt de shell Linux, terminal macOS ou prompt de comandos Windows, visualize a versão do executável da CLI Databricks usando a opção -v ou executando o comando version:

    databricks -v

# Or:
databricks version

    Se a saída for a versão 0.205.0 ou superior, a CLI do Databricks está instalada corretamente.

    Nota

    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, use 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 a saída for a versão 0.205.0 ou superior, a CLI do Databricks está instalada corretamente.

    Para uma lista de versões da CLI Databricks, consulte a secção Releases do repositório CLI Databricks em GitHub. O último lançamento tem um rótulo Latest ao lado na lista de lançamentos.

Gorjeta

Para fazer downgrade da versão da CLI 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 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 a saída for a versão 0.205.0 ou superior, a CLI do Databricks está instalada corretamente.

    Para uma lista de versões da CLI Databricks, consulte a secção Releases do repositório CLI Databricks em GitHub. O último lançamento tem um rótulo Latest ao lado na lista de lançamentos.

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 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 a saída for a versão 0.205.0 ou superior, a CLI do Databricks está instalada corretamente.

    Para uma lista de versões da CLI Databricks, consulte a secção Releases do repositório CLI Databricks em GitHub. O último lançamento tem um rótulo Latest ao lado na lista de lançamentos.

Atualização curl para Linux, macOS e Windows

Para esta opção de atualização, utilize o comando 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 uses Windows Subsystem for 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 a partir do de origem.

  1. Elimine a instalação existente do executável da CLI Databricks do caminho /usr/local/bin/databricks no macOS e Linux, ou C:\Windows\databricks.exe no Windows.

  2. A partir de um prompt de shell Linux, terminal macOS ou prompt de comandos Windows, use curl para descarregar e instalar a versão mais recente do executável da CLI Databricks executando o seguinte comando (note que 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 visualizar o conteúdo do script antes de o executar, consulte o ficheiro install.sh no repositório de configuração da CLI Databricks em GitHub.

    No Windows, deve executar este 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 descarrega e instala o executável da CLI 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 a saída for a versão 0.205.0 ou superior, a CLI do Databricks está instalada corretamente.

    Para uma lista de versões da CLI Databricks, consulte a secção Releases do repositório CLI Databricks em GitHub. O último lançamento tem um rótulo Latest ao lado na lista de lançamentos.

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

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

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