Přidejte prostředek pro připojení ke katalogu Unity do aplikace Databricks

Přidejte připojení katalogu Unity jako prostředky Databricks Apps, abyste umožnili zabezpečený přístup k externím službám a zdrojům dat. Připojení katalogu Unity spravují přihlašovací údaje a podrobnosti ověřování, takže v kódu aplikace nemusíte pevně zakódovat přihlašovací údaje.

Přidat zdroj připojení ke katalogu Unity

Než přidáte připojení ke katalogu Unity jako prostředek, projděte si požadavky na prostředek aplikace.

  1. V části Prostředky aplikace při vytváření či úpravě aplikace klikněte na + Přidat prostředek>připojení UC.
  2. V seznamu dostupných připojení v pracovním prostoru zvolte připojení katalogu Unity.
  3. Vyberte úroveň oprávnění pro vaši aplikaci:
    • Použít připojení: Udělí aplikaci oprávnění k používání připojení pro přístup k externím službám. Odpovídá oprávnění USE CONNECTION
  4. (Volitelné) Zadejte vlastní klíč prostředku, což je způsob, jakým odkazujete na připojení v konfiguraci aplikace. Výchozí klíč je connection.

Když přidáte prostředek připojení ke katalogu Unity:

  • Azure Databricks udělí vaší aplikaci service principal oprávnění na vybrané připojení.
  • Aplikace má přístup k externím službám bez přímé správy přihlašovacích údajů.
  • Přihlašovací údaje pro připojení jsou bezpečně spravovány katalogem Unity a nejsou přístupné kódu vaší aplikace.

Proměnné prostředí

Když nasadíte aplikaci s prostředkem připojení ke katalogu Unity, Azure Databricks zveřejní název připojení prostřednictvím proměnných prostředí, na které můžete odkazovat pomocí pole valueFrom.

Příklad konfigurace:

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

Použití připojení v aplikaci:

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)

Další informace najdete v tématu Použití proměnných prostředí pro přístup k prostředkům.

Odstranit zdroj připojení ke katalogu Unity

Když z aplikace odeberete prostředek pro připojení ke katalogu Unity, služební účet aplikace ztratí přístup k tomuto připojení. Samotné připojení zůstává beze změny a bude nadále dostupné pro ostatní uživatele a aplikace, které mají příslušná oprávnění.

Osvědčené postupy

Při práci s prostředky připojení katalogu Unity zvažte následující skutečnosti:

  • Implementujte zpracování chyb a logiku opakování pro chyby připojení a problémy se sítí.
  • Monitorujte dobu odezvy rozhraní API a latenci připojení, zejména u požadavků napříč oblastmi nebo mezi cloudy.
  • Při provádění požadavků na externí služby zvažte náklady na výchozí přenos dat, zejména u velkých datových částí nebo volání rozhraní API s velkým objemem.
  • Pravidelně kontrolujte a obměňujte přihlašovací údaje pro připojení podle vašich zásad zabezpečení.
  • Ověřte odpovědi rozhraní API a implementujte odpovídající hodnoty časového limitu pro volání externích služeb.
  • Last updated on