EventProcessorOptions.PrefetchCount Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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, setPublic Property PrefetchCount As IntegerEigenschaftswert
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.
Die Standardmäßige Anzahl von Prefetchs ist 300.
Ausnahmen
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.
In Szenarien, in denen die Größe von Ereignissen klein ist und viele Ereignisse über das System fließen, kann das Anfordern von mehr Ereignissen in einem Batch und die Verwendung eines höheren PrefetchCount zur Verbesserung des Durchsatzes beitragen. 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, kann das Anfordern weniger Ereignisse in einem Batch und die Verwendung eines kleineren PrefetchCount zur Verwaltung der Ressourcennutzung beitragen, 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 die Anzahl der Ereignisse in einem Batch zu sein, um eine effiziente Pufferung von Dienstvorgängen zu ermöglichen.
Gilt für:
Azure SDK for .NET