Apa itu fungsi data pengguna Fabric?

Fungsi data pengguna memungkinkan Anda membuat fungsi Python yang dapat digunakan kembali dan dapat Anda panggil dari berbagai Fabric dan aplikasi eksternal. Tulis logika bisnis Anda sekali dan panggilnya dari pipeline, notebook, aturan aktivator, alur tugas translytik Power BI, atau sistem eksternal apa pun melalui endpoint REST.

Fungsi data pengguna menyediakan lingkungan komputasi tanpa server tempat Anda dapat menghosting dan menjalankan kode Python kustom langsung di Fabric. Baik Anda perlu menstandarkan kategori produk, menerapkan aturan bisnis yang kompleks, atau berintegrasi dengan API eksternal, Anda dapat menulis fungsi yang segera tersedia di seluruh platform data Anda. Layanan ini mendukung runtime Python 3.11.9, pustaka publik dari PyPI, dan koneksi data Fabric.

GIF animasi yang menampilkan antarmuka fungsi data pengguna Fabric.

Siap untuk memulai? Ikuti panduan ini untuk membuat item fungsi data pengguna baru atau menggunakan ekstensi VS Code.

Mengapa menggunakan fungsi data pengguna Fabric?

Fungsi data pengguna Fabric menyediakan platform tanpa server untuk meng-host logika kustom Anda dan memanggilnya dari berbagai jenis item Fabric dan sumber data. Gunakan layanan ini untuk menulis logika bisnis, algoritma internal, dan fungsi yang dapat digunakan ulang yang terintegrasi ke dalam solusi Fabric Anda.

Berikut ini adalah manfaat utama:

  • Kemampuan penggunaan ulang: Tulis logika bisnis Anda sekali sebagai fungsi data pengguna dan jalankan dari beberapa item Fabric - pipeline, notebook, aturan aktivator, dan alur tugas translytical Power BI. Saat aturan bisnis berubah, perbarui fungsi sekali daripada memodifikasi kode di beberapa tempat.
  • Hosting tanpa server: Menyebarkan fungsi Python tanpa mengelola infrastruktur. Fungsi data pengguna menyediakan lingkungan komputasi tanpa server dengan autentikasi bawaan, sehingga Anda tidak perlu mengatur dan memelihara layanan API atau kontainer terpisah.
  • Konektivitas eksternal: Setiap fungsi secara otomatis mengekspos titik akhir REST uniknya sendiri, memungkinkan integrasi dengan aplikasi eksternal, layanan web, dan klien kustom. Panggil fungsi Anda dari sistem apa pun yang mendukung permintaan HTTP.

Kemampuan utama

  • Tulis sekali, jalankan di mana saja: Buat fungsi yang bekerja identik baik yang dipanggil dari pipeline, notebook, aturan aktivator, Power BI, atau panggilan REST eksternal
  • Ekosistem Python yang kaya: Gunakan paket apa pun dari PyPI untuk membangun logika canggih—panda untuk manipulasi data, permintaan panggilan API, atau pustaka khusus untuk domain Anda
  • Akses data aman: Terhubung ke sumber data Fabric (database SQL, gudang, lakehouse, database mirrored) dengan autentikasi dan keamanan bawaan
  • Mengembangkan dan menerbitkan alur kerja: Menguji fungsi sebelum menerbitkannya, memastikan perubahan divalidasi sebelum tersedia untuk pemanggilan

Kemampuan integrasi

Fungsi data pengguna terintegrasi secara mulus dengan beban kerja Fabric dan sistem eksternal, memungkinkan Anda membangun solusi data yang komprehensif.

Panggil dari item Fabric

Panggil fungsi Anda dari beban kerja Fabric apa pun untuk mempusatkan logika bisnis dan mempertahankan konsistensi:

  • Data pipeline - Menjalankan fungsi sebagai aktivitas pipeline untuk transformasi data, validasi, atau logika orkestrasi
  • Notebooks - Memanggil fungsi dari notebook PySpark atau Python untuk alur kerja ilmu data dan analisis eksploratif
  • Aturan aktivator - Memicu fungsi sebagai respons terhadap peristiwa real time dan data streaming
  • Alur Tugas Transanalitik Power BI - Memanggil fungsi secara langsung dari laporan Power BI untuk pengalaman data interaktif. Fungsi data pengguna dapat menerima konteks laporan - seperti filter saat ini dan konteks seleksi - dalam payload permintaan, memungkinkan eksekusi aksi dan skenario write-back dari dalam laporan. Setelah proses write-back selesai, visibilitas data dalam laporan bergantung pada mode penyimpanan dan semantik penyegaran laporan: nilai yang diperbarui akan segera terlihat untuk laporan Direct Lake atau DirectQuery, atau setelah penyegaran otomatis yang dipicu oleh aliran tugas untuk laporan dalam mode impor.

Menyambungkan ke sumber data Fabric

Fungsi Anda dapat mengakses data dengan aman dari seluruh platform Fabric:

  • Database SQL - Operasi baca dan tulis pada database SQL di Fabric
  • Gudang - Operasi baca dan tulis untuk data terstruktur
  • Lakehouses - Membaca dan menulis file Lakehouse; akses baca-saja ke titik akhir analitik SQL
  • Database cermin - Akses baca-saja ke data database yang dicerminkan
  • Perpustakaan variabel - Akses pengaturan konfigurasi terpusat sebagai variabel dalam fungsi Anda.
  • Cosmos DB di Fabric - Terhubung ke Cosmos DB di kontainer Fabric untuk operasi data NoSQL.
  • Peristiwa bisnis - Mendeteksi perubahan dalam data operasional dan mempublikasikan peristiwa bisnis untuk aplikasi hilir.

Selain koneksi terkelola, fungsi data pengguna mendukung koneksi generik yang dapat Anda gunakan untuk menghubungkan ke item Fabric atau sumber daya Azure dengan menggunakan identitas pemilik item. Koneksi generik menghasilkan token Microsoft Entra ID dengan identitas pemilik untuk tipe audiens tertentu, memberikan cara fleksibel untuk autentikasi dengan layanan seperti Azure Cosmos DB atau Azure Key Vault tanpa mengonfigurasi koneksi yang dikelola secara individual. Untuk informasi lebih lanjut, lihat Koneksi generik untuk item Fabric atau sumber daya Azure.

Write-back dari alur tugas translytik Power BI didukung secara native saat memanggil fungsi data pengguna. Fungsi data pengguna dapat melakukan operasi penambahan, pembaruan, dan penghapusan terhadap database SQL di Fabric, gudang, dan file lakehouse, menjadikannya titik integrasi ideal untuk skenario write-back berbasis alur tugas.

Pelajari selengkapnya tentang menyambungkan ke sumber data Fabric.

Panggilan dari aplikasi eksternal

Setiap fungsi data pengguna secara otomatis mengekspos endpoint REST uniknya sendiri untuk integrasi dengan sistem di luar Fabric:

  • Aplikasi web - Memanggil fungsi dari aplikasi web, aplikasi seluler, atau aplikasi satu halaman
  • layanan External - Berintegrasi dengan sistem eksternal, layanan mikro, atau aplikasi warisan—misalnya, memposting pesan atau pembaruan ke Microsoft Teams, atau memanggil REST API eksternal sebagai bagian dari tindakan berbasis aliran tugas
  • Alur kerja API - Fungsi rantai dengan API lain untuk membangun skenario integrasi yang kompleks
  • Klien kustom - Panggilan dari bahasa atau platform pemrograman apa pun yang mendukung permintaan HTTP

Endpoint REST untuk fungsi data pengguna mendukung autentikasi Microsoft Entra ID, memastikan akses yang aman dari sistem eksternal. Pelajari cara memanggil fungsi data pengguna dari aplikasi Python.

Get started

Siap membuat fungsi data pengguna pertama Anda? Pilih lingkungan pengembangan pilihan Anda:

Konten terkait

  • Last updated on