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

Número de eventos que se solicitarán diligentemente desde el servicio Event Hubs y que se ponen en cola localmente sin tener en cuenta si una operación de lectura está activa actualmente, diseñada para ayudar a maximizar el rendimiento al permitir que los eventos se lean desde una caché local en lugar de esperar a una solicitud de servicio.

public int PrefetchCount { get; set; }

member this.PrefetchCount : int with get, set

Public Property PrefetchCount As Integer

Valor de propiedad

Int32

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

Comentarios

El tamaño del recuento de captura previa 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 el uso de memoria adicional y puede aumentar 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, con un mayor CacheEventCount tamaño y PrefetchCount pueden 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 PrefetchCount sea al menos 2-3 veces tan grande como para CacheEventCount permitir un almacenamiento en búfer eficaz de las operaciones de servicio.