configure grupo de comando

Nota

Essas informações se aplicam às versões 0.205 e superiores da CLI do Databricks. A CLI do Databricks está em Visualização Pública.

O uso da CLI do Databricks está sujeito à Licença do Databricks e ao Aviso de Privacidade do Databricks, incluindo quaisquer disposições de Dados de Uso.

O configure grupo de comandos dentro da CLI do Databricks permite que você autentique a CLI do Databricks com o Azure Databricks usando tokens de acesso pessoal do Azure Databricks ou tokens do Microsoft Entra ID (anteriormente Azure Ative Directory).

Nota

Como prática recomendada de segurança, quando você se autentica com ferramentas, sistemas, scripts e aplicativos automatizados, o Databricks recomenda que você use tokens de acesso pessoal pertencentes a entidades 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.

Observe que este artigo abrange apenas o token de acesso pessoal do Azure Databricks e a autenticação de token do Microsoft Entra ID para habilitar a chamada de comandos no nível do espaço de trabalho. Para obter opções de configuração de autenticação adicionais, consulte Autenticação para a CLI do Databricks.

Importante

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

Execute configure comandos anexando-os ao databricks configure. Para exibir a ajuda para o configure comando, execute 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 do espaço de trabalho do Azure Databricks e um valor de token de acesso. Um perfil de configuração tem um nome programático, como DEFAULT, DEVou PROD.

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

databricks configure --host <workspace-url>

Para <workspace-url>, insira o URL por espaço de trabalho, com o formato https://adb-<workspace-id>.<random-number>.azuredatabricks.net. Para obter a URL por espaço de trabalho, consulte URL por espaço de trabalho.

O comando solicita que você insira seu token de acesso pessoal do Azure Databricks ou token Microsoft Entra ID (anteriormente Azure Ative Directory) que mapeia para o especificado <workspace-url>:

✔ Databricks Token:

Depois de inserir seu token de acesso, ele é armazenado no arquivo ~/.databrickscfg no Linux ou macOS, ou %USERPROFILE%\.databrickscfg no Windows por padrão. O arquivo contém uma entrada de perfil de conexão padrão 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 --profile opção ao configure comando, por exemplo:

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

Gorjeta

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

Todas as informações de host e token existentes dentro do perfil de conexão especificado são substituídas pelas novas informações de host e token.

Adicionar vários perfis de conexão ao .databrickscfg arquivo permite executar comandos rapidamente em vários espaços de trabalho, especificando o nome do perfil de conexão de destino na opção do --profile comando. Se você não especificar a --profile opção em um comando que ofereça suporte a essa opção, o comando usará o perfil de DEFAULT conexão por padrão.

Por exemplo, você pode ter um perfil de conexão chamado DEV que faça referência a um espaço de trabalho do Azure Databricks que você usa para cargas de trabalho de desenvolvimento e um perfil de conexão separado chamado PROD perfil de conexão que faça referência a um espaço de trabalho diferente do Azure Databricks que você usa para cargas de trabalho de produção.

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

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