ReadEventOptions.CacheEventCount プロパティ

定義

名前空間:

Azure.Messaging.EventHubs.Consumer

アセンブリ:

Azure.Messaging.EventHubs.dll

パッケージ:

Azure.Messaging.EventHubs v5.11.3

ソース:

ReadEventOptions.cs

読み取りがアクティブで、イベントが処理のために列挙子に出力されている場合に、Event Hubs サービスから読み取られ、ローカル メモリ キャッシュに保持されるイベントの最大数。

public int CacheEventCount { get; set; }

member this.CacheEventCount : int with get, set

Public Property CacheEventCount As Integer

プロパティ値

Int32

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

例外

ArgumentOutOfRangeException

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

注釈

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

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

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