EventProcessorClientOptions.PrefetchCount Propriedade

Definição

Namespace:

Azure.Messaging.EventHubs

Assembly:

Azure.Messaging.EventHubs.Processor.dll

Pacote:

Azure.Messaging.EventHubs.Processor v5.11.3

Origem:

EventProcessorClientOptions.cs

O número de eventos que serão solicitados ansiosamente do serviço de Hubs de Eventos e enfileirados localmente sem considerar se uma operação de leitura está ativa no momento, destinada a ajudar a maximizar a taxa de transferência, permitindo que os eventos sejam lidos de um cache local em vez de aguardar uma solicitação de serviço.

public int PrefetchCount { get; set; }

member this.PrefetchCount : int with get, set

Public Property PrefetchCount As Integer

Valor da propriedade

Int32

O PrefetchCount é um controle que os desenvolvedores podem usar para ajudar a ajustar o desempenho para as necessidades específicas de um aplicativo, dado seu tamanho esperado de eventos, necessidades de taxa de transferência e cenários esperados para o uso de Hubs de Eventos.

A contagem de pré-busca padrão é 300.

Exceções

ArgumentOutOfRangeException

Ocorre quando a contagem solicitada é negativa.

Comentários

O tamanho da contagem de pré-busca tem uma influência na eficiência da leitura de eventos do serviço hubs de eventos. Quanto maior o tamanho do cache, as operações de serviço com mais eficiência podem ser armazenadas em buffer em segundo plano para melhorar a taxa de transferência. Isso tem o custo de uso adicional de memória e potencialmente aumenta a E/S da rede.

Para cenários em que o tamanho dos eventos é pequeno e muitos eventos estão fluindo pelo sistema, usar um maior CacheEventCount e PrefetchCount pode ajudar a melhorar a taxa de transferência. Para cenários em que o tamanho dos eventos é maior ou quando se espera que o processamento de eventos seja uma operação mais pesada e mais lenta, usar um tamanho CacheEventCount menor e PrefetchCount pode ajudar a gerenciar o uso de recursos sem incorrer em um custo não trivial para a taxa de transferência.

Independentemente dos valores, geralmente é recomendável que o PrefetchCount seja pelo menos 2 a 3 vezes maior que o CacheEventCount para permitir o buffer eficiente de operações de serviço.