configure grupo de comando
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.
O grupo de comando configure dentro da Databricks CLI permite que o senhor autentique o Databricks CLI com Databricks usando Databricks acesso pessoal tokens.
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 o senhor usar a autenticação de tokens de acesso pessoal, a Databricks recomenda usar o acesso pessoal tokens pertencente à entidade de serviço em vez de usuários workspace. Para criar tokens o site para uma entidade de serviço, consulte gerenciar tokens para uma entidade de serviço.
Este artigo aborda apenas a autenticação de tokens Databricks para permitir a chamada do comando de nível workspace. Para obter opções adicionais de configuração de autenticação, consulte Autenticação para a CLI da Databricks.
Antes de executar este comando, certifique-se de configurar o site Databricks CLI .
O senhor executa configure comando anexando-os a databricks configure. Para exibir a ajuda do comando configure, execute databricks configure -h.
Criar um perfil de configuração
Um perfil de configuração é um conjunto de configurações que contém informações de autenticação, como um URL Databricks workspace e um valor de tokens de acesso. 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 forma:
databricks configure --host <workspace-url>
Para <workspace-url>, insira https:// seguido pelo nome da sua instância, por exemplo https://<prefix>.cloud.databricks.com. Para obter o nome de sua instância, consulte nomes de instâncias, URLs e IDs do espaço de trabalho.
O comando solicita que o senhor digite seus Databricks tokens de acesso pessoal que mapeiam para o <workspace-url> especificado:
✔ Databricks Token:
Depois que o senhor digita seus tokens de acesso, eles são armazenados no arquivo ~/.databrickscfg no Linux ou macOS, ou %USERPROFILE%\.databrickscfg em Windows por default. O arquivo contém uma entrada de perfil de conexão default denominada 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>
Você pode pressionar Tab após --profile ou -p para exibir a 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 tokens existentes no perfil de conexão especificado são substituídas pelas novas informações de host e tokens.
A adição de vários perfis de conexão ao arquivo .databrickscfg permite que o senhor execute rapidamente o comando em vários espaços de trabalho, especificando o nome do perfil de conexão de destino na opção --profile do comando. Se o senhor não especificar a opção --profile em um comando que suporte essa opção, o comando usará o perfil de conexão DEFAULT em default.
Por exemplo, o senhor pode ter um perfil de conexão chamado DEV que faz referência a um Databricks workspace usado para cargas de trabalho de desenvolvimento e um perfil de conexão separado chamado PROD que faz referência a um Databricks workspace diferente usado para cargas de trabalho de produção.
O senhor pode alterar o caminho default desse 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 comandoauth.