Tutorial da 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.

A interface de linha de comando do Databricks (também conhecida como Databricks CLI) russas fornece uma interface fácil de usar para automatizar a plataforma Databricks a partir de 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 a CLI do Databricks. Consulte O que é a CLI do Databricks?.

O seguinte tutorial prático pressupõe:

Conclua os seguintes passos:

  1. Se ainda não estiver instalado, 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 winget, Chocolatey ou Windows Subsystem for Linux (WSL) para instalar a CLI do Databricks. 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 do Databricks a partir da origem .

    Observação

    Instalar a CLI do Databricks com Chocolatey é experimental.

    Para usar 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 WSL para instalar a CLI do Databricks:

    1. Instale curl e zip por meio do WSL. Para mais informações, consulte a documentação do seu sistema operacional.

    2. Use 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 comando a seguir, que exibe a versão atual da CLI do Databricks instalada. Esta versão deve ser 0.205.0 ou acima:

    databricks -v
    

    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.

Depois de instalar a CLI do Databricks, conclua as seguintes etapas:

Observação

Este tutorial pressupõe que o senhor deseja usar a autenticação OAuth user-to-machine (U2M) para autenticar a CLI usando o usuário do 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 a CLI do Databricks para iniciar o gerenciamento de tokens OAuth localmente, executando o seguinte comando para cada destino account ou workspace.

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

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

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

    databricks auth login --host <workspace-url>
    
  2. A CLI da Databricks solicita que o senhor salve as informações inseridas como um perfil de configuração da Databricks. Pressione Enter para aceitar o nome de perfil sugerido ou digite 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 separado ou prompt de comando, use a CLI do Databricks para executar o comando databricks auth profiles. Para view as configurações existentes de um perfil específico, execute o comando databricks auth env --profile <profile-name>.

  3. No navegador da Web, siga as instruções na tela para acessar o site log in para o seu Databricks account ou workspace.

  4. Para view o valor atual dos tokens OAuth de um perfil e a data de expiração futura dos tokens, execute um dos seguintes comandos:

    Para operações de nível account, execute o seguinte comando:

    • 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 o senhor 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 da Databricks a encontrar as informações corretas dos tokens OAuth correspondentes.

    Para operações de nível workspace, execute o seguinte comando:

    • databricks auth token -p <profile-name>

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

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

    Se o senhor tiver vários perfis com os mesmos valores --host, talvez seja necessário especificar as opções --host e -p juntas para ajudar a CLI da Databricks a encontrar as informações corretas dos tokens OAuth correspondentes.

Próximas etapas

Depois de configurar a CLI do Databricks: