Aktivitas Fungsi Azure di Azure Data Factory
BERLAKU UNTUK:
Azure Data Factory Azure Synapse Analytics
Tip
Cobalah Data Factory di Microsoft Fabric, solusi analitik all-in-one untuk perusahaan. Microsoft Fabric mencakup semuanya mulai dari pergerakan data hingga ilmu data, analitik real time, kecerdasan bisnis, dan pelaporan. Pelajari cara memulai uji coba baru secara gratis!
Aktivitas Azure Function memungkinkan Anda menjalankan Azure Functions di alur Azure Data Factory atau Synapse. Untuk menjalankan Fungsi Azure, Anda harus membuat koneksi layanan tertaut. Kemudian Anda dapat menggunakan layanan tertaut dengan aktivitas yang menentukan Fungsi Azure yang Anda rencanakan untuk dijalankan.
Membuat aktivitas Fungsi Azure dengan UI
Untuk menggunakan aktivitas Fungsi Azure dalam alur, selesaikan langkah-langkah berikut:
Perluas bagian Fungsi Azure dari panel Aktivitas alur, dan seret aktivitas Fungsi Azure ke kanvas alur.
Pilih aktivitas Fungsi Azure baru di kanvas jika belum dipilih, dan tab Pengaturan, untuk mengedit detailnya.
Jika Anda belum memiliki layanan tertaut Fungsi Azure yang ditentukan, pilih Baru untuk membuat yang baru. Di panel layanan tertaut Fungsi Azure yang baru, pilih url Aplikasi Fungsi Azure Anda yang ada dan berikan Kunci Fungsi.
Setelah memilih layanan tertaut Fungsi Azure, berikan nama fungsi dan detail lainnya untuk menyelesaikan konfigurasi.
Layanan tertaut Azure Function
Jenis pengembalian fungsi Azure harus validJObject. (Perlu diingat bahwa JArraybukanJObject.) Jenis pengembalian selain JObject gagal dan menaikkan Konten Respons kesalahan pengguna bukan JObject yang valid.
Function Key menyediakan akses aman ke nama fungsi dengan masing-masing memiliki kunci unik yang terpisah atau kunci master dalam aplikasi fungsi. Identitas terkelola menyediakan akses aman ke seluruh aplikasi fungsi. Pengguna perlu menyediakan kunci untuk mengakses nama fungsi. Untuk informasi selengkapnya, lihat dokumentasi fungsi untuk detail selengkapnya tentang kunci akses fungsi
| Properti | Keterangan | Diperlukan |
|---|---|---|
| Tipe | Properti jenis harus diatur ke: AzureFunction | Ya |
| Url aplikasi fungsi | URL untuk Aplikasi Azure Function. Format adalah https://<accountname>.azurewebsites.net. URL ini adalah nilai di bawah bagian URL saat menampilkan Aplikasi Fungsi Anda di portal Microsoft Azure |
Ya |
| Tombol fungsi | Kunci akses untuk Azure Function. Klik pada bagian Kelola untuk fungsi masing-masing, dan salin Kunci Fungsi atau Kunci Host. Untuk mempelajari selengkapnya, lihat Pemicu dan pengikatan HTTP Azure Functions | Ya |
| Autentikasi | Metode autentikasi yang digunakan untuk memanggil Fungsi Azure. Nilai yang didukung adalah 'Identitas terkelola yang ditetapkan sistem' atau 'anonim'. | Ya |
| ID Sumber Daya | ID Aplikasi (klien) dari Azure Function. Beralih ke bagian Autentikasi untuk fungsi masing-masing, dan dapatkan ID Aplikasi (klien) di bawah Penyedia identitas. Properti ini akan ditampilkan ketika Anda menggunakan identitas terkelola yang ditetapkan sistem. Untuk informasi selengkapnya, lihat Mengonfigurasi App Service atau aplikasi Azure Functions Anda untuk menggunakan login Microsoft Entra. | Tidak |
Catatan
Saat Anda menggunakan autentikasi anonim, pastikan Anda telah menghapus identitas Anda di sisi Azure Function.
Aktivitas Fungsi Azure
| Properti | Keterangan | Nilai yang diizinkan | Diperlukan |
|---|---|---|---|
| Nama | Nama aktivitas di dalam alur | String | Ya |
| Jenis | Jenis aktivitas adalah 'AzureFunctionActivity' | String | Ya |
| Layanan tertaut | Layanan tertaut Fungsi Azure untuk Aplikasi Fungsi Azure terkait | Referensi layanan tertaut | Ya |
| Nama fungsi | Nama fungsi di Aplikasi Fungsi Azure yang disebut aktivitas ini | String | Ya |
| Metode | Metode REST API untuk panggilan fungsi | Jenis yang Didukung String: "GET", "POST", "PUT" | Ya |
| Header | Headers yang dikirim ke permintaan. Misalnya, untuk mengatur bahasa dan mengetikkan permintaan: "headers": { "Accept-Language": "en-us", "Content-Type": "application/json" } | String (atau ekspresi dengan resultType string) | Tidak |
| Isi | isi yang dikirim bersama dengan permintaan ke metode api fungsi | String (atau ekspresi dengan resultType string) atau objek. | Diperlukan untuk metode PUT/POST |
Lihat skema permintaan payload di bagian Permintaan skema muatan.
Perutean dan kueri
Aktivitas Fungsi Azure mendukung perutean. Misalnya, jika Fungsi Azure Anda memiliki titik akhir https://functionAPP.azurewebsites.net/api/<functionName>/<value>?code=<secret>, maka yang akan functionName digunakan dalam Aktivitas Fungsi Azure adalah <functionName>/<value>. Anda dapat membuat parameter fungsi ini untuk menyediakan waktu proses functionName yang diinginkan.
Catatan
Fungsi functionName Tahan Lama untuk dapat diambil dari properti rute yang mengikat fungsi dalam definisi JSON-nya, untuk menyertakan informasi peruteannya. Cukup menggunakan functionName tanpa detail rute yang disertakan akan mengakibatkan kegagalan karena Aplikasi Fungsi tidak dapat ditemukan.
Aktivitas Fungsi Azure juga mendukung kueri. Kueri harus disertakan sebagai bagian dari functionName. Misalnya, ketika nama fungsi dan HttpTriggerCSharp kueri yang ingin Anda sertakan adalah name=hello, maka Anda dapat membuat functionNamedi Aktivitas Fungsi Azure sebagai HttpTriggerCSharp?name=hello. Fungsi ini dapat di parameter sehingga nilai dapat ditentukan pada waktu proses.
Fungsi waktu habis dan jangka panjang
Azure Functions menghabiskan waktu setelah 230 detik terlepas darifunctionTimeout pengaturan yang telah Anda konfigurasi di pengaturan. Untuk informasi selengkapnya, lihat artikel ini. Untuk mengerjakan perilaku ini, ikuti pola asinkron atau gunakan Fungsi Tahan Lama. Manfaat Fungsi Tahan Lama adalah bahwa mereka menawarkan mekanisme pelacakan status mereka sendiri, sehingga Anda tidak perlu menerapkan pelacakan status sendiri.
Pelajari selengkapnya tentang Fungsi Tahan Lama di artikel ini. Anda dapat mengatur Aktivitas Fungsi Azure untuk memanggil Fungsi Tahan Lama, yang akan mengembalikan respons dengan URI lain, seperti contoh ini. Karena statusQueryGetUri mengembalikan Status HTTP 202 saat fungsi berjalan, Anda dapat melakukan polling status fungsi dengan menggunakan Aktivitas Web. Siapkan Aktivitas Web dengan bidang yang url diatur ke @activity('<AzureFunctionActivityName>').output.statusQueryGetUri. Ketika Fungsi Tahan Lama selesai, output fungsi akan menjadi output dari Aktivitas Web.
Sampel
Anda dapat menemukan sampel yang menggunakan Fungsi Azure untuk mengekstrak konten file tar di sini.
Konten terkait
Pelajari selengkapnya tentang aktivitas yang didukung di Alur dan aktivitas.