次の方法で共有


Azure.Messaging.EventHubs.Producer 名前空間

クラス

CreateBatchOptions

イベント バッチの動作と Event Hubs サービスへの送信方法に影響を与えるために指定できるオプションのセット。

EnqueueEventOptions

イベントを Event Hubs サービスに発行する方法に影響を与えるために指定できるオプションのセット。

EventDataBatch

1 回の EventData 操作で Event Hubs サービスに送信することを目的とした、事前に既知のサイズ制約を持つ のセット。 発行されると、結果はアトミックになります。バッチに属するすべてのイベントが成功したか、すべて失敗したかのいずれかです。 部分的な成功は不可能です。

EventHubBufferedProducerClient

のインスタンスを特定の EventData イベント ハブに発行するクライアント。 イベントがエンキューされるときに指定されたオプションによっては、自動的にパーティションに割り当てられるか、指定されたパーティション キーに従ってグループ化されるか、または特定の要求されたパーティションが割り当てられる場合があります。

EventHubBufferedProducerClient 、イベントがバッファーに収集される遅延モデルを使用する代わりに、すぐに発行されません。これにより、バッチがいっぱいになった場合や MaximumWaitTime 、 が新しいイベントがエンキューされずに経過したときに効率的にバッチ処理および発行される可能性があります。

このモデルは、イベントが発行されるタイミングに関して、非決定論的なタイミングを犠牲にして、バッチ管理の負担を呼び出し元からシフトすることを目的としています。 考慮すべきその他のトレードオフもあります。

  • アプリケーションがクラッシュした場合、バッファー内のイベントは発行されません。 データ損失を防ぐために、呼び出し元は と SendEventBatchFailedAsync ハンドラーを使用して発行の進行状況をSendEventBatchSucceededAsync追跡することをお勧めします。
  • パーティション キーを指定するイベントには、他のプロデューサーと同じキーを使用するイベントとは異なるパーティションが割り当てられる場合があります。
  • 万一、パーティションが一時的に使用できなくなった場合、 は他の EventHubBufferedProducerClient プロデューサーよりも復旧に時間がかかる場合があります。

決定論的な結果でイベントをすぐに公開することが重要なシナリオでは、パーティション キーが他のパブリッシャーと一致するパーティションに割り当てられているか、可用性の最大化が要件である場合は、 を EventHubProducerClient 使用することをお勧めします。

EventHubBufferedProducerClientOptions

動作を構成する を作成 EventHubBufferedProducerClient するときに指定できるオプションのセット。

EventHubProducerClient

バッチでグループ化された特定のイベント ハブへの発行 EventData を担当するクライアント。 送信時に指定されたオプションに応じて、イベントに使用可能なパーティションが自動的に割り当てられるか、特定のパーティションを要求する場合があります。

EventHubProducerClient 直ちに発行され、各送信操作の決定論的な結果が保証されますが、呼び出し元はバッチの構築と管理の責任を負う必要があります。

イベントをすぐに公開することが重要ではなく、パーティションの可用性を最大化することが要件ではないシナリオでは、 を使用 EventHubBufferedProducerClientすることを検討することをお勧めします。これは、アプリケーション コードでの複雑さを軽減するために、バッチの構築と管理を担当します。

EventHubProducerClientOptions

動作を構成する を作成 EventHubProducerClient するときに指定できるオプションのセット。

SendEventBatchFailedEventArgs

発行できなかったバッチに関する情報と、発生した例外と、バッチが発行されたパーティションに関する情報が含まれます。

SendEventBatchSucceededEventArgs

発行されたバッチと、それが発行されたパーティションに関する情報が含まれます。

SendEventOptions

イベントを Event Hubs サービスに発行する方法に影響を与えるために指定できるオプションのセット。