Adicionar um recurso de conexão do Unity Catalog a um aplicativo Databricks

Adicione conexõesUnity Catalog como recurso Databricks Apps para permitir acesso seguro a serviços externos e fontes de dados. As conexões Unity Catalog gerenciam credenciais e detalhes de autenticação, para que você não precise codificar as credenciais diretamente no código do seu aplicativo.

Adicionar recurso de conexão ao Unity Catalog

Antes de adicionar uma conexão do Unity Catalog como um recurso, revise os pré-requisitos do recurso do aplicativo.

1. Na seção Recurso do aplicativo , ao criar ou editar um aplicativo, clique em + Adicionar recurso > Conexão UC .

2. Escolha uma conexão Unity Catalog na lista de conexões disponíveis em seu workspace.

3. Selecione o nível de permissão para seu aplicativo:

   • Usar conexão: Concede permissão ao aplicativo para usar a conexão para acessar serviços externos. Corresponde ao privilégio USE CONNECTION .

4. (Opcional) Especifique uma key de recurso personalizada, que é como você referencia a conexão na configuração do seu aplicativo. A key default é connection.

Ao adicionar um recurso de conexão Unity Catalog :

• Databricks concede à entidade de serviço do seu aplicativo o privilégio USE CONNECTION na conexão selecionada.
• O aplicativo pode acessar serviços externos sem precisar gerenciar credenciais diretamente.
• As credenciais de conexão são gerenciadas com segurança pelo Unity Catalog e não são expostas ao código do seu aplicativo.

variável de ambiente

Quando você implanta um aplicativo com um recurso de conexão Unity Catalog , Databricks expõe o nome da conexão por meio de uma variável de ambiente que você pode referenciar usando o campo valueFrom .

Configuração de exemplo:

YAML

env:
  - name: UC_CONNECTION_NAME
    valueFrom: connection # Use your custom resource key if different

Utilizando a conexão em seu aplicativo:

Python

import os
import requests
from databricks.sdk import WorkspaceClient

# Access the connection name
connection_name = os.getenv("UC_CONNECTION_NAME")

# Initialize workspace client
w = WorkspaceClient()

# Make HTTP request through the connection
response = requests.post(
    f"{w.config.host}/api/2.0/unity-catalog/connections/{connection_name}/proxy/api/v1/resource",
    headers={
        **w.config.authenticate(),
        "Content-Type": "application/json",
        "extra_header_key": "extra_header_value",
    },
    json={"key": "value"},
)

# Process the response
print(response.text)

Para mais informações, veja Usar variável de ambiente para acessar recurso.

Remover um recurso de conexão Unity Catalog

Ao remover um recurso de conexão do Unity Catalog de um aplicativo, a entidade de serviço do aplicativo perde o acesso à conexão. A conexão em si permanece inalterada e continua disponível para outros usuários e aplicativos que possuam as permissões adequadas.

Melhores práticas

Considere o seguinte ao trabalhar com recursos de conexão Unity Catalog :

• Implemente lógica de tratamento de erros e de repetição para falhas de conexão e problemas de rede.
• Monitore os tempos de resposta API e a latência de conexão, especialmente para solicitações entre regiões oucloud diferentes.
• Considere os custos de saída de dados ao fazer solicitações para serviços externos, especialmente para grandes volumes de dados ou chamadas API de alto volume.
• Revise e alterne regularmente as credenciais de conexão de acordo com suas políticas de segurança.
• Validar as respostas API e implementar valores de tempo limite adequados para chamadas de serviços externos.