Een Unity Catalog-verbindingsresource toevoegen aan een Databricks-app

Voeg Unity Catalog-verbindingen toe als Databricks Apps-resources om beveiligde toegang tot externe services en gegevensbronnen mogelijk te maken. Unity Catalog-verbindingen beheren referenties en verificatiegegevens, zodat u referenties niet hoeft te coderen in uw toepassingscode.

Een Unity Catalog-verbindingsresource toevoegen

Voordat u een Unity Catalog-verbinding als een resource toevoegt, controleert u de vereisten voor de app-resource.

1. Wanneer u een app maakt of bewerkt, gaat u naar de stap Configureren .
2. Klik in de sectie App-resources op + Resource toevoegen.
3. Selecteer UC-verbinding als het resourcetype.
4. Kies een Unity Catalog-verbinding in de lijst met beschikbare verbindingen in uw werkruimte.
5. Selecteer het machtigingsniveau voor uw app:
   • Verbinding gebruiken: Verleent de app toestemming om de verbinding te gebruiken voor toegang tot externe services. Komt overeen met de USE CONNECTION bevoegdheid.
6. (Optioneel) Geef een aangepaste resourcesleutel op. Dit is de wijze waarop u verwijst naar de verbinding in uw app-configuratie. De standaardsleutel is connection.

Wanneer u een Unity Catalog-verbindingsresource toevoegt:

• Azure Databricks verleent de service-principal van uw app de USE CONNECTION bevoegdheid voor de geselecteerde verbinding.
• De app heeft rechtstreeks toegang tot externe services zonder referenties te beheren.
• Verbindingsreferenties worden veilig beheerd door Unity Catalog en worden niet blootgesteld aan uw toepassingscode.

Omgevingsvariabelen

Wanneer u een app met een Unity Catalog-verbindingsresource implementeert, maakt Azure Databricks de verbindingsnaam beschikbaar via omgevingsvariabelen waarnaar u kunt verwijzen met behulp van het valueFrom veld.

Voorbeeldconfiguratie:

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

De verbinding in uw toepassing gebruiken:

import os
from databricks.sdk import WorkspaceClient
from databricks.sdk.service.serving import ExternalFunctionRequestHttpMethod

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

# Initialize workspace client
w = WorkspaceClient()

# Make HTTP request through the connection
response = w.serving_endpoints.http_request(
    conn=connection_name,
    method=ExternalFunctionRequestHttpMethod.POST,
    path="/api/v1/resource",
    json={"key": "value"},
    headers={"extra_header_key": "extra_header_value"},
)

# Process the response
print(response)

Zie Omgevingsvariabelen gebruiken voor toegang tot resources voor meer informatie.

Een Unity Catalog-verbindingsresource verwijderen

Wanneer u een Unity Catalog-verbindingsresource verwijdert uit een app, verliest de service-principal van de app de toegang tot de verbinding. De verbinding zelf blijft ongewijzigd en blijft beschikbaar voor andere gebruikers en toepassingen met de juiste machtigingen.

Beste praktijken

Houd rekening met het volgende wanneer u werkt met verbindingsbronnen van Unity Catalog:

• Implementeer foutafhandeling en logica voor opnieuw proberen voor verbindingsfouten en netwerkproblemen.
• Bewaak api-reactietijden en verbindingslatentie, met name voor aanvragen tussen regio's of clouds.
• Overweeg kosten voor uitgaande dataverkeer bij het indienen van verzoeken naar externe services, met name voor grote hoeveelheden gegevens of API-aanroepen met een hoog volume.
• Controleer en roteer regelmatig de verbindingsreferenties volgens uw beveiligingsbeleid.
• Valideer API-antwoorden en implementeer de juiste time-outwaarden voor externe service-aanroepen.