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:
Para Linux ou macOS, você tem o Homebrew instalado.
Observação
Se você não puder usar o Homebrew, para outras maneiras de instalar a CLI, consulte Instalar ou atualizar a CLI do Databricks.
Para Windows, você tem winget, Chocolatey ou Windows Subsystem for Linux (WSL) instalado. Para obter instruções de instalação, consulte a documentação do seu sistema operacional.
Observação
Instalar a CLI do Databricks com Chocolatey é experimental.
Se você não puder usar
winget
, Chocolatey ou WSL, para outras formas de instalar a CLI, consulte Instalar ou atualizar a CLI do Databricks.
Conclua os seguintes passos:
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:
Instale
curl
ezip
por meio do WSL. Para mais informações, consulte a documentação do seu sistema operacional.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
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 comocommand not found: databricks
, ou se executardatabricks -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.
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 em nível de conta, no comando a seguir, substitua os seguintes espaços reservados:
Substitua
<account-console-url>
pelo seu Databricks https://accounts.cloud.databricks.com.Substitua
<account-id>
pelo seu Databricks account ID. Consulte Localizar o ID de sua conta.
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>
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 comandodatabricks auth env --profile <profile-name>
.No navegador da Web, siga as instruções na tela para acessar o site log in para o seu Databricks account ou workspace.
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 account-level operações, 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 workspace-level operações, 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:
Para saber como usar a CLI, consulte Uso básico da CLI do Databricks.
Se a CLI não for executada ou produzir resultados inesperados, consulte Verifique a instalação da CLI.