Quickstart: Grote berichten verzenden en ontvangen met Azure Event Hubs (preview)

In deze quickstart leert u hoe u grote berichten (maximaal 20 MB) verzendt en ontvangt met behulp van Azure Event Hubs. Als u niet eerder met Event Hubs werkt, raadpleegt u het overzicht van Event Hubs voordat u deze quickstart doorloopt.

Vereisten

Voor het voltooien van deze snelstart moet aan de volgende vereisten worden voldaan:

• Een Azure-abonnement. Als u Azure-services, waaronder Event Hubs, wilt gebruiken, hebt u een abonnement nodig. Als u nog geen Azure-account hebt, kunt u zich aanmelden voor een gratis proefversie of uw voordelen als MSDN-abonnee gebruiken wanneer u een account maakt.
• Een schaalbaar, schaalbaar toegewezen cluster, een Event Hubs-naamruimte en een Event Hub. De eerste stap om aan deze vereiste te voldoen, is het gebruik van Azure Portal om een toegewezen cluster en naamruimte in een cluster te maken. Zie Quickstart: Een Event Hub maken met behulp van Azure Portal om een Event Hub te maken. U kunt deze stap overslaan als u al een schaalbaar, schaalbaar, toegewezen cluster hebt.

Notitie

Ondersteuning voor grote berichten, momenteel in openbare preview, is exclusief beschikbaar voor bepaalde Event Hubs-clusters die zelf toegewezen clusters gebruiken. Voor het streamen van grote berichten met deze clusters worden geen extra kosten in rekening gebracht.

Een toegewezen Event Hubs-cluster configureren

Als u grote berichten wilt streamen, moet u uw eigen schaalbare toegewezen cluster configureren.

Ga in Azure Portal naar de sectie Instellingen voor het toegewezen cluster. Selecteer onder Instellingen het tabblad Quotum .

• Controleer of de waarde voor de alleen-lezensleutel supportslargemessages is ingesteld op True.
• U kunt de sleutel eventhubmaxmessagesizeinbytes bijwerken naar een geschikte waarde in bytes. Een acceptabel bereik voor deze waarde is tussen 1.048.576 en 20.971.520 bytes.

Nadat de configuratie is opgeslagen, kunt u grote berichten streamen met Event Hubs.

Belangrijk

Grote berichtenstreaming wordt alleen ondersteund met schaalbare, schaalbare toegewezen clusters die zijn gebouwd op basis van de nieuwste infrastructuur. Deze mogelijkheid wordt weerspiegeld door de Supportslargemessages sleutel.

Als een clusterwaarde onwaar is, biedt dit geen ondersteuning voor het streamen van grote berichten. Als u deze functie wilt inschakelen, moet u het cluster opnieuw maken.

Grote berichten streamen met Event Hubs

Met Event Hubs kunt u grote berichten streamen tot 20 MB, zowel in batches als afzonderlijke publicaties. De mogelijkheid om grote berichten of gebeurtenissen te streamen, vereist geen wijzigingen in de clientcode, afgezien van de wijziging in het bericht of de gebeurtenis zelf. U kunt berichten blijven verzenden of ontvangen met behulp van een bestaande Event Hubs SDK of Kafka-API om grote berichten naar Event Hubs te streamen. Op deze manier kunt u grote berichten streamen naar Event Hubs op dezelfde manier als voor berichten met een grootte van minder dan 1 MB.

Zie Gebeurtenissen verzenden naar en ontvangen van Event Hubs met behulp van .NET voor meer informatie.

Tip

Zorg ervoor dat u een eventuele AMQP-client (Advanced Message Queuing Protocol) of Kafka-clientconfiguratie van Event Hubs bekijkt die de maximale berichtgrootte kan beperken die u naar Event Hubs streamt. U moet clienttime-out bijwerken naar een hogere waarde om grote berichten te streamen.

Standaard is het aantal prefetchs van de AMQP-client 300. Verlaag deze waarde om geheugenproblemen aan de clientzijde te voorkomen wanneer u grote berichten verwerkt.

Raadpleeg de SDK-documentatie voor de volledige naslaginformatie over de .NET-bibliotheek.