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 autenticar com ferramentas, sistemas, scripts e aplicativos automatizados, a Databricks recomenda que você use access token pessoal pertencente à entidade de serviço em vez de usuários do espaço de trabalho. 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>.<random-number>.gcp.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.