EventProcessorClientOptions.PrefetchSizeInBytes プロパティ

定義

名前空間:

Azure.Messaging.EventHubs

アセンブリ:

Azure.Messaging.EventHubs.Processor.dll

パッケージ:

Azure.Messaging.EventHubs.Processor v5.11.3

ソース:

EventProcessorClientOptions.cs

Event Hubs サービスからの一括要求を試行し、読み取り操作が現在アクティブかどうかに関係なくローカルにキューに入れる必要があるバイト数。これは、サービス要求を待機するのではなく、ローカル キャッシュからイベントを読み取れるようにすることでスループットを最大化することを目的としています。

public long? PrefetchSizeInBytes { get; set; }

member this.PrefetchSizeInBytes : Nullable<int64> with get, set

Public Property PrefetchSizeInBytes As Nullable(Of Long)

プロパティ値

Nullable<Int64>

にnull設定すると、オプションは無効と見なされます。それ以外の場合は、有効と見なされ、 にPrefetchSizeInBytes指定されたPrefetchCount値よりも優先されます。これは、開発者が一部のシナリオでパフォーマンスを調整するために使用できる高度なコントロールです。より正確な制御と予測可能なスループットを得るには、このオプションよりも を使用PrefetchCountすることをお勧めします。

このサイズは、保証された制限ではなく意図のステートメントと見なす必要があります。ローカル キャッシュは、指定されたバイト数より大きいか小さい場合があり、 が指定されている場合は常に少なくとも 1 つのイベントが PrefetchSizeInBytes 含まれます。 ヒューリスティックは、サイズの計算に使用する平均イベント サイズを予測するために使用されます。これは、トラフィックがシステムを通過する際に変動することが予想されます。 その結果、結果として得られるリソースの使用も変動します。

このオプションは既定で無効になっており、値は に null設定されています。

例外

ArgumentOutOfRangeException

要求されたサイズが負の場合に発生します。