Compartilhar via


Azure.Messaging.EventHubs.Producer Namespace

Classes

CreateBatchOptions

O conjunto de opções que pode ser especificado para influenciar a maneira como um lote de eventos se comporta e é enviado para o serviço hubs de eventos.

EnqueueEventOptions

O conjunto de opções que pode ser especificado para influenciar a maneira como os eventos são publicados no serviço hubs de eventos.

EventDataBatch

Um conjunto de EventData com restrições de tamanho conhecidas antecipadamente, destinado a ser enviado para o serviço hubs de eventos em uma única operação. Quando publicado, o resultado é atômico; todos os eventos que pertencem ao lote foram bem-sucedidos ou todos falharam. O sucesso parcial não é possível.

EventHubBufferedProducerClient

Um cliente responsável por publicar instâncias de em um Hub de EventData Eventos específico. Dependendo das opções especificadas quando os eventos são enfileirados, eles podem ser atribuídos automaticamente a uma partição, agrupados de acordo com a chave de partição especificada ou atribuídos a uma partição solicitada especificamente.

O EventHubBufferedProducerClient não publica imediatamente, em vez disso, usando um modelo adiado em que os eventos são coletados em um buffer para que possam ser colocados em lote e publicados com eficiência quando o lote estiver cheio ou o MaximumWaitTime tiver decorrido sem novos eventos enfileirados.

Esse modelo destina-se a deslocar a carga do gerenciamento em lote dos chamadores, ao custo do tempo não determinístico, para quando os eventos serão publicados. Também há compensações adicionais a serem consideradas:

  • Se o aplicativo falhar, os eventos no buffer não terão sido publicados. Para evitar a perda de dados, os chamadores são incentivados a acompanhar o progresso da publicação usando os SendEventBatchSucceededAsync manipuladores e SendEventBatchFailedAsync .
  • Os eventos que especificam uma chave de partição podem receber uma partição diferente daquelas que usam a mesma chave com outros produtores.
  • No caso improvável de uma partição ficar temporariamente indisponível, o EventHubBufferedProducerClient pode levar mais tempo para ser recuperado do que outros produtores.

Em cenários em que é importante ter eventos publicados imediatamente com um resultado determinístico, verifique se as chaves de partição são atribuídas a uma partição consistente com outros editores ou quando a maximização da disponibilidade é um requisito, usando o EventHubProducerClient é recomendado.

EventHubBufferedProducerClientOptions

O conjunto de opções que pode ser especificado ao criar um EventHubBufferedProducerClient para configurar seu comportamento.

EventHubProducerClient

Um cliente responsável pela publicação EventData em um Hub de Eventos específico, agrupado em lotes. Dependendo das opções especificadas ao enviar, os eventos podem ser atribuídos automaticamente a uma partição disponível ou podem solicitar uma partição específica.

O EventHubProducerClient publica imediatamente, garantindo um resultado determinístico para cada operação de envio, embora exija que os chamadores possuam a responsabilidade de criar e gerenciar lotes.

Em cenários em que não é importante ter eventos publicados imediatamente e em que maximizar a disponibilidade da partição não é um requisito, é recomendável considerar o uso do EventHubBufferedProducerClient, que assume a responsabilidade de criar e gerenciar lotes para reduzir a complexidade de fazer isso no código do aplicativo.

EventHubProducerClientOptions

O conjunto de opções que pode ser especificado ao criar um EventHubProducerClient para configurar seu comportamento.

SendEventBatchFailedEventArgs

Contém informações sobre um lote que não pôde ser publicado, bem como a exceção que ocorreu e a partição na qual o lote estava sendo publicado.

SendEventBatchSucceededEventArgs

Contém informações sobre um lote que foi publicado e a partição na qual ele foi publicado.

SendEventOptions

O conjunto de opções que pode ser especificado para influenciar a maneira como os eventos são publicados no serviço hubs de eventos.