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.

A interface Databricks comando-line (também conhecida como Databricks CLI) utilidades oferece uma interface fácil de usar para automatizar a plataforma Databricks a partir do seu terminal, prompt de comando ou scripts de automação. Consulte O que é a CLI do Databricks?

Este artigo demonstra como instalar e configurar rapidamente o Databricks CLI.

Confirme os requisitos locais da máquina

Este tutorial pressupõe que:

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

Instalar a CLI da Databricks

Primeiro, instale a CLI da Databricks:

  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.

Configure o acesso ao seu workspace

Em seguida, configure o acesso ao site Databricks workspace.

nota

Este tutorial usa 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://1234567890123456.7.gcp.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