EventProcessorClientOptions.PrefetchSizeInBytes Propriété

Définition

Espace de noms:

Azure.Messaging.EventHubs

Assembly:

Azure.Messaging.EventHubs.Processor.dll

Paquet:

Azure.Messaging.EventHubs.Processor v5.11.3

Source:

EventProcessorClientOptions.cs

Nombre d’octets souhaité pour tenter d’effectuer une demande à partir du service Event Hubs et mis en file d’attente localement, sans tenir compte du fait qu’une opération de lecture est actuellement active, afin d’optimiser le débit en autorisant la lecture des événements à partir d’un cache local plutôt que d’attendre une demande de service.

public long? PrefetchSizeInBytes { get; set; }

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

Public Property PrefetchSizeInBytes As Nullable(Of Long)

Valeur de propriété

Nullable<Int64>

Lorsqu’elle est définie sur null, l’option est considérée comme désactivée ; sinon, elle est considérée comme activée et prioritaire sur toute valeur spécifiée pour le PrefetchCountest PrefetchSizeInBytes un contrôle avancé que les développeurs peuvent utiliser pour optimiser les performances dans certains scénarios ; il est recommandé d’utiliser le PrefetchCount plutôt que cette option si possible pour un contrôle plus précis et un débit plus prévisible.

Cette taille doit être considérée comme une déclaration d’intention plutôt qu’une limite garantie; le cache local peut être plus grand ou inférieur au nombre d’octets spécifié, et contient toujours au moins un événement lorsque le PrefetchSizeInBytes est spécifié. Une heuristique est utilisée pour prédire la taille moyenne de l’événement à utiliser pour les calculs de taille, qui devrait varier à mesure que le trafic transite par le système. Par conséquent, l’utilisation des ressources résultante fluctue également.

Cette option est désactivée par défaut avec la valeur définie sur null.

Exceptions

ArgumentOutOfRangeException

Se produit lorsque la taille demandée est négative.