EventProcessorClientOptions.CacheEventCount Eigenschaft

Definition

Namespace:

Azure.Messaging.EventHubs

Assembly:

Azure.Messaging.EventHubs.Processor.dll

Paket:

Azure.Messaging.EventHubs.Processor v5.11.3

Quelle:

EventProcessorClientOptions.cs

Die maximale Anzahl von Ereignissen, die aus dem Event Hubs-Dienst gelesen und in einem lokalen Speichercache gespeichert werden, wenn das Lesen aktiv ist und Ereignisse zur Verarbeitung an einen Enumerator ausgegeben werden.

public int CacheEventCount { get; set; }

member this.CacheEventCount : int with get, set

Public Property CacheEventCount As Integer

Eigenschaftswert

Int32

Ist CacheEventCount ein Steuerelement, das Entwickler verwenden können, um die Leistung auf die spezifischen Anforderungen einer Anwendung zu optimieren, da die Erwartete Größe von Ereignissen, Durchsatzanforderungen und erwarteten Szenarien für die Verwendung von Event Hubs erfüllt ist.

Die Standardanzahl des Caches ist 100.

Ausnahmen

ArgumentOutOfRangeException

Tritt auf, wenn die angeforderte Anzahl kleiner als 1 ist.

Hinweise

Die Größe dieses Caches wirkt sich auf die Effizienz des Lesens von Ereignissen aus dem Event Hubs-Dienst aus. Je größer der Cache ist, desto effizienter können Dienstvorgänge im Hintergrund gepuffert werden, um den Durchsatz zu verbessern. Dies geht zu Lasten einer zusätzlichen Speicherauslastung und erhöht möglicherweise die Netzwerk-E/A.

Für Szenarien, in denen die Größe von Ereignissen klein ist und viele Ereignisse durch das System fließen, verwenden Sie eine größere CacheEventCount und PrefetchCount kann dazu beitragen, den Durchsatz zu verbessern. In Szenarien, in denen die Größe von Ereignissen größer ist oder wenn erwartet wird, dass die Verarbeitung von Ereignissen ein schwererer und langsamerer Vorgang ist, verwenden Sie eine kleinere Größe CacheEventCount und PrefetchCount können dazu beitragen, die Ressourcennutzung zu verwalten, ohne dass nicht triviale Kosten für den Durchsatz anfallen.

Unabhängig von den Werten wird im Allgemeinen empfohlen, mindestens PrefetchCount 2-3 Mal so groß wie die zu sein, CacheEventCount um eine effiziente Pufferung von Dienstvorgängen zu ermöglichen.