Instalar ou atualizar a CLI do Databricks

Nota

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

Este artigo descreve como instalar ou atualizar a CLI do Databricks. Consulte O que é a CLI do Databricks?.

Instalar

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

• Linux ou macOS: use Homebrew, curl ou compilações de código-fonte.
• Windows: Use WinGet, Chocolatey, Windows Subsystem for Linux (WSL) ou compilações de código-fonte.

A CLI do Databricks também está disponível na interface do usuário do espaço de trabalho do Azure Databricks. Consulte Executar a CLI do Databricks de dentro de um espaço de trabalho do Azure Databricks.

Atualizar

Para atualizar uma instalação anterior da CLI do Databricks versão 0.205 ou superior:

• Linux ou macOS: use Homebrew, curl ou compilações de código-fonte.
• Windows: Use WinGet, Chocolatey, Windows Subsystem for Linux (WSL) ou compilações de código-fonte.

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

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.

Execute a CLI do Databricks de dentro de um espaço de trabalho do Azure Databricks

Você pode acessar a CLI do Databricks a partir do terminal da Web dentro de um bloco de anotações 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 ao cluster de Usuário único ou Sem isolamento compartilhado. Não há suporte para o modo de acesso compartilhado ao cluster.
• Não há suporte para computação sem servidor.
• O espaço de trabalho não deve estar habilitado para Link Privado.

Para acessar a CLI a partir do terminal da Web de um bloco de anotações, faça o seguinte:

1. Conecte o bloco de anotações a um cluster que atenda aos requisitos anteriores.

2. Na parte inferior da barra lateral direita do bloco de notas, clique no ícone Abrir painel inferior .

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

1. Na barra lateral do espaço de trabalho, clique em Computar.

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

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

   databricks current-user me