EventProcessorClientOptions.PrefetchSizeInBytes 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 desejado de bytes para tentar solicitar ansiosamente do serviço hubs de eventos e enfileirado 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 long? PrefetchSizeInBytes { get; set; }

member this.PrefetchSizeInBytes : Nullable<int64> with get, set

Public Property PrefetchSizeInBytes As Nullable(Of Long)

Valor da propriedade

Nullable<Int64>

Quando definido nullcomo , a opção é considerada desabilitada; caso contrário, ela será considerada habilitada e terá precedência sobre qualquer valor especificado para o PrefetchCountO PrefetchSizeInBytes é um controle avançado que os desenvolvedores podem usar para ajudar a ajustar o desempenho em alguns cenários; é recomendável preferir usar o PrefetchCount em vez dessa opção, sempre que possível, para um controle mais preciso e uma taxa de transferência mais previsível.

Esse tamanho deve ser considerado uma instrução de intenção em vez de um limite garantido; o cache local pode ser maior ou menor do que o número de bytes especificado e sempre conterá pelo menos um evento quando o PrefetchSizeInBytes for especificado. Uma heurística é usada para prever o tamanho médio do evento a ser usado para cálculos de tamanho, que devem flutuar à medida que o tráfego passa pelo sistema. Consequentemente, o uso de recursos resultante também flutuará.

Essa opção é desabilitada por padrão com o valor definido nullcomo .

Exceções

ArgumentOutOfRangeException

Ocorre quando o tamanho solicitado é negativo.