Partager via

ReadEventOptions.PrefetchCount Propriété

  • Référence

Définition

Espace de noms:
Azure.Messaging.EventHubs.Consumer
Assembly:
Azure.Messaging.EventHubs.dll
Paquet:
Azure.Messaging.EventHubs v5.11.3
Paquet:
Azure.Messaging.EventHubs v5.12.0-beta.1
Source:
ReadEventOptions.cs
Source:
ReadEventOptions.cs

Nombre d’événements qui seront vivement demandés au 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 permettant la lecture des événements à 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

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

Exceptions

ArgumentOutOfRangeException

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

Remarques

La taille du nombre de prérécupérations 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.

S’applique à