ReadEventOptions.CacheEventCount Propriedade

Definição

Namespace:

Azure.Messaging.EventHubs.Consumer

Assembly:

Azure.Messaging.EventHubs.dll

Pacote:

Azure.Messaging.EventHubs v5.11.3

Origem:

ReadEventOptions.cs

O número máximo de eventos que serão lidos do serviço hubs de eventos e mantidos em um cache de memória local quando a leitura estiver ativa e os eventos estiverem sendo emitidos para um enumerador para processamento.

public int CacheEventCount { get; set; }

member this.CacheEventCount : int with get, set

Public Property CacheEventCount As Integer

Valor da propriedade

Int32

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

Exceções

ArgumentOutOfRangeException

Ocorre quando a contagem solicitada é menor que 1.

Comentários

O tamanho desse cache tem uma influência na eficiência da leitura de eventos do serviço de Hubs de Eventos. Quanto maior o tamanho do cache, mais eficientes as operações de serviço 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 de 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 um buffer eficiente de operações de serviço.