EventHubOptions.PrefetchCount Propriedade

Definição

Namespace:

Microsoft.Azure.WebJobs.EventHubs

Assembly:

Microsoft.Azure.WebJobs.Extensions.EventHubs.dll

Pacote:

Microsoft.Azure.WebJobs.Extensions.EventHubs v6.3.3

Origem:

EventHubOptions.cs

O número de eventos que serão solicitados ansiosamente do serviço 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 o tamanho esperado de eventos, as necessidades de taxa de transferência e os cenários esperados para usar os 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, 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, solicitar mais eventos em um lote e usar um maior 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, solicitar menos eventos em um lote e usar um menor 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 número de eventos em um lote para permitir o buffer eficiente de operações de serviço.