EventProcessorOptions.PrefetchCount Propiedad

Definición

Espacio de nombres:

Azure.Messaging.EventHubs.Primitives

Ensamblado:

Azure.Messaging.EventHubs.dll

Paquete:

Azure.Messaging.EventHubs v5.11.3

Source:

EventProcessorOptions.cs

El número de eventos que se solicitarán diligentemente desde el servicio Event Hubs y se pondrá en cola localmente sin tener en cuenta si una operación de lectura está activa actualmente, destinada a 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.

El recuento de capturas previas predeterminado es 300.

Excepciones

ArgumentOutOfRangeException

Se produce cuando el recuento solicitado es negativo.

Comentarios

El tamaño del recuento de capturas previas 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, solicitar más eventos en un lote y usar un mayor 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, solicitar menos eventos en un lote y usar un menor PrefetchCount puede ayudar a administrar el uso de recursos sin incurrir en un costo no trivial para el rendimiento.

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