Menambahkan sumber daya fungsi yang ditentukan pengguna (UDF) ke aplikasi Databricks

Tambahkan fungsi yang ditentukan pengguna (UDF) yang terdaftar di Unity Catalog sebagai sumber daya Databricks Apps untuk memungkinkan aplikasi Anda menjalankan fungsi SQL dan Python terdaftar. UDF menyediakan logika bisnis, transformasi data, dan operasi kustom yang dapat digunakan kembali yang dapat dibagikan di seluruh organisasi Anda dengan tata kelola terpusat.

Persyaratan hak istimewa

Untuk menjalankan UDF, perwakilan layanan aplikasi harus memiliki USE CATALOG hak istimewa pada katalog induk, USE SCHEMA hak istimewa pada skema induk, dan EXECUTE hak istimewa pada fungsi. Saat Anda menambahkan sumber daya UDF, Azure Databricks secara otomatis memberikan hak istimewa ini ke perwakilan layanan aplikasi.

Agar pemberian otomatis ini berhasil, salah satu hal berikut harus benar untuk setiap hak istimewa:

• Untuk USE CATALOG: Semua pengguna akun memiliki USE CATALOG hak istimewa pada katalog, atau Anda memiliki MANAGE hak istimewa pada katalog.
• Untuk USE SCHEMA: Semua pengguna akun memiliki USE SCHEMA hak istimewa pada skema, atau Anda memiliki MANAGE hak istimewa pada skema.
• Untuk EXECUTE: Semua pengguna akun memiliki EXECUTE hak istimewa pada fungsi , atau Anda memiliki MANAGE hak istimewa pada fungsi .

Lihat Hak istimewa Unity Catalog dan objek yang dapat diamankan.

Menambahkan sumber daya fungsi yang ditentukan pengguna (UDF)

Sebelum Anda menambahkan UDF 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 fungsi UC sebagai jenis sumber daya.
4. Pilih UDF dari fungsi yang tersedia di ruang kerja Anda. Fungsi harus sudah terdaftar di Katalog Unity.
5. Pilih tingkat izin untuk aplikasi Anda:
   • Dapat mengeksekusi: Memberikan izin aplikasi untuk menjalankan UDF dengan parameter yang disediakan. EXECUTE Sesuai dengan hak istimewa.
6. (Opsional) Tentukan kunci sumber daya kustom, yaitu cara Anda mereferensikan UDF dalam konfigurasi aplikasi Anda. Kunci defaultnya adalah function.

Variabel lingkungan

Saat Anda menyebarkan aplikasi dengan sumber daya UDF, Azure Databricks mengekspos seluruh nama tiga tingkat melalui variabel lingkungan yang dapat Anda referensikan menggunakan bidang valueFrom.

Konfigurasi contoh:

env:
  - name: UC_FUNCTION_NAME
    valueFrom: function # Use your custom resource key if different

Menggunakan fungsi di aplikasi Anda:

import os
from databricks.sdk import WorkspaceClient

# Access the function name
function_name = os.getenv("UC_FUNCTION_NAME")

# Initialize workspace client
w = WorkspaceClient()

# Execute the function via SQL
result = w.statement_execution.execute_statement(
    warehouse_id="your_warehouse_id",
    statement=f"SELECT {function_name}('parameter_value')"
)

# Process the result
print(f"Function result: {result}")

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

Menghapus sumber daya fungsi yang ditentukan pengguna (UDF)

Saat Anda menghapus sumber daya UDF dari aplikasi, perwakilan layanan aplikasi kehilangan akses ke fungsi. UDF 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 UDF:

• Pastikan UDF didokumenkan dengan baik dengan deskripsi parameter yang jelas dan jenis pengembalian.
• Tangani kesalahan UDF dengan anggun dalam kode aplikasi Anda, termasuk validasi parameter dan penanganan pengecualian.
• Uji perilaku UDF dalam konteks aplikasi sebelum penyebaran untuk memverifikasi hasil yang diharapkan.
• Pertimbangkan dependensi UDF pada tabel atau sumber data yang mendasar saat merencanakan izin aplikasi.