EventProcessorClientOptions.PrefetchCount 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’événements qui seront vivement demandés au service Event Hubs et mis en file d’attente localement, sans tenir compte de l’activité d’une opération de lecture, destinée à optimiser le débit en permettant aux événements d’être lus à partir d’un cache local plutôt que d’attendre une demande de service.

public int PrefetchCount { get; set; }

member this.PrefetchCount : int with get, set

Public Property PrefetchCount As Integer

Valeur de propriété

Int32

Il PrefetchCount s’agit d’un contrôle que les développeurs peuvent utiliser pour optimiser les performances en fonction des besoins spécifiques d’une application, compte tenu de la taille attendue des événements, des besoins en débit et des scénarios attendus pour l’utilisation d’Event Hubs.

Le nombre de prérécupérations par défaut est de 300.

Exceptions

ArgumentOutOfRangeException

Se produit lorsque le nombre demandé est négatif.

Remarques

La taille du nombre de préfetchs a une influence sur l’efficacité de la lecture des événements à partir du service Event Hubs. Plus la taille du cache est grande, plus les opérations de service peuvent être mises en mémoire tampon en arrière-plan pour améliorer le débit. Cela se fait au prix d’une utilisation supplémentaire de la mémoire et d’une augmentation potentielle des E/S réseau.

Pour les scénarios où la taille des événements est petite et où de nombreux événements transitent par le système, l’utilisation d’un plus grand CacheEventCount et PrefetchCount peut aider à améliorer le débit. Pour les scénarios où la taille des événements est supérieure ou lorsque le traitement des événements est censé être une opération plus lourde et plus lente, l’utilisation d’une taille CacheEventCount plus petite et PrefetchCount peut aider à gérer l’utilisation des ressources sans entraîner un coût non négligeable pour le débit.

Quelles que soient les valeurs, il est généralement recommandé que le PrefetchCount soit au moins 2 à 3 fois plus grand que le pour permettre une CacheEventCount mise en mémoire tampon efficace des opérations de service.