Databricks CLI tutorial
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.
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.
- Para Windows, você precisa ter o winget, o Chocolatey ou o Subsistema do Windows para Linux (WSL) instalado. Para obter instruções de instalação, consulte a documentação do seu sistema operacional.
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:
-
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:
Bashbrew 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.
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:
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 o WSL para instalar a CLI do Databricks:
-
Instale
curl
ezip
através do WSL. Para obter mais informações, consulte a documentação do seu sistema operacional. -
Use o WSL para instalar a CLI do Databricks executando o seguinte comando:
Bashcurl -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:
databricks -v
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.
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.
-
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:
- Substitua
<account-console-url>
pelo seu Databricks https://accounts.cloud.databricks.com. - Substitua
<account-id>
pelo seu Databricks account ID. Consulte Localizar sua account ID.
Bashdatabricks 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, porhttps://dbc-a1b2345c-d6e7.cloud.databricks.com
exemplo,.Bashdatabricks auth login --host <workspace-url>
- Substitua
-
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 comandodatabricks auth env --profile <profile-name>
. -
No seu navegador da web, siga as instruções na tela para fazer log in em sua account ou workspace do Databricks.
-
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
- Para saber como usar a CLI, consulte Uso básico da CLI do Databricks.
- Para obter uma visão geral do comando CLI disponível, consulte Databricks CLI comando.
- Se o site CLI não for executado ou produzir resultados inesperados, consulte Verificar a instalação do site CLI.