EventProcessorClientOptions.CacheEventCount 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 maximal d’événements qui seront lus à partir du service Event Hubs et conservés dans un cache de mémoire local lorsque la lecture est active et que les événements sont émis vers un énumérateur pour traitement.

public int CacheEventCount { get; set; }

member this.CacheEventCount : int with get, set

Public Property CacheEventCount As Integer

Valeur de propriété

Int32

Est CacheEventCount un contrôle que les développeurs peuvent utiliser pour aider à ajuster 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 caches par défaut est 100.

Exceptions

ArgumentOutOfRangeException

Se produit lorsque le nombre demandé est inférieur à 1.

Remarques

La taille de ce cache 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 augmente potentiellement les E/S réseau.

Pour les scénarios où la taille des événements est faible 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 plus importante 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 peut PrefetchCount aider à gérer l’utilisation des ressources sans entraîner un coût non négligeable au 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 CacheEventCount pour permettre une mise en mémoire tampon efficace des opérations de service.