Menyambungkan ke hub kejadian dari alur kerja di Azure Logic Apps
Berlaku pada: Azure Logic Apps (Konsumsi)
Konektor Azure Event Hubs membantu Anda menyambungkan alur kerja aplikasi logika Anda ke hub kejadian di Azure. Anda kemudian dapat membuat alur kerja, memantau dan mengelola kejadian yang dikirim ke hub kejadian. Misalnya, alur kerja Anda dapat memeriksa, mengirim, dan menerima kejadian dari hub kejadian. Artikel ini menyediakan panduan memulai untuk menggunakan konektor Azure Event Hubs dengan memperlihatkan cara menyambungkan ke hub kejadian dan menambahkan pemicu atau tindakan azure Event Hubs ke alur kerja Anda.
Untuk informasi selengkapnya tentang Azure Event Hubs atau Azure Logic Apps, tinjau Apa itu Azure Event Hubs atau Apa itu Azure Logic Apps.
Operasi yang tersedia
Untuk semua operasi dan informasi teknis lainnya, seperti properti, batas, dan sebagainya, tinjau halaman referensi konektor Azure Event Hubs.
Catatan
Untuk aplikasi logika yang dihosting di lingkungan layanan integrasi (ISE), versi ISE konektor menggunakan batas pesan ISE.
Prasyarat
Akun dan langganan Azure. Jika Anda tidak memiliki langganan Azure, daftar akun Azure gratis.
Alur kerja aplikasi logika tempat Anda ingin mengakses hub kejadian
Untuk memulai alur kerja dengan pemicu Azure Event Hubs, Anda memerlukan alur kerja kosong. Jika Anda baru menggunakan Azure Logic Apps, coba mulai cepat ini untuk membuat contoh alur kerja aplikasi logika Konsumsi.
Memeriksa izin dan mendapatkan string koneksi
Untuk memastikan bahwa alur kerja Anda dapat mengakses hub kejadian, periksa izin, lalu dapatkan string koneksi untuk namespace hub kejadian Anda.
Di portal Microsoft Azure, buka namespace Hub Kejadian Anda, bukan hub kejadian tertentu.
Pada menu namespace, di bawah Pengaturan, pilih Kebijakan akses berbagi. Di kolom Klaim, pastikan Anda memiliki setidaknya Kelola izin untuk namespace tersebut.
Jika nanti Anda ingin memasukkan informasi koneksi Anda secara manual, dapatkan string koneksi untuk namespace hub kejadian.
Di kolom Kebijakan, pilih RootManageSharedAccessKey.
Temukan string koneksi kunci primer Anda. Salin dan simpan string koneksi untuk digunakan nanti.
Tip
Untuk mengonfirmasi apakah string koneksi dikaitkan dengan namespace Azure Event Hubs Anda atau dengan hub kejadian tertentu, pastikan string koneksi tidak memiliki parameter
EntityPath. Jika Anda menemukan parameter ini, string koneksi adalah untuk "entitas" Azure Event Hubs tertentu dan bukan string yang benar untuk digunakan dengan alur kerja Anda.
Membuat koneksi hub kejadian
Saat menambahkan pemicu atau tindakan Azure Event Hubs untuk pertama kalinya, Anda akan diminta untuk membuat koneksi ke hub kejadian Anda.
Saat Anda diminta, pilih salah satu opsi berikut:
Berikan informasi koneksi berikut:
Properti Wajib Nilai Deskripsi Nama Koneksi Ya <nama-koneksi> Nama yang akan dibuat untuk koneksi Anda Namespace Azure Event Hubs Ya <kejadian-hub-namespace> Pilih namespace Azure Event Hubs yang ingin Anda gunakan. Untuk memasukkan string koneksi yang disimpan sebelumnya secara manual, pilih Masukkan informasi koneksi secara manual. Pelajari cara menemukan string koneksi Anda.
Pilih kebijakan Azure Event Hubs yang akan digunakan, jika belum dipilih, lalu pilih Buat.
Setelah Anda membuat koneksi, lanjutkan dengan Tambahkan pemicu Azure Event Hubs atau Tambahkan tindakan Azure Event Hubs.
Tambahkan pemicu Azure Event Hubs
Di Azure Logic Apps, setiap alur kerja harus dimulai dengan pemicu, yang diaktifkan saat kondisi tertentu terpenuhi. Setiap kali pemicu diaktifkan, layanan Azure Logic Apps membuat instans alur kerja dan mulai menjalankan langkah-langkah dalam alur kerja.
Langkah-langkah berikut menjelaskan cara umum untuk menambahkan pemicu, misalnya, Saat kejadian tersedia di Hub Kejadian. Contoh ini menunjukkan cara menambahkan pemicu yang memeriksa kejadian baru di hub kejadian Anda dan memulai alur kerja yang berjalan saat ada kejadian baru.
Di Perancang Azure Logic Apps, buka alur kerja aplikasi logika kosong Anda, jika belum terbuka.
Di kotak pencarian operasi, masukkan
event hubs. Dari daftar pemicu, pilih pemicu bernama Saat kejadian tersedia di Hub Kejadian.
Jika Anda diminta untuk membuat koneksi ke hub kejadian, berikan informasi koneksi yang diminta.
Di pemicu, berikan informasi tentang hub kejadian yang ingin Anda pantau, misalnya:
Properti Wajib Deskripsi Nama Pusat Aktivitas Ya Nama untuk hub kejadian yang ingin Anda pantau Jenis konten No Jenis konten kejadian. Default adalah application/octet-stream.Nama grup konsumen No Nama grup konsumen Azure Event Hubs yang akan digunakan untuk membaca kejadian. Jika tidak ditentukan, grup konsumen default akan digunakan. Jumlah kejadian maksimum No Jumlah maksimum kejadian. Pemicu dihasilkan antara satu dan jumlah kejadian yang ditentukan oleh properti ini. Interval Ya Bilangan bulat positif yang menjelaskan seberapa sering alur kerja berjalan berdasarkan frekuensi Frekuensi Ya Satuan waktu untuk pengulangan Untuk properti lainnya, buka daftar Tambahkan parameter baru. Memilih parameter akan menambahkan properti tersebut ke pemicu, misalnya:
Properti lainnya
Properti Wajib Deskripsi Skema konten No Skema konten JSON untuk kejadian yang akan dibaca dari hub kejadian Anda. Misalnya, jika menentukan skema konten, Anda dapat memicu alur kerja hanya untuk kejadian yang cocok dengan skema tersebut. Kunci partisi minimum No Masukkan ID partisi minimum untuk dibaca. Secara default, semua partisi dibaca. Kunci partisi maksimum No Masukkan ID partisi maksimum untuk dibaca. Secara default, semua partisi dibaca. Zona waktu No Hanya berlaku saat Anda menentukan waktu mulai karena pemicu ini tidak menerima offset UTC. Pilih zona waktu yang ingin Anda terapkan. Untuk informasi selengkapnya, lihat Membuat dan menjalankan tugas dan alur kerja berulang dengan Azure Logic Apps.
Waktu mulai No Berikan waktu mulai dalam format ini: YYYY-MM-DDThh:mm:ss jika Anda memilih zona waktu
-atau-
YYYY-MM-DDThh:mm:ssZ jika Anda tidak memilih zona waktu
Untuk informasi selengkapnya, lihat Membuat dan menjalankan tugas dan alur kerja berulang dengan Azure Logic Apps.
Setelah selesai, pilih Simpan di toolbar alat perancang.
Sekarang lanjutkan menambahkan satu atau beberapa tindakan sehingga Anda dapat melakukan tugas lain menggunakan output pemicu.
Misalnya, untuk memfilter kejadian berdasarkan nilai tertentu, seperti kategori, Anda dapat menambahkan kondisi sehingga tindakan Kirim kejadian hanya mengirim kejadian yang memenuhi kondisi Anda.
Memicu perilaku polling
Semua pemicu Pusat Aktivitas adalah pemicu polling panjang. Perilaku ini berarti bahwa saat pemicu diaktifkan, pemicu memproses semua peristiwa dan menunggu 30 detik hingga lebih banyak peristiwa muncul di hub peristiwa Anda. Secara desain, jika tidak ada peristiwa yang muncul dalam 30 detik, pemicunya dilewati. Jika tidak, pemicu akan terus membaca kejadian hingga hub kejadian Anda kosong. Polling pemicu berikutnya terjadi berdasarkan interval pengulangan yang Anda tetapkan di properti pemicu.
Misalnya, jika pemicu diatur dengan empat partisi, penundaan ini mungkin memakan waktu hingga dua menit sebelum pemicu selesai mempolling semua partisi. Jika tidak ada kejadian yang diterima dalam penundaan ini, eksekusi pemicu akan dilewati. Jika tidak, pemicu akan terus membaca kejadian hingga hub kejadian Anda kosong. Polling pemicu berikutnya terjadi berdasarkan interval pengulangan yang Anda tentukan di properti pemicu.
Jika Anda mengetahui partisi tertentu di mana pesan muncul, Anda dapat memperbarui pemicu untuk membaca peristiwa hanya dari ini atau partisi tersebut dengan mengatur kunci partisi maksimum dan minimum pemicu. Untuk informasi selengkapnya, tinjau bagian Tambahkan pemicu Pusat Aktivitas.
Memicu perilaku titik pemeriksaan
Saat pemicu Azure Event Hubs membaca kejadian dari setiap partisi di hub kejadian, pengguna memicu statusnya sendiri untuk mempertahankan informasi tentang offset aliran (posisi kejadian dalam partisi) dan partisi tempat pemicu membaca kejadian.
Setiap kali alur kerja Anda berjalan, pemicu membaca kejadian dari partisi, mulai dari offset aliran yang disimpan oleh status pemicu. Dalam mode round-robin, pemicu mengulangi setiap partisi di hub kejadian dan membaca kejadian di pemicu eksekusi berikutnya. Satu eksekusi mendapatkan kejadian dari satu partisi pada satu waktu.
Pemicu tidak menggunakan kemampuan titik pemeriksaan ini dalam penyimpanan, sehingga tidak ada biaya tambahan. Namun, poin utamanya adalah memperbarui pemicu Azure Event Hubs yang akan mengatur ulang status pemicu, yang dapat menyebabkan pemicu membaca kejadian di awal aliran.
Tambahkan tindakan Azure Event Hubs
Di Azure Logic Apps, tindakan mengikuti pemicu atau tindakan lain dan melakukan beberapa operasi di alur kerja Anda. Langkah-langkah berikut menjelaskan cara umum untuk menambahkan tindakan, misalnya, Kirim kejadian. Untuk contoh ini, alur kerja dimulai dengan pemicu Azure Event Hubs yang memeriksa kejadian baru di hub kejadian Anda.
Di Perancang Azure Logic Apps, buka alur kerja aplikasi logika Anda, jika belum terbuka.
Di bawah pemicu atau tindakan lain, tambah langkah baru.
Untuk menambahkan langkah di antara langkah-langkah yang ada, pindahkan mouse Anda ke atas panah. Pilih tanda plus (+) yang muncul, kemudian pilih Tambahkan tindakan.
Di kotak pencarian operasi, masukkan
event hubs. Dari daftar tindakan, pilih tindakan bernama Kirim kejadian.
Jika Anda diminta untuk membuat koneksi ke hub kejadian, berikan informasi koneksi yang diminta.
Dalam tindakan, berikan informasi tentang kejadian yang ingin Anda kirim.
Properti Wajib Deskripsi Nama Pusat Aktivitas Ya Hub kejadian tempat Anda ingin mengirim kejadian Konten No Konten untuk kejadian yang ingin Anda kirim Properti No Properti dan nilai aplikasi yang akan dikirim Kunci partisi No ID partisi untuk mengirim kejadian Untuk properti lainnya, buka daftar Tambahkan parameter baru. Memilih parameter menambahkan properti tersebut ke tindakan, misalnya:
Misalnya, Anda dapat mengirim output dari pemicu Azure Event Hubs ke hub kejadian lain:
Setelah selesai, pilih Simpan di toolbar alat perancang.
Referensi konektor
Untuk semua operasi dan informasi teknis lainnya, seperti properti, batas, dan sebagainya, tinjau halaman referensi konektor Azure Event Hubs.
Catatan
Untuk aplikasi logika yang dihosting di lingkungan layanan integrasi (ISE), versi ISE konektor menggunakan batas pesan ISE.
Langkah berikutnya
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk