EventProcessorClientOptions.PrefetchCount プロパティ

定義

名前空間:

Azure.Messaging.EventHubs

アセンブリ:

Azure.Messaging.EventHubs.Processor.dll

パッケージ:

Azure.Messaging.EventHubs.Processor v5.11.2

ソース:

EventProcessorClientOptions.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 が増加する可能性があります。

イベントのサイズが小さく、多くのイベントがシステムを通過するシナリオでは、より大きな CacheEventCount を使用し PrefetchCount 、スループットの向上に役立つ場合があります。 イベントのサイズが大きいシナリオや、イベントの処理が重くて遅い操作になると予想されるシナリオでは、サイズCacheEventCountPrefetchCountを小さくして、スループットに対して簡単でないコストをかけずにリソースの使用を管理するのに役立ちます。

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