Instalar ou atualizar a CLI do Databricks

Observação

Esta informação se aplica às versões 0.205 e acima do Databricks CLI, que estão em Public Preview. 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 acima:

A CLI da Databricks também está disponível na interface de usuário da Databricks workspace. Veja como executar a CLI do Databricks em um espaço de trabalho do Databricks.

Atualizar

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

Instalação do Homebrew para Linux ou macOS

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

Do seu terminal, basta executar os dois comandos Homebrew a seguir 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 tem certeza se o Homebrew está instalado ou se o comando anterior do Homebrew falhou, siga estas instruções mais longas:

  1. Verifique se o Homebrew já está instalado executando o seguinte comando em um prompt de shell do Linux ou no 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 repositório databricks/homebrew-tap a downloads 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, view a versão do executável da CLI do Databricks usando a opção -v ou executando o comando version:

    databricks -v

# Or:
databricks version

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

    Observação

    Se você executar databricks mas obtiver um erro como command not found: databricks, ou se executar databricks -v e um número de versão 0,18 ou abaixo estiver listado, isso significa que sua máquina não consegue encontrar a versão correta do executável da CLI do Databricks. Para corrigir isso, consulte Verifique a instalação da CLI.

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

Instalação do WinGet para Windows

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

  1. No prompt de comando, execute os dois comandos winget 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, view a versão do executável da CLI do Databricks usando a opção -v ou executando o comando version:

    databricks -v

# Or:
databricks version

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

    Observação

    Se você executar databricks mas obtiver um erro como command not found: databricks, ou se executar databricks -v e um número de versão 0,18 ou abaixo estiver listado, isso significa que sua máquina não consegue encontrar a versão correta do executável da CLI do Databricks. Para corrigir isso, consulte Verifique a instalação da CLI.

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

Instalação chocolatey para Windows

Observação

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

  1. No prompt de comando, execute o seguinte comando choco para instalar a CLI:

    choco install databricks-cli

  2. Confirme se a CLI do Databricks está instalada corretamente. Para fazer isso, view a versão do executável da CLI do Databricks usando a opção -v ou executando o comando version:

    databricks -v

# Or:
databricks version

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

    Observação

    Se você executar databricks mas obtiver um erro como command not found: databricks, ou se executar databricks -v e um número de versão 0,18 ou abaixo estiver listado, isso significa que sua máquina não consegue encontrar a versão correta do executável da CLI do Databricks. Para corrigir isso, consulte Verifique a instalação da CLI.

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

instalação curl para Linux, macOS e Windows

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

Para Windows, a Databricks recomenda que você use o Windows Subsystem for Linux (WSL). Você também deve ter unzip instalado. Para obter instruções de instalação, consulte a documentação do seu 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 da origem .

  1. curl Deve ser instalado. Você pode verificar se curl já está instalado executando o seguinte comando em um prompt de shell do Linux, terminal macOS ou Bash no WSL. Se curl estiver instalado, o número da versão curl será exibido:

    curl -V

  2. Se curl ainda não estiver instalado, instale-o seguindo as instruções na página curl Versões e 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 :

    curl -V

  3. Use curl para downloads 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

    Observação

    Para view 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 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 downloads 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 aparecerá: “O 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, view a versão do executável da CLI do Databricks usando a opção -v ou executando o comando version:

    databricks -v

# Or:
databricks version

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

    Observação

    Se você executar databricks mas obtiver um erro como command not found: databricks, ou se executar databricks -v e um número de versão 0,18 ou abaixo estiver listado, isso significa que sua máquina não consegue encontrar a versão correta do executável da CLI do Databricks. Para corrigir isso, consulte Verifique a instalação da CLI.

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

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

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

  1. downloads em sua máquina de desenvolvimento local o arquivo CLI .zip do Databricks mais recente, conforme listado na seção Versões do repositório CLI do Databricks no GitHub. O lançamento mais recente tem um rótulo Latest próximo a ele na lista de lançamentos. O pré-lançamento mais recente tem um rótulo Pre-release e é mais adequado para experimentação e primeiros usuários. O arquivo .zip downloads da seção Assets da 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 de 64 bits / x86_64

    databricks_cli_X.Y.Z_darwin_arm64.zip

    macOS, Apple Silicon / Série M / 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 de 64 bits / arm64

    databricks_cli_X.Y.Z_windows_386.zip

    Windows, Intel de 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: O comando do terminal uname -m, lscpu ou sudo lshw -c cpu.

    • macOS: menu do ícone Apple > Sobre este Mac ou o comando Terminal uname -m.

    • Windows: o prompt de comando ou comando do 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 dos arquivos .zip . Para executar uma verificação de checksum, consulte a documentação do seu sistema operacional.

  2. Extraia o conteúdo do arquivo downloads .zip. Para extrair o arquivo .zip , consulte a documentação do seu sistema operacional.

  3. No conteúdo extraído, aparece uma pasta com o mesmo nome do arquivo .zip . Dentro desta pasta está o executável da CLI do Databricks. Você pode deixar o executável da CLI do Databricks lá ou 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, view a versão do executável da CLI do Databricks usando a opção -v ou executando o comando version:

    databricks -v

# Or:
databricks version

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

    Observação

    Se você executar databricks mas obtiver um erro como command not found: databricks, ou se executar databricks -v e um número de versão 0,18 ou abaixo estiver listado, isso significa que sua máquina não consegue encontrar a versão correta do executável da CLI do Databricks. Para corrigir isso, consulte Verifique a instalação da CLI.

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

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

  1. A partir de um prompt de shell do Linux ou do Terminal macOS, use o Homebrew para downloads e atualizar para a versão mais recente do executável CLI do Databricks executando o seguinte comando:

    brew upgrade databricks

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

    databricks -v

# Or:
databricks version

    Se o número de versão atualizado esperado for exibido, então a CLI do Databricks está instalada corretamente.

    Para obter uma lista de versões CLI do Databricks, consulte a seção Releases do repositório CLI do Databricks no GitHub. A versão mais recente tem um rótulo Latest próximo a ela na lista de versões.

    Observação

    Se você executar databricks mas obtiver um erro como command not found: databricks, ou se executar databricks -v e um número de versão 0,18 ou abaixo estiver listado, isso significa que sua máquina não consegue encontrar a versão correta do executável da CLI do Databricks. Para corrigir isso, consulte Verifique a instalação da CLI.

Atualização WinGet para Windows

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

    databricks -v

# Or:
databricks version

    Se o número de versão atualizado esperado for exibido, então a CLI do Databricks está instalada corretamente.

    Para obter uma lista de versões CLI do Databricks, consulte a seção Releases do repositório CLI do Databricks no GitHub. A versão mais recente tem um rótulo Latest próximo a ela na lista de versões.

    Observação

    Se você executar databricks mas obtiver um erro como command not found: databricks, ou se executar databricks -v e um número de versão 0,18 ou abaixo estiver listado, isso significa que sua máquina não consegue encontrar a versão correta do executável da CLI do Databricks. Para corrigir isso, consulte Verifique a instalação da CLI.

Atualização achocolatada para Windows

Observação

Atualizar a CLI do Databricks com Chocolatey é experimental.

Para esta opção de atualização, você usa o Chocolatey para baixar e atualizar automaticamente uma versão anterior do Databricks CLI 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, view a versão do executável da CLI do Databricks usando a opção -v ou executando o comando version:

    databricks -v

# Or:
databricks version

    Se o número de versão atualizado esperado for exibido, então a CLI do Databricks está instalada corretamente.

    Para obter uma lista de versões CLI do Databricks, consulte a seção Releases do repositório CLI do Databricks no GitHub. A versão mais recente tem um rótulo Latest próximo a ela na lista de versões.

    Observação

    Se você executar databricks mas obtiver um erro como command not found: databricks, ou se executar databricks -v e um número de versão 0,18 ou abaixo estiver listado, isso significa que sua máquina não consegue encontrar a versão correta do executável da CLI do Databricks. Para corrigir isso, consulte Verifique a instalação da CLI.

atualização curl para Linux, macOS e Windows

Para esta opção de atualização, você usa curl para downloads e atualizar automaticamente uma instalação anterior do Databricks CLI versão 0.205 ouacima para a versão mais recente.

Para Windows, a Databricks recomenda que você use o Windows Subsystem for Linux (WSL). Você deve ter unzip instalado. Para obter instruções de instalação, consulte a documentação do seu 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 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 downloads e instalar a versão mais recente do executável CLI do Databricks executando o comando a seguir (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

    Observação

    Para view 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 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 downloads 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ê deverá excluir manualmente o executável da CLI do Databricks do caminho anterior e, em seguida, executar o comando curl novamente: “O caminho de destino <path> já existe”.

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

    databricks -v

# Or:
databricks version

    Se o número de versão atualizado esperado for exibido, então a CLI do Databricks está instalada corretamente.

    Para obter uma lista de versões CLI do Databricks, consulte a seção Releases do repositório CLI do Databricks no GitHub. A versão mais recente tem um rótulo Latest próximo a ela na lista de versões.

    Observação

    Se você executar databricks mas obtiver um erro como command not found: databricks, ou se executar databricks -v e um número de versão 0,18 ou abaixo estiver listado, isso significa que sua máquina não consegue encontrar a versão correta do executável da CLI do Databricks. Para corrigir isso, consulte Verifique a instalação da CLI.

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

Para esta opção de atualização, você downloads manualmente um arquivo .zip e depois extrai manualmente o executável da CLI do Databricks do arquivo .zip downloads .

  1. Opcionalmente, exclua o executável da CLI do Databricks, o arquivo .zip e a pasta extraída do arquivo .zip 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.

executar a CLI do Databricks em um espaço de trabalho do Databricks

O senhor pode acessar o Databricks CLI a partir do terminal da Web dentro de um Notebook que esteja conectado a um cluster em execução ou diretamente do terminal da Web para um cluster em execução. A CLI disponível é sempre a versão mais recente, e a autenticação é baseada no usuário atual. Os clusters devem atender aos seguintes requisitos:

  • Os clusters devem ter o Databricks Runtime 15.0 ou acima instalado.

  • Os clusters devem usar um modo de acesso aos clusters de Usuário único ou Sem isolamento compartilhado. Não há suporte para o modo de acesso a clusters compartilhados.

  • serverless compute não é suportado.

  • O site workspace não deve estar habilitado para o serviço Private Connect.

Para acessar a CLI do terminal da Web para um Notebook, faça o seguinte:

  1. Conecte o Notebook a um cluster que atenda aos requisitos anteriores.

  2. Na parte inferior da barra lateral direita do site Notebook, clique no ícone Open bottom panel (Abrir painel inferior ) Abra o painel inferior em Notebook.

  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 do terminal da Web para um cluster, faça o seguinte:

  1. Na barra lateral do site workspace, clique em compute.

  2. No All-purpose compute tab, clique no nome de um cluster que atenda aos requisitos anteriores.

  3. Clique em começar.

  4. Depois que os clusters começarem, no Apps tab, clique em Web Terminal.

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

    databricks current-user me