Menambahkan sumber daya koneksi Unity Catalog ke aplikasi Databricks

Tambahkan koneksi Unity Catalog sebagai sumber daya Aplikasi Databricks untuk mengaktifkan akses aman ke layanan eksternal dan sumber data. Koneksi Katalog Unity mengelola kredensial dan detail autentikasi, sehingga Anda tidak perlu mengodekan kredensial secara permanen dalam kode aplikasi Anda.

Menambahkan sumber daya koneksi Katalog Unity

Sebelum Anda menambahkan koneksi Katalog Unity sebagai sumber daya, tinjau prasyarat sumber daya aplikasi.

1. Saat Anda membuat atau mengedit aplikasi, navigasikan ke langkah Konfigurasikan .
2. Di bagian Sumber daya aplikasi , klik + Tambahkan sumber daya.
3. Pilih koneksi UC sebagai jenis sumber daya.
4. Pilih koneksi Katalog Unity dari daftar koneksi yang tersedia di ruang kerja Anda.
5. Pilih tingkat izin untuk aplikasi Anda:
   • Gunakan Koneksi: Memberikan izin aplikasi untuk menggunakan koneksi untuk mengakses layanan eksternal. USE CONNECTION Sesuai dengan hak istimewa.
6. (Opsional) Tentukan kunci sumber daya kustom, yaitu cara Anda mereferensikan koneksi dalam konfigurasi aplikasi Anda. Kunci defaultnya adalah connection.

Saat Anda menambahkan sumber daya koneksi Katalog Unity:

• Azure Databricks memberikan hak istimewa kepada perwakilanUSE CONNECTION layanan aplikasi Anda pada koneksi yang dipilih.
• Aplikasi ini dapat mengakses layanan eksternal tanpa mengelola kredensial secara langsung.
• Kredensial koneksi dikelola dengan aman oleh Katalog Unity dan tidak terekspos ke kode aplikasi Anda.

Variabel lingkungan

Saat Anda menyebarkan aplikasi dengan sumber daya koneksi Unity Catalog, Azure Databricks mengekspos nama koneksi melalui variabel lingkungan yang dapat Anda referensikan menggunakan bidang .valueFrom

Konfigurasi contoh:

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

Menggunakan koneksi di aplikasi Anda:

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)

Untuk informasi selengkapnya, lihat Menggunakan variabel lingkungan untuk mengakses sumber daya.

Menghapus sumber daya koneksi Katalog Unity

Saat Anda menghapus sumber daya koneksi Katalog Unity dari aplikasi, perwakilan layanan aplikasi kehilangan akses ke koneksi. Koneksi itu sendiri tetap tidak berubah dan terus tersedia untuk pengguna dan aplikasi lain yang memiliki izin yang sesuai.

Praktik terbaik

Pertimbangkan hal berikut saat Anda bekerja dengan sumber daya koneksi Katalog Unity:

• Terapkan penanganan kesalahan dan logika coba lagi untuk kegagalan koneksi dan masalah jaringan.
• Pantau waktu respons API dan latensi koneksi, terutama untuk permintaan lintas wilayah atau lintas cloud.
• Pertimbangkan biaya keluar data saat membuat permintaan ke layanan eksternal, terutama untuk payload besar atau panggilan API volume tinggi.
• Tinjau dan putar kredensial koneksi secara teratur sesuai dengan kebijakan keamanan Anda.
• Validasi respons API dan terapkan nilai batas waktu yang sesuai untuk panggilan layanan eksternal.