Pular para o conteúdo principal

Databricks CLI tutorial

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.

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 com o Databricks CLI. Consulte O que é a CLI do Databricks?

O tutorial prático a seguir pressupõe:

  • Para Linux ou macOS, que você tenha o Homebrew instalado.
nota

Se o senhor não puder usar o Homebrew, para obter outras maneiras de instalar a CLI, consulte Instalar ou atualizar a CLI da Databricks.

nota

A instalação da CLI da Databricks com o Chocolatey é experimental.

Se o senhor não puder usar winget, Chocolatey ou WSL, para obter outras maneiras de instalar a CLI, consulte Instalar ou atualizar a CLI da Databricks.

Execute os seguintes passos:

  1. Se ainda não estiver instalado, instale o Databricks CLI da seguinte forma:

Use Homebrew to install the Databricks CLI by running the following two commands:

Bash
brew tap databricks/tap
brew install databricks

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

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

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

nota

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

  1. Use o comando Databricks CLI para iniciar o gerenciamento de tokens OAuth localmente, executando o seguinte comando para cada destino account ou workspace.

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

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

    Para workspaceoperações de nível, no comando a seguir, substitua <workspace-url> pelo Databricks workspace URL da instância, por https://dbc-a1b2345c-d6e7.cloud.databricks.com exemplo,.

    Bash
    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óximas etapas​

Depois de configurar a CLI do Databricks:

Última atualização em