EventHubOptions.PrefetchSizeInBytes Eigenschaft

Definition

Namespace:

Microsoft.Azure.WebJobs.EventHubs

Assembly:

Microsoft.Azure.WebJobs.Extensions.EventHubs.dll

Paket:

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

Quelle:

EventHubOptions.cs

Die gewünschte Anzahl von Bytes, die versucht werden soll, eifrig vom Event Hubs-Dienst anzufordern und lokal in die Warteschlange zu stellen, ohne zu berücksichtigen, 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 long? PrefetchSizeInBytes { get; set; }

member this.PrefetchSizeInBytes : Nullable<int64> with get, set

Public Property PrefetchSizeInBytes As Nullable(Of Long)

Eigenschaftswert

Nullable<Int64>

Wenn sie auf nullfestgelegt ist, gilt die Option als deaktiviert. Andernfalls wird sie als aktiviert betrachtet und hat Vorrang vor jedem wert, der PrefetchCountfür Die PrefetchSizeInBytes angegeben ist, ist ein erweitertes Steuerelement, das Entwickler verwenden können, um die Leistung in einigen Szenarien zu optimieren. Es wird empfohlen, die PrefetchCount Option nach Möglichkeit für eine genauere Steuerung und einen besser vorhersagbaren Durchsatz zu verwenden.

Diese Größe sollte nicht als garantierte Grenze, sondern als Absichtserklärung angesehen werden. Der lokale Cache kann größer oder kleiner als die angegebene Anzahl von Bytes sein und immer mindestens ein Ereignis enthalten, wenn angegeben PrefetchSizeInBytes wird. Eine Heuristik wird verwendet, um die durchschnittliche Ereignisgröße vorherzusagen, die für Größenberechnungen verwendet werden soll, die voraussichtlich schwanken, wenn der Datenverkehr das System durchläuft. Folglich schwankt auch die daraus resultierende Ressourcennutzung.

Diese Option ist standardmäßig deaktiviert, wobei der Wert auf nullfestgelegt ist.

Ausnahmen

ArgumentOutOfRangeException

Tritt auf, wenn die angeforderte Größe negativ ist.