Szybki start: wysyłanie i odbieranie dużych komunikatów za pomocą usługi Azure Event Hubs (wersja zapoznawcza)

Z tego przewodnika Szybki start dowiesz się, jak wysyłać i odbierać duże komunikaty (do 20 MB) przy użyciu usługi Azure Event Hubs. Jeśli dopiero zaczynasz korzystać z usługi Event Hubs, zobacz Omówienie usługi Event Hubs przed rozpoczęciem pracy z tym przewodnikiem Szybki start.

Wymagania wstępne

Do wykonania kroków tego przewodnika Szybki start niezbędne jest spełnienie następujących wymagań wstępnych:

• Subskrypcja Azure. Do korzystania z usług platformy Azure, w tym usługi Event Hubs, potrzebna jest subskrypcja. Jeśli nie masz istniejącego konta platformy Azure, możesz utworzyć konto bezpłatnej wersji próbnej lub skorzystać z korzyści dla subskrybentów MSDN podczas tworzenia konta.
• Skalowalny dedykowany klaster, przestrzeń nazw centrów zdarzeń i centrum zdarzeń. Pierwszym krokiem spełniającym to wymaganie wstępne jest użycie witryny Azure Portal do utworzenia dedykowanego klastra i przestrzeni nazw w klastrze. Aby utworzyć centrum zdarzeń, zobacz Szybki start: tworzenie centrum zdarzeń przy użyciu witryny Azure Portal. Ten krok można pominąć, jeśli masz już skalowalny dedykowany klaster samoobsługowy.

Uwaga

Obsługa dużych komunikatów, obecnie w publicznej wersji zapoznawczej, jest dostępna wyłącznie w przypadku niektórych klastrów dedykowanych usługi Event Hubs. Przesyłanie strumieniowe dużych komunikatów w tych klastrach nie powoduje naliczania dodatkowych opłat.

Konfigurowanie dedykowanego klastra usługi Event Hubs

Aby przesyłać strumieniowo duże komunikaty, należy skonfigurować skalowalny dedykowany klaster skalowalny.

W witrynie Azure Portal przejdź do sekcji Ustawienia dedykowanego klastra. W obszarze Ustawienia wybierz kartę Limit przydziału.

• Sprawdź, czy wartość klucza supportslargemessages tylko do odczytu jest ustawiona na Truewartość .
• Klucz można zaktualizować eventhubmaxmessagesizeinbytes do odpowiedniej wartości w bajtach. Dopuszczalny zakres dla tej wartości to od 1 048 576 do 20 971 520 bajtów.

Po zapisaniu konfiguracji możesz przesyłać strumieniowo duże komunikaty za pomocą usługi Event Hubs.

Ważne

Przesyłanie strumieniowe dużych komunikatów jest obsługiwane tylko w przypadku skalowalnych dedykowanych klastrów utworzonych z najnowszej infrastruktury. Ta możliwość jest odzwierciedlana przez Supportslargemessages klucz.

Jeśli wartość klastra ma wartość false, nie będzie obsługiwać przesyłania strumieniowego dużych komunikatów. Aby włączyć tę funkcję, należy ponownie utworzyć klaster.

Przesyłanie strumieniowe dużych komunikatów za pomocą usługi Event Hubs

Usługa Event Hubs umożliwia przesyłanie strumieniowe dużych komunikatów do 20 MB, zarówno w partiach, jak i jako pojedyncze publikacje. Możliwość przesyłania strumieniowego dużych komunikatów lub zdarzeń nie wymaga zmian kodu klienta poza zmianą samego komunikatu lub zdarzenia. Możesz kontynuować wysyłanie lub odbieranie komunikatów przy użyciu dowolnego istniejącego zestawu SDK usługi Event Hubs lub interfejsu API platformy Kafka, aby przesyłać strumieniowo duże komunikaty do usługi Event Hubs. Dzięki temu można przesyłać strumieniowo duże komunikaty do usługi Event Hubs w taki sam sposób, jak w przypadku komunikatów o rozmiarach mniejszych niż 1 MB.

Aby uzyskać więcej informacji, zobacz Wysyłanie zdarzeń do usługi Event Hubs i odbieranie zdarzeń przy użyciu platformy .NET.

Napiwek

Upewnij się, że zapoznasz się z dowolnym klientem usługi Event Hubs Advanced Message Queuing Protocol (AMQP) lub konfiguracją klienta platformy Kafka, który może ograniczyć maksymalny rozmiar komunikatu przesyłanego strumieniowo do usługi Event Hubs. Należy zaktualizować limit czasu klienta do wyższej wartości, aby przesyłać strumieniowo duże komunikaty.

Domyślnie liczba wstępnego pobierania klienta amQP wynosi 300. Obniż tę wartość, aby uniknąć problemów z pamięcią po stronie klienta w przypadku obsługi dużych komunikatów.

Aby uzyskać pełną dokumentację biblioteki platformy .NET, zobacz dokumentację zestawu SDK.