Perfis de configuração para a CLI da Databricks

nota

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.

Obter 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, o senhor pode ter um perfil de configuração chamado DEV que faz referência a um Databricks workspace usado para cargas de trabalho de desenvolvimento e um perfil de configuração separado chamado PROD que faz referência a um Databricks workspace diferente usado 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:

Bash

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á o resultado de um perfil configurado com a autenticação de tokens de acesso pessoal Databricks:

JSON

{
  "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:

Bash

databricks auth profiles

Output

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 acesso tokens. Para exibir os tokens de acesso, execute o comando auth env anterior.

important

A CLI da Databricks não funciona com um arquivo .netrc. O senhor pode ter um arquivo .netrc em seu ambiente para outros fins, mas a CLI da 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.

nota

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.

Bash

databricks clusters spark-versions

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

Bash

databricks clusters spark-versions -p PROD