Perfis de configuração para a CLI do Databricks

Este artigo descreve como usar a CLI do Databricks com perfis de configuração. Ele pressupõe que você já tenha instalado a CLI do Databricks e criado um arquivo de perfis de configuração do Databricks. Consulte Instalar ou atualizar a CLI do Databricks e os perfis de configuração do Azure Databricks.

Obter informações sobre perfis de configuração

Adicionar vários perfis de configuração ao arquivo .databrickscfg permite executar comandos rapidamente em diversos espaços de trabalho, especificando o nome do perfil de configuração de destino na opção --profile ou -p do comando. Se não especificar um perfil, a CLI seleciona um pela seguinte ordem:

1. A variável de ambiente DATABRICKS_CONFIG_PROFILE, se definida.
2. A definição default_profile na secção [__settings__] de .databrickscfg, se estiver presente. Podes definir isto com databricks auth switch. Consulte databricks auth switch.
3. O perfil de DEFAULT.

Por exemplo, você pode ter um perfil de configuração nomeado 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 PROD de configuração separado chamado 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.

Por padrão, a CLI do Databricks procura o .databrickscfg arquivo em sua ~ pasta (sua página inicial do usuário) no Unix, Linux ou macOS, ou sua %USERPROFILE% pasta (sua página inicial do usuário) no Windows. Para alterar o caminho padrão do arquivo .databrickscfg, defina a variável de ambiente DATABRICKS_CONFIG_FILE para um caminho diferente. Consulte campos específicos de .databrickscfg.

Para obter informações sobre um perfil de configuração existente, execute o comando auth describe:

databricks auth describe --profile <configuration-profile-name>

Por exemplo, aqui está a saída para um perfil configurado com a autenticação de token de acesso pessoal do Azure Databricks:

Host: https://dbc-a1b2345c-d6e7.cloud.databricks.com
User: user@example.com
Authenticated with: pat
-----
Current configuration:
  ✓ host: https://dbc-a1b2345c-d6e7.cloud.databricks.com (from ~/.databrickscfg config file)
  ✓ token: ******** (from ~/.databrickscfg config file)
  ✓ profile: <configuration-profile-name> (from --profile flag)
  ✓ auth_type: pat

Para obter informações sobre todos os perfis disponíveis, execute o comando auth profiles:

databricks auth profiles

Name                     Host                                            Valid
DEFAULT                  https://dbc-a1b2345c-d6e7.cloud.databricks.com  YES
Development              https://dbc-a1b2345c-d6e7.cloud.databricks.com  YES
Staging                  https://dbc-a1b2345c-d6e7.cloud.databricks.com  YES
Production               https://dbc-a1b2345c-d6e7.cloud.databricks.com  YES

A saída do comando auth profiles não apresenta quaisquer tokens de acesso. Para exibir os detalhes do token para um perfil específico, execute databricks auth describe --profile <profile-name> ou databricks auth token --profile <profile-name>.

Testar seus perfis de configuração

Para testar seus perfis de configuração e verificar se você configurou a autenticação corretamente, execute um comando que se conecte a um espaço de trabalho.

Se você não especificar um perfil, o perfil padrão será usado. Por exemplo, o comando a seguir lista as versões disponíveis do Databricks Runtime para o espaço de trabalho do Azure Databricks associado ao seu perfil DEFAULT.

databricks clusters spark-versions

Para verificar um perfil de configuração específico, forneça o nome do perfil usando o sinalizador -p.

databricks clusters spark-versions -p PROD