你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

快速入门：使用 Azure 事件中心发送和接收大型消息（预览版）

在本快速入门中，你将了解如何使用 Azure 事件中心发送和接收大型消息（大小上限为 20 MB）。 如果不熟悉 Azure 事件中心，请在阅读本快速入门之前先参阅事件中心概述。

先决条件

若要完成本快速入门，需要具备以下先决条件：

• 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 文档。