Unity Catalog kapcsolati erőforrás hozzáadása Egy Databricks-alkalmazáshoz

Adjon hozzá Unity Catalog-kapcsolatokat Databricks Apps-erőforrásokként a külső szolgáltatásokhoz és adatforrásokhoz való biztonságos hozzáféréshez. A Unity Catalog-kapcsolatok kezelik a hitelesítő adatokat és a hitelesítési adatokat, így nem kell hitelesítő adatokat kódolnia az alkalmazáskódban.

Unity Catalog kapcsolati erőforrás hozzáadása

Mielőtt unitykatalógus-kapcsolatot ad hozzá erőforrásként, tekintse át az alkalmazás erőforrás-előfeltételeit.

1. Alkalmazás létrehozásakor vagy szerkesztésekor lépjen a Konfigurálás lépésre.
2. Az Alkalmazáserőforrások szakaszban kattintson az + Erőforrás hozzáadása elemre.
3. Erőforrástípusként válassza az UC-kapcsolatot .
4. Válasszon egy Unity Catalog-kapcsolatot a munkaterületen elérhető kapcsolatok listájából.
5. Válassza ki az alkalmazás jogosultsági szintjét:
   • Kapcsolat használata: Engedélyt ad az alkalmazásnak arra, hogy a kapcsolatot külső szolgáltatások eléréséhez használja. A USE CONNECTION jogosultságnak felel meg.
6. (Nem kötelező) Adjon meg egy egyéni erőforráskulcsot, így hivatkozhat a kapcsolatra az alkalmazáskonfigurációban. Az alapértelmezett kulcs a következő connection.

Unity Catalog kapcsolati erőforrás hozzáadásakor:

• Az Azure Databricks az alkalmazás szolgáltatásnévének jogosultságot USE CONNECTION biztosít a kiválasztott kapcsolaton.
• Az alkalmazás a hitelesítő adatok közvetlen kezelése nélkül is hozzáférhet a külső szolgáltatásokhoz.
• A csatlakozási hitelesítő adatokat a Unity Catalog biztonságosan kezeli, és nem teszi elérhetővé az alkalmazás kódját.

Környezeti változók

Egy Unity Catalog kapcsolati erőforrással rendelkező alkalmazás üzembe helyezésekor az Azure Databricks környezeti változókon keresztül teszi elérhetővé a kapcsolat nevét, amelyekre a valueFrom mező használatával hivatkozhat.

Példakonfiguráció:

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

A kapcsolat használata az alkalmazásban:

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)

További információ: Környezeti változók használata erőforrások eléréséhez.

Unity Catalog kapcsolati erőforrás eltávolítása

Amikor eltávolít egy Unity Catalog kapcsolati erőforrást egy alkalmazásból, az alkalmazás szolgáltatási identitása elveszíti a hozzáférést a kapcsolathoz. Maga a kapcsolat változatlan marad, és továbbra is elérhető lesz más, megfelelő engedélyekkel rendelkező felhasználók és alkalmazások számára.

Ajánlott eljárások

A Unity Catalog kapcsolati erőforrásainak használatakor vegye figyelembe a következőket:

• Hibakezelési és újrapróbálkozási logika implementálása kapcsolati hibák és hálózati problémák esetén.
• Monitorozza az API válaszideit és a kapcsolat késését, különösen régiók közötti vagy felhőközi kérések esetén.
• Vegye figyelembe az adatforgalom költségeit a külső szolgáltatásokra irányuló kérések során, különösen nagy adatmennyiség vagy nagy számú API-hívás esetén.
• Rendszeresen tekintse át és forgassa el a kapcsolat hitelesítő adatait a biztonsági szabályzatok szerint.
• API-válaszok ellenőrzése és a külső szolgáltatáshívások megfelelő időtúllépési értékeinek implementálása.