EventProcessorOptions.PrefetchCount プロパティ

定義

名前空間:

Azure.Messaging.EventHubs.Primitives

アセンブリ:

Azure.Messaging.EventHubs.dll

パッケージ:

Azure.Messaging.EventHubs v5.11.3

ソース:

EventProcessorOptions.cs

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

public int PrefetchCount { get; set; }

member this.PrefetchCount : int with get, set

Public Property PrefetchCount As Integer

プロパティ値

Int32

PrefetchCountは、イベントのサイズ、スループットのニーズ、および Event Hubs を使用するための想定されるシナリオを考えると、開発者がアプリケーションの特定のニーズに合わせてパフォーマンスを調整するために使用できるコントロールです。

既定のプリフェッチ数は 300 です。

例外

ArgumentOutOfRangeException

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

注釈

プリフェッチ数のサイズは、Event Hubs サービスからイベントを読み取る効率に影響します。 キャッシュのサイズが大きいほど、スループットを向上させるために、バックグラウンドでより効率的なサービス操作をバッファーに格納できます。 これは、追加のメモリ使用量のコストがかかるので、ネットワーク I/O が増加する可能性があります。

イベントのサイズが小さく、多くのイベントがシステム内を流れるシナリオでは、バッチ内でより多くのイベントを要求し、より高い PrefetchCount を使用するとスループットが向上する可能性があります。 イベントのサイズが大きいシナリオや、イベントの処理がより重く、低速な操作であると予想されるシナリオでは、バッチ内の要求イベントの数を減らし、小さい PrefetchCount 方を使用すると、スループットに対して簡単ではないコストを発生させずにリソースの使用を管理するのに役立つ場合があります。

値に関係なく、通常は、サービス操作の効率的なバッファリングを可能にするために、バッチ内のイベントの数の少なくとも 2 ~ 3 倍の大きさにすることをお勧めします PrefetchCount 。