ReadEventOptions.CacheEventCount Eigenschaft

Definition

Namespace:

Azure.Messaging.EventHubs.Consumer

Assembly:

Azure.Messaging.EventHubs.dll

Paket:

Azure.Messaging.EventHubs v5.11.3

Quelle:

ReadEventOptions.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

Das CacheEventCount ist 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.

Ausnahmen

ArgumentOutOfRangeException

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

Hinweise

Die Größe dieses Caches hat einen Einfluss auf die Effizienz des Lesens von Ereignissen aus dem Event Hubs-Dienst. Je größer der Cache ist, desto effizienter können Dienstvorgänge im Hintergrund gepuffert werden, um den Durchsatz zu verbessern. Dies geht auf Kosten der zusätzlichen Arbeitsspeichernutzung und kann die Netzwerk-E/A erhöhen.

Für Szenarien, in denen die Größe von Ereignissen klein ist und viele Ereignisse über das System fließen, verwenden sie ein größeres CacheEventCount und PrefetchCount können den Durchsatz verbessern. Für 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 sein wird, wobei eine kleinere Größe CacheEventCount verwendet wird und PrefetchCount die Ressourcennutzung verwaltet werden kann, ohne dass nicht triviale Kosten für den Durchsatz anfallen.

Unabhängig von den Werten wird allgemein empfohlen, mindestens PrefetchCount 2-3 mal so groß wie der zu sein, CacheEventCount um ein effizientes Puffern von Dienstvorgängen zu ermöglichen.