Perfis de configuração do Azure Databricks

  • Artigo

Um perfil de configuração do Azure Databricks (às vezes chamado de perfil de configuração, perfil de configuração ou simplesmente a profile) contém configuraçõ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 de configuração (.databrickscfg) do Azure Databricks para as ferramentas, SDKs, scripts e aplicativos a serem usados. Para saber se os perfis de configuração do Azure Databricks são compatíveis com as ferramentas, SDKs, scripts e aplicativos, consulte a documentação do provedor. Todas as ferramentas e SDKs participantes que implementam a autenticação unificada do cliente do Databricks dão suporte a perfis de configuração do Azure Databricks.

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

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

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

  2. No conteúdo anterior, substitua os valores a seguir e, em seguida, salve o arquivo:

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

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

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

Para criar perfis de configuração adicionais, especifique nomes de perfis diferentes no mesmo arquivo .databrickscfg. Por exemplo, para especificar workspaces do Azure Databricks separados, 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 diferentes nomes de perfil 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~...