ReadEventOptions.PrefetchCount Eigenschaft

Definition

Namespace:

Azure.Messaging.EventHubs.Consumer

Assembly:

Azure.Messaging.EventHubs.dll

Paket:

Azure.Messaging.EventHubs v5.11.3

Quelle:

ReadEventOptions.cs

Die Anzahl der Ereignisse, die eifrig vom Event Hubs-Dienst angefordert und lokal in die Warteschlange gestellt werden, unabhängig davon, ob ein Lesevorgang derzeit aktiv ist, soll dazu beitragen, den Durchsatz zu maximieren, indem Ereignisse aus einem lokalen Cache gelesen werden können, anstatt auf eine Dienstanforderung zu warten.

public int PrefetchCount { get; set; }

member this.PrefetchCount : int with get, set

Public Property PrefetchCount As Integer

Eigenschaftswert

Int32

Das PrefetchCount 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 negativ ist.

Hinweise

Die Größe der Prefetchanzahl 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.