Mulai cepat: Mengirim dan menerima pesan besar dengan Azure Event Hubs (pratinjau)

Dalam mulai cepat ini, Anda mempelajari cara mengirim dan menerima pesan besar (hingga 20 MB) dengan menggunakan Azure Event Hubs. Jika Anda baru menggunakan Azure Event Hubs, lihat Gambaran umum Azure Event Hubs sebelum Anda melalui mulai cepat ini.

Prasyarat

Untuk menyelesaikan mulai cepat ini, Anda memerlukan prasyarat berikut:

• Langganan Azure. Untuk menggunakan layanan Azure, termasuk Azure Event Hubs, Anda memerlukan langganan. Jika Anda belum memiliki akun Azure, Anda dapat mendaftar untuk coba gratis atau memanfaatkan pelanggan MSDN saat Anda membuat akun.
• Kluster khusus yang dapat diskalakan mandiri, namespace layanan pusat aktivitas, dan pusat aktivitas. Langkah pertama untuk memenuhi prasyarat ini adalah menggunakan portal Azure untuk membuat kluster dan namespace khusus di dalam kluster. Untuk membuat pusat aktivitas, lihat Mulai Cepat: Membuat pusat aktivitas dengan menggunakan portal Microsoft Azure. Anda dapat melewati langkah ini jika Anda sudah memiliki kluster khusus yang dapat diskalakan mandiri.

Catatan

Dukungan pesan besar, yang saat ini dalam pratinjau publik, tersedia secara eksklusif dengan kluster khusus layanan mandiri Azure Event Hubs tertentu. Streaming pesan besar dengan kluster ini tidak dikenakan biaya tambahan.

Mengonfigurasi kluster khusus Azure Event Hubs

Untuk melakukan streaming pesan besar, Anda harus mengonfigurasi kluster khusus yang dapat diskalakan mandiri.

Di portal Azure, buka bagian Pengaturan untuk kluster khusus. Di bawah Pengaturan, pilih tab Kuota .

• Validasi bahwa nilai untuk kunci supportslargemessages baca-saja diatur ke True.
• Anda dapat memperbarui kunci eventhubmaxmessagesizeinbytes ke nilai yang sesuai dalam byte. Rentang yang dapat diterima untuk nilai ini adalah antara 1.048.576 dan 20.971.520 byte.

Setelah konfigurasi disimpan, Anda siap untuk melakukan streaming pesan besar dengan Azure Event Hubs.

Penting

Streaming pesan besar hanya didukung dengan kluster khusus yang dapat diskalakan mandiri yang dibangun dari infrastruktur terbaru. Kemampuan ini tercermin oleh Supportslargemessages kunci.

Jika nilai kluster salah, nilai tersebut tidak akan mendukung streaming pesan besar. Untuk mengaktifkan fitur ini, Anda harus membuat ulang kluster.

Streaming pesan besar dengan Azure Event Hubs

Azure Event Hubs memungkinkan streaming pesan besar hingga 20 MB, baik dalam batch maupun sebagai publikasi individual. Kemampuan untuk mengalirkan pesan atau peristiwa besar tidak memerlukan perubahan kode klien selain dari perubahan pesan atau peristiwa itu sendiri. Anda dapat terus mengirim atau menerima pesan dengan menggunakan Event Hubs SDK atau Kafka API yang ada untuk mengalirkan pesan besar ke Azure Event Hubs. Dengan cara ini Anda dapat mengalirkan pesan besar ke Azure Event Hubs dengan cara yang sama seperti yang Anda lakukan untuk pesan berukuran kurang dari 1 MB.

Untuk informasi selengkapnya, lihat Mengirim peristiwa ke dan menerima peristiwa dari Azure Event Hubs dengan menggunakan .NET.

Tip

Pastikan untuk meninjau klien Event Hubs Advanced Message Queuing Protocol (AMQP) atau konfigurasi klien Kafka yang mungkin membatasi ukuran pesan maksimum yang Anda streaming ke Azure Event Hubs. Anda harus memperbarui batas waktu klien ke nilai yang lebih tinggi untuk mengalirkan pesan besar.

Secara default, jumlah prefetch klien AMQP adalah 300. Turunkan nilai ini untuk menghindari masalah memori sisi klien saat Anda berurusan dengan pesan besar.

Untuk referensi pustaka .NET lengkap, lihat dokumentasi SDK.