次の方法で共有


EventHubClient.CreateEpochReceiver メソッド

定義

指定 EventPositionした を使用してエポック ベースの EventHub レシーバーを作成します。 レシーバーは、特定のコンシューマー グループから特定の EventHub パーティションに対して作成されます。

エポック ベースのレシーバーを作成するときは、次の点に注意することが重要です。

- 所有権の適用: エポック ベースのレシーバーを作成したら、コンボのすべてのレシーバーが閉じられるまで、同じ consumerGroup-Partition コンボに非エポック レシーバーを作成することはできません。

- 所有権の盗難: consumerGroup-Partition コンボに対して、より高いエポック値を持つレシーバーが作成されると、そのコンボに対する古いエポック レシーバーはすべて強制的に閉じられます。

- consumerGroup-Partition コンボの所有権が失われたために閉じられたレシーバーは、そのレシーバーからのすべての操作に対して ReceiverDisconnectedException を取得します。
public Microsoft.Azure.EventHubs.PartitionReceiver CreateEpochReceiver (string consumerGroupName, string partitionId, Microsoft.Azure.EventHubs.EventPosition eventPosition, long epoch, Microsoft.Azure.EventHubs.ReceiverOptions receiverOptions = default);
member this.CreateEpochReceiver : string * string * Microsoft.Azure.EventHubs.EventPosition * int64 * Microsoft.Azure.EventHubs.ReceiverOptions -> Microsoft.Azure.EventHubs.PartitionReceiver
Public Function CreateEpochReceiver (consumerGroupName As String, partitionId As String, eventPosition As EventPosition, epoch As Long, Optional receiverOptions As ReceiverOptions = Nothing) As PartitionReceiver

パラメーター

consumerGroupName
String

このレシーバーをグループ化する必要があるコンシューマー グループ名。

partitionId
String

受信側が属するパーティション ID。 受信したすべてのデータは、このパーティションからのみ取得されます。

eventPosition
EventPosition

メッセージの受信を EventPosition 開始する開始位置の 。

epoch
Int64

サービスがパーティション/リース所有権を適用するために使用する一意識別子 (エポック値)。

receiverOptions
ReceiverOptions

イベント ハブ レシーバーのオプション。

戻り値

作成された PartitionReceiver

適用対象

こちらもご覧ください