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:

    tab :::tab-item[Linux, macOS] Use o Homebrew para instalar o Databricks CLI executando os dois comandos a seguir:

    Bash
    brew tap databricks/tap
    brew install databricks

    :::

    :::tab-item[Windows] O senhor pode usar winget, Chocolatey ou Windows Subsystem for Linux (WSL) para instalar a CLI da Databricks. Se não for possível usar winget, Chocolatey ou WSL, o senhor deve ignorar este procedimento e usar o prompt de comando ou o PowerShell para instalar a CLI da Databricks a partir da fonte.

nota

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

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

Bash
winget search databricks
winget install Databricks.DatabricksCLI

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

Bash
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:

    Bash
    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. 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://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​

Última atualização em