Perfis de configuração para a CLI do Databricks

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.

Este artigo descreve como configurar a autenticação entre a CLI do Databricks e suas contas e espaços de trabalho do Azure Databricks. Consulte O que é a CLI do Databricks?.

Este artigo pressupõe que você já tenha instalado a CLI do Databricks e configurado a CLI para autenticação. Veja:

• Instalar ou atualizar a CLI do Databricks
• Autenticação para a CLI do Databricks

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

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

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.

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. Você pode alterar o caminho padrão do arquivo definindo a variável DATABRICKS_CONFIG_FILEde .databrickscfg ambiente . Para saber como definir variáveis de ambiente, consulte a documentação do seu sistema operacional.

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

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 a autenticação de token de acesso pessoal do Azure Databricks:

{
  "env": {
    "DATABRICKS_AUTH_TYPE": "pat",
    "DATABRICKS_CONFIG_PROFILE": "<configuration-profile-name>",
    "DATABRICKS_HOST": "<workspace-url>",
    "DATABRICKS_TOKEN": "<token-value>"
  }
}

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

databricks auth profiles

Saída (as reticências representam conteúdo omitido, para brevidade):

{
  "profiles": [
    {
      "name": "<configuration-profile-name>",
      "host": "<workspace-url>",
      "cloud": "<cloud-id>",
      "auth_type": "<auth-type>",
      "valid": true
    },
    {
      "...": "..."
    }
  ]
}

A saída do comando não exibe nenhum token de auth profiles acesso. Para exibir um token de acesso, execute o comando anterior auth env .

Importante

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

Teste a configuração do seu perfil de configuração PADRÃO

Para verificar se você configurou a autenticação corretamente, você pode executar um comando como o seguinte, que lista as versões disponíveis do Databricks Runtime para o espaço de trabalho do Azure Databricks associado ao seu DEFAULT perfil.

A chamada a seguir pressupõe que você não tenha nenhuma variável de ambiente especial definida, que tenha precedência sobre as configurações em seu DEFAULT perfil. Para obter mais informações, consulte Ordem de autenticação da avaliação.

databricks clusters spark-versions

Testar seus perfis de configuração

Para verificar se você configurou algum perfil de configuração corretamente, você pode executar um comando como o seguinte com um dos nomes de perfil de configuração no nível do espaço de trabalho. Este comando lista as versões disponíveis do Databricks Runtime para o espaço de trabalho do Azure Databricks associado ao perfil de configuração especificado, representado aqui pelo espaço reservado <configuration-profile-name>:

databricks clusters spark-versions -p <configuration-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.

Para listar detalhes de um perfil específico, execute o seguinte comando:

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

Para listar detalhes de todos os seus perfis disponíveis, execute o seguinte comando:

databricks auth profiles