Partilhar via

Perfis de configuração do Azure Databricks

  • Artigo

Um perfil de configuração do Azure Databricks (às vezes referido como um perfil de configuração, um perfil de configuraçãoou simplesmente um ) contém definições e outras informações que o Azure Databricks precisa para autenticar. Os perfis de configuração do Azure Databricks são armazenados em arquivos de perfis do Azure Databricks de configuração (.databrickscfg) para serem usados pelas suas ferramentas, SDKs, scripts e aplicativos. Para saber se os perfis de configuração do Azure Databricks são suportados pelas suas ferramentas, SDKs, scripts e aplicações, consulte a documentação do seu fornecedor. Todas as ferramentas e SDKs participantes que implementam a autenticação unificada do cliente Databricks dão suporte aos perfis de configuração do Azure Databricks.

Criar um arquivo de perfis de configuração do Azure Databricks

Para criar um arquivo de perfis de configuração do Azure Databricks, execute o comando databricks configure da CLI do Databricks ou siga estas etapas:

  1. Use seu editor de texto favorito para criar um arquivo chamado .databrickscfg em sua pasta ~ (sua página inicial do usuário) no Unix, Linux ou macOS, ou sua pasta %USERPROFILE% (sua página inicial do usuário) no Windows, se você ainda não tiver uma. Não se esqueça do ponto (.) no início do nome do ficheiro. Adicione o seguinte conteúdo a este ficheiro:

    [<some-unique-name-for-this-configuration-profile>]
<field-name> = <field-value>

  2. No conteúdo anterior, substitua os seguintes valores e salve o arquivo:

    • <some-unique-name-for-this-configuration-profile> com um nome exclusivo para o perfil de configuração, como DEFAULT, DEVELOPMENT, PRODUCTIONou similar. Você pode ter vários perfis de configuração no mesmo arquivo .databrickscfg, mas cada perfil de configuração deve ter um nome exclusivo dentro desse arquivo.
    • <field-name> e <field-value> com o nome e um valor para um dos campos obrigatórios para o tipo de autenticação Databricks de destino. Para obter as informações específicas a serem fornecidas, consulte a seção anterior neste artigo para esse tipo de autenticação.
    • Adicione um par de <field-name> e <field-value> para cada um dos campos adicionais obrigatórios para o tipo de autenticação Databricks de destino.

Por exemplo, para a autenticação de token de acesso pessoal do Azure Databricks, o arquivo de .databrickscfg pode ter esta aparência:

[DEFAULT]
host  = https://adb-1234567890123456.7.azuredatabricks.net
token = dapi123...

Para criar perfis de configuração adicionais, especifique nomes de perfil diferentes dentro do mesmo arquivo .databrickscfg. Por exemplo, para especificar espaços de trabalho separados do Azure Databricks, cada um com seu próprio token de acesso pessoal do Azure Databricks:

[DEFAULT]
host  = https://adb-1234567890123456.7.azuredatabricks.net
token = dapi123...

[DEVELOPMENT]
host  = https://adb-2345678901234567.8.azuredatabricks.net
token = dapi234...

Você também pode especificar nomes de perfil diferentes no arquivo .databrickscfg para contas do Azure Databricks e diferentes tipos de autenticação do Databricks, por exemplo:

[DEFAULT]
host  = https://adb-1234567890123456.7.azuredatabricks.net
token = dapi123...

[DEVELOPMENT]
azure_workspace_resource_id = /subscriptions/bc0cd1.../resourceGroups/my-resource-group/providers/Microsoft.Databricks/workspaces/my-workspace
azure_tenant_id             = bc0cd1...
azure_client_id             = fa0cd1...
azure_client_secret         = aBC1D~...

Dica

Você pode testar seus perfis de configuração usando a CLI do Databricks. Consulte Testar seus perfis de configuração.