configure grupo de comando

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.

O grupo de comandos configure na CLI do Databricks permite autenticar a CLI do Databricks com o Databricks usando access tokenpessoal do Databricks.

Observação

Como prática recomendada de segurança ao se autenticar com ferramentas, sistemas, scripts e aplicativos automatizados, a Databricks recomenda que você use tokens OAuth.

Se utilizar a autenticação access token pessoal, a Databricks recomenda a utilização access token pessoal pertencente à entidade de serviço em vez de utilizadores workspace . Para criar tokens para entidades de serviço, consulte gerenciar tokens para uma entidade de serviço.

Observação

Este artigo cobre apenas a autenticação tokens do Databricks para habilitar a chamada do comando no nível workspace . Para opções adicionais de configuração de autenticação, consulte Autenticação para a CLI do Databricks.

Importante

Antes de executar este comando, certifique-se de configurar a CLI do Databricks.

Você executa configure comandos anexando-os a databricks configure. Para exibir ajuda para o comando configure , execução databricks configure -h.

Criar um perfil de configuração

Um perfil de configuração é uma coleção de configurações que contém informações de autenticação, como uma URL workspace Databricks e um valor access tokens . Um perfil de configuração tem um nome programático, como DEFAULT, DEV ou PROD.

Para criar um perfil de configuração, execute o comando configure da seguinte maneira:

databricks configure --host <workspace-url>

Para <workspace-url>, digite https:// seguido pelo nome da sua instância, por exemplo https://<prefix>.cloud.databricks.com. Para obter o nome da sua instância, consulte Nomes, URLs e IDs de instâncias do Workspace.

O comando solicita que você insira seu access tokenpessoal do Databricks que mapeia para o <workspace-url> especificado:

✔ Databricks Token:

Depois de inserir seus access tokens, seus access tokens são armazenados no arquivo ~/.databrickscfg no Linux ou macOS ou %USERPROFILE%\.databrickscfg no Windows por default. O arquivo contém uma entrada de perfil de conexão default chamada DEFAULT:

[DEFAULT]
host  = <workspace-url>
token = <access-token>

Para usar um nome diferente para seu perfil de conexão em vez de DEFAULT, adicione a opção --profile ao comando configure , por exemplo:

databricks configure --host <workspace-url> --profile <profile-name>

Dica

Você pode pressionar Tab após --profile ou -p para exibir uma lista de perfis de configuração existentes disponíveis para escolha, em vez de inserir o nome do perfil de configuração manualmente.

Quaisquer informações de host e tokens existentes no perfil de conexão especificado são substituídas pelas novas informações de host e tokens .

Adicionar vários perfis de conexão ao arquivo .databrickscfg permite que você execute comandos rapidamente em vários workspace especificando o nome do perfil de conexão de destino na opção --profile do comando. Se você não especificar a opção --profile em um comando que suporte esta opção, o comando usará o perfil de conexão DEFAULT por default.

Por exemplo, você pode ter um perfil de conexão chamado DEV que faz referência a um workspace Databricks usado para cargas de trabalho de desenvolvimento e um perfil de conexão separado chamado perfil de conexão PROD que faz referência a um workspace Databricks diferente usado para cargas de trabalho de produção.

Você pode alterar o caminho default deste arquivo .databrickscfg definindo a variável de ambiente DATABRICKS_CONFIG_FILE. Para saber como definir a variável de ambiente, consulte a documentação do seu sistema operacional.

Para obter informações sobre os perfis de configuração existentes, use o grupo de comandos auth.