Partager via


ReadEventOptions.CacheEventCount Propriété

Définition

Nombre maximal d’événements qui seront lus à partir du service Event Hubs et conservés dans un cache de mémoire locale lorsque la lecture est active et que des é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é

Il CacheEventCount 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.

Exceptions

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 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.

S’applique à