用途:这是 Azure 事件中心(Event Hubs)的 .NET 事件流 SDK,面向高吞吐的事件发送与接收。
主要能力与客户端类型:EventHubProducerClient 用于即时批量发送,可自行控制批处理;EventHubBufferedProducerClient 支持后台自动批处理发送,适合高并发、发后不管场景;EventHubConsumerClient 仅适合简单读取与原型验证,不用于生产;EventProcessorClient 是生产环境接收的推荐客户端,配合检查点。
安装:dotnet add package Azure.Messaging.EventHubs;dotnet add package Azure.Messaging.EventHubs.Processor;dotnet add package Azure.Identity;检查点还需 dotnet add package Azure.Storage.Blobs。当前版本为 Azure.Messaging.EventHubs v5.12.2、Processor v5.12.2。
配置与认证:通过环境变量提供 EVENTHUB_FULLY_QUALIFIED_NAMESPACE、EVENTHUB_NAME,检查点需 BLOB_STORAGE_CONNECTION_STRING、BLOB_CONTAINER_NAME,也支持 EVENTHUB_CONNECTION_STRING(生产不推荐)。生产建议使用 DefaultAzureCredential,并授予相应 RBAC:发送用 Azure Event Hubs Data Sender,接收用 Azure Event Hubs Data Receiver,二者兼用 Data Owner。
用法要点:发送时用 CreateBatchAsync 创建批次,循环 TryAdd,批次满则 SendAsync 并重建批次,最后发送剩余事件;缓冲生产者可设置 MaximumWaitTime,通过 SendEventBatchSucceededAsync 与 SendEventBatchFailedAsync 处理回调,并用 FlushAsync 冲刷。接收时创建 BlobContainerClient 作为检查点存储,再构建 EventProcessorClient,消费组使用 EventHubConsumerClient.DefaultConsumerGroup。
限制:资料未提供定价、配额、重试与错误处理等其他细节。