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:

1. Perluas bagian Fungsi Azure dari panel Aktivitas alur, dan seret aktivitas Fungsi Azure ke kanvas alur.

2. Pilih aktivitas Fungsi Azure baru di kanvas jika belum dipilih, dan tab Pengaturan, untuk mengedit detailnya.

   

3. 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.

   

4. 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 JArray bukan JObject.) 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. Cari tahu selengkapnya di sini: Bekerja dengan kunci akses	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.	No

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)	No
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.