Tutorial da CLI do Databricks

Observação

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.

O utilitário de interface de linha de comando do Databricks (também conhecido como CLI do Databricks) disponibiliza uma interface fácil de usar para automatizar a plataforma Databricks pelo seu terminal, prompt de comando ou scripts de automação.

Este artigo demonstra como usar sua máquina de desenvolvimento local para começar rapidamente a usar a CLI do Databricks. Consulte O que é a CLI do Databricks?.

O tutorial prático a seguir pressupõe:

Execute os seguintes passos:

  1. Se ainda não estiver instalada, instale a CLI do Databricks da seguinte maneira:

    Use o Homebrew para instalar a CLI do Databricks executando os dois comandos a seguir:

    brew tap databricks/tap
brew install databricks

    Você pode usar o winget, Chocolatey ou Subsistema do Windows para Linux (WSL) para instalar o Databricks CLI. Se você não puder usar winget, Chocolatey ou WSL, ignore este procedimento e use o prompt de comando ou o PowerShell para instalar a CLI da Databricks do código fonte .

    Observação

    Instalar a CLI do Databricks com Chocolatey é Experimental.

    Para usar o winget para instalar a CLI do Databricks, execute os dois comandos a seguir e reinicie o prompt de comando:

    winget search databricks
winget install Databricks.DatabricksCLI

    Para usar o Chocolatey para instalar a CLI do Databricks, execute o seguinte comando:

    choco install databricks-cli

    Para usar o WSL para instalar a CLI do Databricks:

    1. Instale curl e zip através do WSL. Para obter mais informações, consulte a documentação do seu sistema operacional.

    2. Use o WSL para instalar a CLI do Databricks executando o seguinte comando:

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

  2. Confirme se a CLI do Databricks está instalada executando o seguinte comando, que exibe a versão atual da CLI do Databricks instalada. Esta versão deve ser 0.205.0 ou superior:

    databricks -v

    Observação

    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 0.18 ou inferior for listado, isso significa que sua máquina não consegue encontrar a versão correta do executável Databricks CLI. Para corrigir isso, consulte Verificar sua instalação da CLI.

Depois de instalar a CLI do Databricks, conclua os passos seguintes:

Observação

Este tutorial pressupõe que você deseja usar a autenticação OAuth user-to-machine (U2M) para autenticar a CLI usando sua account de usuário do Databricks. Para configurar a CLI para usar outros tipos de autenticação do Databricks, consulte Autenticação para a CLI do Databricks.

  1. Use a CLI do Databricks para iniciar o gerenciamento de token OAuth localmente executando o comando a seguir para cada account ou workspace de destino.

    Para operações de nível de account, no comando a seguir, substitua os seguintes placeholders:

    databricks auth login --host <account-console-url> --account-id <account-id>

    Para operações de nível de workspace, no comando a seguir, substitua <workspace-url> pelo URL da instância do workspace do seu Databricks, por exemplo https://1234567890123456.7.gcp.databricks.com.

    databricks auth login --host <workspace-url>

  2. O site Databricks CLI solicita que o senhor salve as informações inseridas como um Databricks perfil de configuração. Pressione Enter para aceitar o nome de perfil sugerido ou insira o nome de um perfil novo ou existente. Qualquer perfil existente com o mesmo nome é substituído pelas informações que o senhor inseriu. O senhor pode usar perfis para alternar rapidamente o contexto de autenticação entre várias contas ou espaços de trabalho.

    Para obter uma lista de todos os perfis existentes, em um terminal ou prompt de comando separado, use a CLI do Databricks para executar o comando databricks auth profiles. Para visualizar as configurações existentes de um perfil específico, execute o comando databricks auth env --profile <profile-name>.

  3. No seu navegador da web, siga as instruções na tela para fazer log in em sua account ou workspace do Databricks.

  4. Para visualizar o valor atual do token OAuth de um perfil e o registro de data e hora de expiração do token, execute um dos seguintes comandos:

    Para operações de nível de account, execute os seguintes comandos:

    • databricks auth token -p <profile-name>

    • databricks auth token --host <workspace-url> --account-id <account-id>

    • databricks auth token --host <workspace-url> --account-id <account-id> -p <profile-name>

    Se você tiver vários perfis com os mesmos valores --host e --account-id , talvez seja necessário especificar as opções --host, --account-id e -p juntas para ajudar a CLI do Databricks a encontrar as informações corretas do token OAuth correspondente.

    Para operações de nível de workspace, execute os seguintes comandos:

    • databricks auth token -p <profile-name>

    • databricks auth token --host <workspace-url>

    • databricks auth token --host <workspace-url> -p <profile-name>

    Se você tiver vários perfis com os mesmos valores de --host , talvez seja necessário especificar as opções de --host e -p juntas para ajudar a CLI do Databricks a encontrar as informações corretas de token OAuth correspondentes.

Próximos passos

Depois de configurar a CLI do Databricks: