PartitionReceiverOptions.PrefetchSizeInBytes プロパティ

  • リファレンス

定義

名前空間:
Azure.Messaging.EventHubs.Primitives
アセンブリ:
Azure.Messaging.EventHubs.dll
パッケージ:
Azure.Messaging.EventHubs v5.11.3
パッケージ:
Azure.Messaging.EventHubs v5.12.0-beta.1
ソース:
PartitionReceiverOptions.cs
ソース:
PartitionReceiverOptions.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設定すると、オプションは無効と見なされます。それ以外の場合は、有効と見なされ、 に指定された PrefetchCount値よりも優先されます。これは PrefetchSizeInBytes 、開発者が一部のシナリオでパフォーマンスを調整するために使用できる高度なコントロールです。より正確な制御と予測可能なスループットを得るために、このオプションよりも を使用 PrefetchCount することをお勧めします。

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

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

例外

ArgumentOutOfRangeException

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

適用対象