Perfis de configuração para a CLI do Databricks

Observação

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.

Este artigo descreve como usar o site Databricks CLI com perfis de configuração. Ele pressupõe que o senhor já tenha instalado o Databricks CLI 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 Databricks.

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

A adição de vários perfis de configuraçã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 configuração de destino no sinalizador --profile ou -p do comando. Se não for especificado, o perfil de configuração DEFAULT será usado.

Dica

Você pode pressionar Tab depois de --profile ou -p para exibir uma lista dos perfis de configuração disponíveis existentes para escolher.

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

Em default, o Databricks CLI procura o arquivo .databrickscfg em seu ~ (sua pasta de usuário home no Unix, Linux ou macOS, ou em seu %USERPROFILE% (sua pasta de usuário home no Windows. Para alterar o caminho default do arquivo .databrickscfg, defina a variável de ambiente DATABRICKS_CONFIG_FILE para um caminho diferente. Consulte .databrickscfg-specific variável de ambiente e campos.

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

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

# Or:
databricks auth env --host <account-console-url>

# Or:
databricks auth env --host <workspace-url>

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

{
  "env": {
    "DATABRICKS_AUTH_TYPE": "pat",
    "DATABRICKS_CONFIG_PROFILE": "DEFAULT",
    "DATABRICKS_HOST": "https://dbc-a1b2345c-d6e7.cloud.databricks.com",
    "DATABRICKS_TOKEN": "dapi123..."
  }
}

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 exibe nenhum access token. Para exibir um access token, execute o comando auth env anterior.

Importante

A CLI do Databricks não funciona com um arquivo .netrc. Você pode ter um arquivo .netrc em seu ambiente para outras finalidades, mas a CLI do Databricks não usará esse arquivo .netrc .

Teste seus perfis de configuração

Para testar seus perfis de configuração e verificar se o senhor configurou a autenticação corretamente, execute um comando que se conecte a um workspace.

Se o senhor não especificar um perfil, será usado o perfil default. Por exemplo, o comando a seguir lista as versões disponíveis do Databricks Runtime para o Databricks workspace que está associado ao seu perfil DEFAULT.

Observação

Esse comando pressupõe que o senhor não tenha nenhuma variável de ambiente definida que tenha precedência sobre as configurações do seu perfil DEFAULT. Para obter mais informações, consulte Ordem de avaliação da autenticação.

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