Snabbstart: Skicka och ta emot stora meddelanden med Azure Event Hubs (förhandsversion)

I den här snabbstarten får du lära dig hur du skickar och tar emot stora meddelanden (upp till 20 MB) med hjälp av Azure Event Hubs. Om du inte har använt Event Hubs tidigare kan du läsa Översikt över Event Hubs innan du går igenom den här snabbstarten.

Förutsättningar

För att slutföra den här snabbstarten, behöver du följande förhandskrav:

• En Azure-prenumeration Om du vill använda Azure-tjänster, inklusive Event Hubs, behöver du en prenumeration. Om du inte har ett befintligt Azure-konto kan du registrera dig för en kostnadsfri utvärderingsversion eller använda dina MSDN-prenumerantförmåner när du skapar ett konto.
• Ett skalbart dedikerat kluster med självbetjäning, ett event hubs-namnområde och en händelsehubb. Det första steget för att uppfylla detta krav är att använda Azure-portalen för att skapa ett dedikerat kluster och ett namnområde i ett kluster. Information om hur du skapar en händelsehubb finns i Snabbstart: Skapa en händelsehubb med hjälp av Azure-portalen. Du kan hoppa över det här steget om du redan har ett skalbart dedikerat kluster med självbetjäning.

Kommentar

Stöd för stora meddelanden, för närvarande i offentlig förhandsversion, är exklusivt tillgängligt med vissa dedikerade Event Hubs-kluster med självbetjäning. Att strömma stora meddelanden med dessa kluster medför inga extra avgifter.

Konfigurera ett event hubs-dedikerat kluster

Om du vill strömma stora meddelanden måste du konfigurera ditt skalbara dedikerade kluster med självbetjäning.

I Azure-portalen går du till avsnittet Inställningar för det dedikerade klustret. Under Inställningar väljer du fliken Kvot .

• Kontrollera att värdet för den skrivskyddade nyckeln supportslargemessages är inställt på True.
• Du kan uppdatera nyckeln eventhubmaxmessagesizeinbytes till ett lämpligt värde i byte. Ett acceptabelt intervall för det här värdet är mellan 1 048 576 och 20 971 520 byte.

När konfigurationen har sparats är du redo att strömma stora meddelanden med Event Hubs.

Viktigt!

Stor meddelandeströmning stöds endast med skalbara dedikerade kluster med självbetjäning som är inbyggda i den senaste infrastrukturen. Den här funktionen återspeglas av Supportslargemessages nyckeln.

Om ett klustervärde är falskt stöder det inte stor meddelandeströmning. Om du vill aktivera den här funktionen måste du återskapa klustret.

Strömma stora meddelanden med Event Hubs

Event Hubs tillåter strömning av stora meddelanden upp till 20 MB, både i batchar och som enskilda publikationer. Möjligheten att strömma stora meddelanden eller händelser kräver inga klientkodändringar förutom ändringen i själva meddelandet eller händelsen. Du kan fortsätta att skicka eller ta emot meddelanden med hjälp av befintlig Event Hubs SDK eller Kafka API för att strömma stora meddelanden till Event Hubs. På så sätt kan du strömma stora meddelanden till Event Hubs på samma sätt som för meddelanden med storlekar som är mindre än 1 MB.

Mer information finns i Skicka händelser till och ta emot händelser från Event Hubs med hjälp av .NET.

Dricks

Se till att granska en AMQP-klient (Event Hubs Advanced Message Queuing Protocol) eller Kafka-klientkonfiguration som kan begränsa den maximala meddelandestorleken som du strömmar till Event Hubs. Du måste uppdatera klientens timeout till ett högre värde för att strömma stora meddelanden.

AmQP-klientens prefetchantal är som standard 300. Sänk det här värdet för att undvika minnesproblem på klientsidan när du hanterar stora meddelanden.

Den fullständiga .NET-biblioteksreferensen finns i SDK-dokumentationen.