快速入門：使用 Azure 事件中樞 傳送和接收大型訊息 （預覽）

在本快速入門中，您將瞭解如何使用 Azure 事件中樞 來傳送和接收大型訊息（最多 20 MB）。 如果您不熟悉事件中樞，請參閱 事件中樞概觀 ，再進行本快速入門。

必要條件

若要完成本快速入門，您必須符合下列必要條件：

• Azure 訂用帳戶。 若要使用 Azure 服務，包括事件中樞，您需要訂用帳戶。 如果您沒有現有的 Azure 帳戶，您可以申請免費試用，或是在建立帳戶時使用 MSDN 訂閱者權益。
• 自助式可調整的專用叢集、事件中樞命名空間和事件中樞。 符合此必要條件的第一個步驟是使用 Azure 入口網站 在叢集內建立專用叢集和命名空間。 若要建立事件中樞，請參閱快速入門：使用 Azure 入口網站 建立事件中樞。 如果您已經有自助式可調整的專用叢集，則可以略過此步驟。

注意

目前處於公開預覽狀態的大型訊息支援，可供特定事件中樞自助專用叢集使用。 使用這些叢集串流大型訊息不會產生額外費用。

設定事件中樞專用叢集

若要串流大型訊息，您必須設定自助式可調整專用叢集。

在 Azure 入口網站 中，移至專用叢集的 [設定] 區段。 在 [設定] 底下，選取 [配額] 索引標籤。

• 驗證唯讀索引鍵 supportslargemessages 的值是否已設定為 True。
• 您可以將金鑰 eventhubmaxmessagesizeinbytes 更新為適當的位元元值。 這個值可接受的範圍介於 1,048,576 和 20,971,520 個字節之間。

儲存組態之後，您就可以使用事件中樞串流大型訊息。

重要

大型訊息串流僅支援由最新基礎結構所建置的自助式可調整專用叢集。 這項功能會由 Supportslargemessages 索引鍵反映。

如果叢集值為 false，則不支援大型訊息串流。 若要啟用此功能，您必須重新建立叢集。

使用事件中樞串流大型訊息

事件中樞允許以批次和個別發行集的形式串流處理最多 20 MB 的大型訊息。 除了訊息或事件本身的變更之外，串流大型訊息或事件的能力不需要變更任何客戶端程序代碼。 您可以使用任何現有的事件中樞 SDK 或 Kafka API 繼續傳送或接收訊息，將大型訊息串流至事件中樞。 如此一來，您可以將大型訊息串流至事件中樞，就像針對大小小於 1 MB 的訊息一樣。

如需詳細資訊，請參閱 使用 .NET 將事件傳送至事件中樞並從中接收事件。

提示

請務必檢閱任何事件中樞進階消息佇列通訊協定 （AMQP） 用戶端或 Kafka 用戶端設定，這些設定可能會限制您串流至事件中樞的訊息大小上限。 您必須將用戶端逾時更新為較高的值，才能串流大型訊息。

根據預設，AMQP 用戶端預先擷取計數為 300。 降低此值，以避免在處理大型訊息時發生用戶端記憶體問題。

如需完整的 .NET 連結庫參考，請參閱 SDK 檔。