Rövid útmutató: Nagyméretű üzenetek küldése és fogadása az Azure Event Hubs használatával (előzetes verzió)

Ebben a rövid útmutatóban megtudhatja, hogyan küldhet és fogadhat nagyméretű üzeneteket (akár 20 MB-ot) az Azure Event Hubs használatával. Ha még nem ismerkedik az Event Hubs szolgáltatással, tekintse meg az Event Hubs áttekintését , mielőtt végighalad a rövid útmutatón.

Előfeltételek

A rövid útmutató elvégzéséhez a következő előfeltételekre van szüksége:

• Azure-előfizetés. Az Azure-szolgáltatások, köztük az Event Hubs használatához előfizetésre van szükség. Ha nem rendelkezik meglévő Azure-fiókkal, regisztrálhat egy ingyenes próbaverzióra, vagy használhatja az MSDN-előfizetői előnyöket a fiók létrehozásakor.
• Önkiszolgáló , skálázható dedikált fürt, eseményközpont-névtér és eseményközpont. Ennek az előfeltételnek az első lépése, hogy az Azure Portal használatával létrehoz egy dedikált fürtöt és névteret egy fürtben. Eseményközpont létrehozásához tekintse meg a rövid útmutatót: Eseményközpont létrehozása az Azure Portal használatával. Ezt a lépést kihagyhatja, ha már rendelkezik önkiszolgáló, skálázható dedikált fürtel.

Feljegyzés

A jelenleg nyilvános előzetes verzióban elérhető nagyméretű üzenettámogatás kizárólag bizonyos, önkiszolgáló dedikált Event Hubs-fürtökkel érhető el. A nagy méretű üzenetek streamelése ezekkel a fürtökkel nem jár többletköltséggel.

Dedikált Event Hubs-fürt konfigurálása

A nagy méretű üzenetek streameléséhez konfigurálnia kell az önkiszolgáló, skálázható dedikált fürtöt.

Az Azure Portalon nyissa meg a dedikált fürt Beállítások szakaszát. A Beállítások területen válassza a Kvóta lapot.

• Ellenőrizze, hogy az írásvédett kulcs supportslargemessages értéke be van-e állítva True.
• A kulcsot eventhubmaxmessagesizeinbytes bájtban megfelelő értékre frissítheti. Az érték elfogadható tartománya 1 048 576 és 20 971 520 bájt között van.

A konfiguráció mentése után készen áll arra, hogy nagy méretű üzeneteket streameljen az Event Hubs segítségével.

Fontos

A nagyméretű üzenetstreamelést csak a legújabb infrastruktúrából létrehozott, önkiszolgáló, skálázható dedikált fürtök támogatják. Ezt a képességet a Supportslargemessages kulcs tükrözi.

Ha egy fürt értéke hamis, az nem támogatja a nagy méretű üzenetstreamelést. A szolgáltatás engedélyezéséhez újra létre kell hoznia a fürtöt.

Nagyméretű üzenetek streamelése az Event Hubs használatával

Az Event Hubs lehetővé teszi a nagy méretű üzenetek streamelását akár 20 MB-ig kötegekben és önálló kiadványokban is. A nagy üzenetek vagy események streameléséhez nem szükséges az ügyfélkód módosítása az üzenetben vagy az eseményben bekövetkezett változáson kívül. Továbbra is küldhet vagy fogadhat üzeneteket a meglévő Event Hubs SDK vagy Kafka API használatával, hogy nagy méretű üzeneteket streameljen az Event Hubsba. Így a nagyméretű üzeneteket ugyanúgy streamelheti az Event Hubsba, mint az 1 MB-nál kisebb méretű üzenetek esetében.

További információ: Események küldése és fogadása az Event Hubsból a .NET használatával.

Tipp.

Mindenképpen tekintse át az Event Hubs Advanced Message Queuing Protocol (AMQP) ügyfél- vagy Kafka-ügyfélkonfigurációját, amely korlátozhatja az Event Hubsba streamelt üzenetek maximális méretét. A nagy méretű üzenetek streameléséhez frissítenie kell az ügyfél időtúllépését egy magasabb értékre.

Alapértelmezés szerint az AMQP-ügyfél előletöltési száma 300. Csökkentse ezt az értéket, hogy elkerülje az ügyféloldali memóriaproblémákat nagy üzenetek kezelésekor.

A teljes .NET-kódtár-referenciát az SDK dokumentációjában találja.