EventHubOptions.PrefetchCount プロパティ

定義

名前空間:

Microsoft.Azure.WebJobs.EventHubs

アセンブリ:

Microsoft.Azure.WebJobs.Extensions.EventHubs.dll

パッケージ:

Microsoft.Azure.WebJobs.Extensions.EventHubs v6.3.3

ソース:

EventHubOptions.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 。