EventHubClient.CreateEpochReceiver メソッド

定義

名前空間:

Microsoft.Azure.EventHubs

アセンブリ:

Microsoft.Azure.EventHubs.dll

パッケージ:

Microsoft.Azure.EventHubs v4.3.2

ソース:

EventHubClient.cs

指定 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

作成された PartitionReceiver

こちらもご覧ください

• PartitionReceiver