Mengambil peristiwa dari Azure Event Hubs ke dalam hub Real-Time

Artikel ini menjelaskan cara mendapatkan peristiwa dari Azure Event Hub ke hub Real-Time.

Prerequisites

• Akses ke ruang kerja dalam mode lisensi kapasitas Fabric atau mode lisensi uji coba dengan izin Kontributor atau lebih tinggi.
• Izin yang sesuai untuk mendapatkan kunci akses hub acara. Jika pusat aktivitas Anda berada dalam jaringan yang dilindungi, sambungkan dengan menggunakan titik akhir privat terkelola. Jika tidak, pastikan bahwa pusat aktivitas dapat diakses secara publik dan bukan di belakang firewall.

Navigasi ke halaman Tambahkan data

1. Masuk ke Microsoft Fabric.

2. Jika Anda melihat Power BI di bagian kiri bawah halaman, beralihlah ke workload Fabric dengan memilih Power BI lalu dengan memilih Fabric.

   

3. Pilih Real-Time di bilah navigasi kiri.

   

4. Halaman Data streaming terbuka secara default. Klik tombol Tambahkan data untuk masuk ke halaman Tambahkan data .

   

   Anda juga bisa masuk ke halaman Tambahkan data secara langsung dengan memilih opsi Tambahkan data di bilah navigasi kiri.

   

Pada Tambahkan data, Anda dapat menyambungkan ke hub peristiwa Azure menggunakan tab Semua sumber atau tab Azure (disarankan). Artikel ini membahas kedua cara untuk menyambungkan ke pusat aktivitas Azure.

Gunakan tab Azure untuk menyambungkan ke pusat aktivitas (disarankan)

1. Pada halaman Tambahkan data, beralihlah ke tab Azure.

   

2. Arahkan mouse ke atas namespace Azure Event Hubs Anda dalam daftar, dan pilih tombol Connect yang muncul. Atau, Anda dapat memilih ... lalu Sambungkan dari menu dropdown.

   Gunakan bilah pencarian untuk menemukan namespace layanan Azure Event Hubs dengan cepat jika Anda memiliki banyak sumber daya Azure (atau) menggunakan filter untuk memfilter daftar menurut jenis sumber (Azure Event Hubs namespace), langganan, grup sumber daya, atau wilayah.

   

3. Di wizard Sambungkan sumber data , pada halaman Konfigurasi , ikuti langkah-langkah berikut:

   1. Pilih Event Hub dari daftar drop-down. Menu tarik-turun berisi event hub dari namespace Azure Event Hubs yang dipilih.

   2. Pilih nama kunci dari daftar tarik-turun. Dropdown diisi dengan nama kunci dari hub peristiwa yang dipilih.

      

   3. Untuk Grup konsumen, pilih $Default atau masukkan nama grup konsumen kustom yang telah Anda siapkan untuk pusat aktivitas ini.

   4. Untuk Format data, pilih format peristiwa di pusat aktivitas Anda (misalnya, JSON, Avro, dll.).

   5. Di bagian Detail aliran di sebelah kanan, ikuti langkah-langkah berikut:

      1. Pilih ruang kerja Fabric tempat Anda ingin membuat eventstream.

      2. Untuk Nama aliran kejadian, klik tombol Pensil, dan masukkan nama untuk aliran kejadian.

      3. Nilai Nama stream secara otomatis dibuat untuk Anda dengan menambahkan -stream ke nama eventstream. Aliran ini muncul di halaman Semua aliran data hub real-time saat wizard selesai.

         

4. Pilih Tinjau dan sambungkan di bagian bawah halaman Konfigurasikan .

5. Tinjau detail di halaman Tinjau + sambungkan , lalu pilih Sambungkan.

   

1. Pada halaman Tambahkan data, beralihlah ke tab Azure.

   

2. Arahkan mouse ke atas namespace Azure Event Hubs Anda dalam daftar, dan pilih tombol Connect yang muncul. Atau, Anda dapat memilih ... lalu Sambungkan dari menu dropdown.

   Gunakan bilah pencarian untuk menemukan namespace layanan Azure Event Hubs dengan cepat jika Anda memiliki banyak sumber daya Azure (atau) menggunakan filter untuk memfilter daftar menurut jenis sumber (Azure Event Hubs namespace), langganan, grup sumber daya, atau wilayah.

   

3. Di wizard Sambungkan sumber data , pada halaman Konfigurasi , ikuti langkah-langkah berikut:

   1. Pilih Event Hub dari daftar drop-down. Menu tarik-turun berisi event hub dari namespace Azure Event Hubs yang dipilih.

   2. Pilih nama kunci dari daftar tarik-turun. Dropdown diisi dengan nama kunci dari hub peristiwa yang dipilih.

      

   3. Untuk Tingkat fitur, pilih Fitur yang diperluas.

      1. Untuk Grup konsumen, pilih grup konsumen dari daftar dropdown. Dropdown diisi dengan grup konsumen dari hub peristiwa yang dipilih.
      2. Untuk Posisi awal, pilih titik tempat Anda ingin mulai menyerap peristiwa. Anda dapat memilih untuk memulai dari acara paling awal yang tersedia, acara terbaru, atau titik waktu tertentu.

   4. Di bagian Detail aliran di sebelah kanan, ikuti langkah-langkah berikut:

      1. Pilih ruang kerja Fabric tempat Anda ingin membuat eventstream.

      2. Untuk Nama aliran kejadian, klik tombol Pensil, dan masukkan nama untuk aliran kejadian.

      3. Nilai Nama stream secara otomatis dibuat untuk Anda dengan menambahkan -stream ke nama eventstream. Aliran ini muncul di halaman Semua aliran data hub real-time saat wizard selesai.

         

   5. Pilih Berikutnya di bagian bawah halaman Konfigurasikan .

Halaman penanganan skema

1. Pada halaman Penanganan skema , berikan aturan untuk menangani peristiwa yang diterima dari hub peristiwa yang dipilih, sehingga eventstream dapat menerapkannya dengan benar. Aturan pemetaan bergantung pada cara Anda memodelkan peristiwa.

   Jika Anda memiliki satu skema yang mengatur semua peristiwa, pilih Skema tetap.

   Jika Anda memiliki beberapa skema yang mewakili berbagai peristiwa masuk, tentukan aturan yang cocok untuk menerapkan skema Anda. Untuk memilih mode ini, pilih Skema dinamis melalui header. Kemudian, tentukan aturan dengan menggunakan pasangan header/nilai untuk memilih setiap skema. Header adalah properti header Kafka kustom yang merupakan bagian dari metadata peristiwa. Nilai adalah nilai yang diharapkan untuk properti tersebut.

   

2. Pilih skema dengan memilih menu dropdown Tambahkan skema lainnya lalu pilih satu atau beberapa skema yang ada dari registri skema peristiwa. Jika Anda tidak memiliki skema untuk dipilih, Anda dapat membuat skema baru dari tampilan ini. Untuk mempelajari cara menentukan skema peristiwa baru, lihat Membuat dan mengelola skema peristiwa dalam set skema.

   

   Jika Anda memilih opsi Pilih dari registri skema peristiwa , panel Kaitkan skema peristiwa akan muncul. Pilih satu atau beberapa skema dari registri, bergantung pada mode pencocokan skema Anda, lalu pilih Pilih di bagian bawah panel.

   

3. Jika Anda memilih opsi Skema tetap , Anda tidak perlu memberikan aturan lagi untuk mencocokkan skema. Anda dapat melanjutkan ke langkah berikutnya.

   Jika Anda memilih opsi Skema dinamis melalui header, tentukan properti header Kafka dan nilai yang diharapkan yang memetakan ke skema. Tambahkan lebih banyak skema dan tentukan properti serta nilai header yang berbeda untuk dipetakan ke skema tersebut.

   Nota

   Saat Anda menentukan aturan pemetaan, setiap nilai header harus unik. Jika Anda mencoba menggunakan kembali skema, Anda akan melihat pesan peringatan yang menunjukkan bahwa Anda mungkin memutus aliran yang ada. Selama aturan pemetaan sama, Anda dapat menggunakan kembali skema. Jika batasan ini memengaruhi penggunaan Anda, hubungi perwakilan Microsoft Anda untuk membagikan umpan balik Anda. Kami secara aktif berupaya menghapus batasan ini.

   

4. Setelah Anda memetakan skema untuk semua peristiwa yang diharapkan, pilih Berikutnya di bagian bawah halaman Penanganan skema .

   

Tinjau dan sambungkan

1. Pada halaman Tinjau + sambungkan , tinjau pengaturan, lalu pilih Sambungkan.

   

2. Pada halaman Tinjau + sambungkan , pilih Tambahkan (Eventstream) atau Sambungkan (Real-Time hub).

   

Menampilkan detail aliran data

1. Pada halaman Tinjau + sambungkan , jika Anda memilih Buka eventstream, wizard akan membuka eventstream yang dibuatnya untuk Anda dengan hub peristiwa yang dipilih sebagai sumber. Untuk menutup wizard, pilih Selesai di bagian bawah halaman.

   

2. Anda melihat aliran di bagian Data streaming terbaru di halaman beranda Real-Time hub. Untuk langkah-langkah terperinci, lihat Melihat detail aliran data di hub Fabric Real-Time.

   

Menggunakan tab Semua sumber untuk menyambungkan ke pusat aktivitas

Anda juga dapat menggunakan tab Semua sumber pada halaman Tambahkan data untuk menyambungkan ke hub peristiwa Azure. Namun, tab Azure disarankan karena lebih mudah untuk terhubung ke pusat aktivitas.

Pada halaman Tambahkan data, pilih kategori Microsoft di bagian atas, lalu pilih Azure Event Hubs.

Sekarang, ikuti instruksi di bagian Sambungkan ke hub peristiwa Azure .

Mengonfigurasi dan menghubungkan ke Azure Event Hub

1. Pada Konfigurasikan pengaturan koneksi, konfirmasikan bahwa Dasar dipilih untuk tingkat fitur, lalu pilih Koneksi baru.

   

   Jika ada koneksi yang sudah ada ke pusat aktivitas Anda, pilih koneksi yang sudah ada. Kemudian, lanjutkan untuk mengonfigurasi format data dalam langkah-langkah berikut.

   

2. Di bagian Pengaturan koneksi, ikuti langkah-langkah berikut:

   1. Masukkan nama namespace layanan Azure Event Hubs.
   2. Masukkan nama pusat aktivitas.

   

3. Di bagian Kredensial koneksi , ikuti langkah-langkah berikut:

   1. Untuk Nama koneksi, masukkan nama untuk koneksi ke hub peristiwa.
   2. Untuk Jenis autentikasi, konfirmasikan bahwa Kunci Akses Bersama dipilih.
   3. Untuk Nama Kunci Akses Bersama, masukkan nama kunci akses bersama. Untuk petunjuk tentang mendapatkan kunci akses, lihat Mendapatkan string koneksi Azure Event Hubs.
   4. Untuk Kunci Akses Bersama, masukkan nilai kunci akses bersama.
   5. Pilih Sambungkan.

   

4. Untuk Grup konsumen, masukkan nama grup konsumen. Grup konsumen default untuk hub peristiwa adalah $Default.

5. Untuk Format data, pilih format data untuk acara real-time yang masuk yang ingin Anda ambil dari Azure Event Hub Anda. Anda dapat memilih dari format data JSON, Avro, dan CSV (dengan header).

   

6. Pada panel Detail sumber di sebelah kanan, pilih ikon pensil di samping nama sumber, lalu masukkan nama untuk sumber. Langkah ini bersifat opsional.

   

7. Pilih Berikutnya di bagian bawah laman.

   

8. Pada halaman Tinjau + sambungkan , tinjau pengaturan, lalu pilih Tambahkan.

   

1. Pada Konfigurasikan pengaturan koneksi, untuk Pilih tingkat fitur, pilih Fitur yang diperluas.

   

   Jika ada koneksi yang sudah ada ke pusat aktivitas Anda, pilih koneksi yang sudah ada. Kemudian, lanjutkan untuk mengonfigurasi format data dalam langkah-langkah berikut.

2. Di bagian Pengaturan koneksi, ikuti langkah-langkah berikut:

   1. Masukkan nama namespace layanan Azure Event Hubs.

   2. Masukkan nama pusat aktivitas.

      

3. Di bagian Kredensial koneksi , ikuti langkah-langkah berikut:

   Pilih tab yang sesuai di bawah ini dan ikuti langkah-langkah untuk jenis Autentikasi yang diperlukan.

   Kunci akses bersama

   1. Untuk Nama koneksi, masukkan nama untuk koneksi ke hub peristiwa.

   2. Untuk Jenis autentikasi, konfirmasikan bahwa Kunci Akses Bersama dipilih.

   3. Untuk Nama Kunci Akses Bersama, masukkan nama kunci akses bersama. Untuk petunjuk tentang mendapatkan kunci akses, lihat Mendapatkan string koneksi Azure Event Hubs.

   4. Untuk Kunci Akses Bersama, masukkan nilai kunci akses bersama.

   5. Pilih Sambungkan.

      

   Identitas ruang kerja

   Jika Anda ingin menggunakan identitas ruang kerja untuk autentikasi, selesaikan langkah-langkah berikut sebelum mengonfigurasi koneksi:

   1. Periksa apakah ruang kerja Anda mengaktifkan identitas ruang kerja. Jika tidak, buka Pengaturan ruang kerja> lalu pilih Identitas ruang kerja, dan aktifkan Identitas ruang kerja.

      

   2. Salin ID identitas ruang kerja dari pengaturan Ruang Kerja → Identitas ruang kerja.

      

   3. Di Pusat Aktivitas Azure Anda, buka Kontrol akses (IAM) dan pilih Tambahkan penetapan peran.

      

   4. Cari dan pilih peran Azure Event Hubs Penerima Data, lalu pilih Berikutnya.

      

   5. Di bawah Tetapkan akses ke, pilih Pengguna, grup, atau perwakilan layanan.

   6. Pilih Anggota, lalu masukkan nama ruang kerja Anda atau tempelkan ID yang Anda salin untuk menemukan ruang kerja Anda. Pilih Selanjutnya.

      

   Setelah menyelesaikan langkah-langkah ini, kembali ke halaman konfigurasi koneksi dan lanjutkan:

   1. Untuk Nama koneksi, masukkan nama untuk koneksi ke hub peristiwa.

   2. Untuk Gateway data, pilih opsi yang sesuai dengan konfigurasi jaringan Event Hub Anda:

      • Jika pusat aktivitas Anda bersifat publik, pilih tidak ada.
      • Jika pusat aktivitas Anda berada di bawah jaringan privat dan Anda ingin terhubung melalui gateway data jaringan virtual streaming, pilih gateway data vNet streaming (diawali dengan [Streaming VNET]). Anda dapat memilih ikon refresh untuk mencantumkan gateway yang baru dibuat.

      Nota

      Jika sebuah gateway data sudah dipilih, lewati langkah uji koneksi pada wizard pembuatan koneksi ini.

   3. Untuk Jenis autentikasi, konfirmasikan bahwa identitas ruang kerja dipilih.

      

4. Untuk Grup konsumen, masukkan nama grup konsumen. Grup konsumen default untuk hub peristiwa adalah $Default.

   

Detail aliran atau sumber

1. Pada halaman Sambungkan , ikuti salah satu langkah ini berdasarkan apakah Anda menggunakan Eventstream atau hub Real-Time.

   • Eventstream:

     Di panel Detail sumber di sebelah kanan, ikuti langkah-langkah berikut:

     1. Untuk Nama sumber, pilih tombol Pensil untuk mengubah nama.

     2. Perhatikan bahwa nama Eventstream dan nama Stream bersifat baca-saja.

   • Hub Real-Time:

     Di bagian Detail aliran di sebelah kanan, ikuti langkah-langkah berikut:

     1. Pilih ruang kerja Fabric tempat Anda ingin membuat eventstream.

     2. Untuk Nama aliran kejadian, klik tombol Pensil, dan masukkan nama untuk aliran kejadian.

     3. Nilai Nama stream secara otomatis dibuat untuk Anda dengan menambahkan -stream ke nama eventstream. Aliran ini muncul di halaman Semua aliran data hub real-time saat wizard selesai.

2. Pilih Berikutnya di bagian bawah halaman Konfigurasikan .

Halaman penanganan skema

1. Pada halaman Penanganan skema , berikan aturan untuk menangani peristiwa yang diterima dari hub peristiwa yang dipilih, sehingga eventstream dapat menerapkannya dengan benar. Aturan pemetaan bergantung pada cara Anda memodelkan peristiwa.

   Jika Anda memiliki satu skema yang mengatur semua peristiwa, pilih Skema tetap.

   Jika Anda memiliki beberapa skema yang mewakili berbagai peristiwa masuk, tentukan aturan yang cocok untuk menerapkan skema Anda. Untuk memilih mode ini, pilih Skema dinamis melalui header. Kemudian, tentukan aturan dengan menggunakan pasangan header/nilai untuk memilih setiap skema. Header adalah properti header Kafka kustom yang merupakan bagian dari metadata peristiwa. Nilai adalah nilai yang diharapkan untuk properti tersebut.

   

2. Pilih skema dengan memilih menu dropdown Tambahkan skema lainnya lalu pilih satu atau beberapa skema yang ada dari registri skema peristiwa. Jika Anda tidak memiliki skema untuk dipilih, Anda dapat membuat skema baru dari tampilan ini. Untuk mempelajari cara menentukan skema peristiwa baru, lihat Membuat dan mengelola skema peristiwa dalam set skema.

   

   Jika Anda memilih opsi Pilih dari registri skema peristiwa , panel Kaitkan skema peristiwa akan muncul. Pilih satu atau beberapa skema dari registri, bergantung pada mode pencocokan skema Anda, lalu pilih Pilih di bagian bawah panel.

   

3. Jika Anda memilih opsi Skema tetap , Anda tidak perlu memberikan aturan lagi untuk mencocokkan skema. Anda dapat melanjutkan ke langkah berikutnya.

   Jika Anda memilih opsi Skema dinamis melalui header, tentukan properti header Kafka dan nilai yang diharapkan yang memetakan ke skema. Tambahkan lebih banyak skema dan tentukan properti serta nilai header yang berbeda untuk dipetakan ke skema tersebut.

   Nota

   Saat Anda menentukan aturan pemetaan, setiap nilai header harus unik. Jika Anda mencoba menggunakan kembali skema, Anda akan melihat pesan peringatan yang menunjukkan bahwa Anda mungkin memutus aliran yang ada. Selama aturan pemetaan sama, Anda dapat menggunakan kembali skema. Jika batasan ini memengaruhi penggunaan Anda, hubungi perwakilan Microsoft Anda untuk membagikan umpan balik Anda. Kami secara aktif berupaya menghapus batasan ini.

   

4. Setelah Anda memetakan skema untuk semua peristiwa yang diharapkan, pilih Berikutnya di bagian bawah halaman Penanganan skema .

   

Tinjau dan sambungkan

1. Pada halaman Tinjau + sambungkan , tinjau pengaturan, lalu pilih Sambungkan.

   

2. Pada halaman Tinjau + sambungkan , pilih Tambahkan (Eventstream) atau Sambungkan (Real-Time hub).

   

Konten terkait

Untuk mempelajari tentang menggunakan aliran data, lihat artikel berikut ini:

• Memproses aliran data
• Menganalisis aliran data
• Mengatur pemberitahuan pada aliran data