ReadEventOptions.CacheEventCount Propiedad

Definición

Espacio de nombres:

Azure.Messaging.EventHubs.Consumer

Ensamblado:

Azure.Messaging.EventHubs.dll

Paquete:

Azure.Messaging.EventHubs v5.11.3

Source:

ReadEventOptions.cs

El número máximo de eventos que se leerán desde el servicio Event Hubs y se mantendrán en una caché de memoria local cuando la lectura está activa y los eventos se emiten a un enumerador para su procesamiento.

public int CacheEventCount { get; set; }

member this.CacheEventCount : int with get, set

Public Property CacheEventCount As Integer

Valor de propiedad

Int32

CacheEventCount es un control que los desarrolladores pueden usar para ayudar a optimizar el rendimiento de las necesidades específicas de una aplicación, dado su tamaño esperado de eventos, necesidades de rendimiento y escenarios esperados para usar Event Hubs.

Excepciones

ArgumentOutOfRangeException

Se produce cuando el recuento solicitado es menor que 1.

Comentarios

El tamaño de esta memoria caché influye en la eficacia de la lectura de eventos del servicio Event Hubs. Cuanto mayor sea el tamaño de la memoria caché, las operaciones de servicio de forma más eficaz se pueden almacenar en búfer en segundo plano para mejorar el rendimiento. Esto conlleva un uso adicional de memoria y aumenta potencialmente la E/S de red.

En escenarios en los que el tamaño de los eventos es pequeño y muchos eventos fluyen a través del sistema, el uso de un mayor CacheEventCount y PrefetchCount puede ayudar a mejorar el rendimiento. En escenarios en los que el tamaño de los eventos es mayor o cuando se espera que el procesamiento de eventos sea una operación más pesada y más lenta, el uso de un tamaño CacheEventCount menor y PrefetchCount puede ayudar a administrar el uso de recursos sin incurrir en un costo no trivial para el rendimiento.

Independientemente de los valores, se recomienda generalmente que sea PrefetchCount al menos de 2 a 3 veces mayor que para permitir un CacheEventCount almacenamiento en búfer eficaz de las operaciones de servicio.