Partager via


Azure.Messaging.EventHubs.Producer Espace de noms

Classes

CreateBatchOptions

Ensemble d’options qui peuvent être spécifiées pour influencer la façon dont un lot d’événements se comporte et est envoyé au service Event Hubs.

EnqueueEventOptions

Ensemble d’options qui peuvent être spécifiées pour influencer la façon dont les événements sont publiés sur le service Event Hubs.

EventDataBatch

Ensemble de avec des contraintes de EventData taille connues à l’avance, destinés à être envoyés au service Event Hubs en une seule opération. Lorsqu’il est publié, le résultat est atomique ; tous les événements qui appartiennent au lot ont réussi ou ont tous échoué. Une réussite partielle n’est pas possible.

EventHubBufferedProducerClient

Client responsable de la publication d’instances de EventData dans un Event Hub spécifique. Selon les options spécifiées lorsque les événements sont en file d’attente, ils peuvent être automatiquement attribués à une partition, regroupés en fonction de la clé de partition spécifiée ou affectés à une partition spécifiquement demandée.

ne EventHubBufferedProducerClient publie pas immédiatement, mais utilise un modèle différé où les événements sont collectés dans une mémoire tampon afin qu’ils puissent être efficacement traités par lots et publiés lorsque le lot est complet ou que le MaximumWaitTime est écoulé sans qu’aucun nouvel événement ne soit mis en file d’attente.

Ce modèle est destiné à déplacer la charge de la gestion par lots des appelants, au prix d’un timing non déterministe, pour le moment où les événements seront publiés. Il existe également d’autres compromis à prendre en compte :

  • Si l’application se bloque, les événements dans la mémoire tampon n’auront pas été publiés. Pour éviter la perte de données, les appelants sont encouragés à suivre la progression de la publication à l’aide des SendEventBatchSucceededAsync gestionnaires et SendEventBatchFailedAsync .
  • Les événements spécifiant une clé de partition peuvent se voir attribuer une partition différente de ceux qui utilisent la même clé avec d’autres producteurs.
  • Dans le cas peu probable où une partition devient temporairement indisponible, la EventHubBufferedProducerClient récupération peut prendre plus de temps que les autres producteurs.

Dans les scénarios où il est important d’avoir des événements publiés immédiatement avec un résultat déterministe, assurez-vous que les clés de partition sont attribuées à une partition cohérente avec d’autres éditeurs, ou lorsque l’optimisation de la disponibilité est une exigence, l’utilisation de est EventHubProducerClient recommandée.

EventHubBufferedProducerClientOptions

Ensemble d’options qui peuvent être spécifiées lors de la création d’un EventHubBufferedProducerClient pour configurer son comportement.

EventHubProducerClient

Client responsable de la publication EventData dans un Event Hub spécifique, regroupé par lots. Selon les options spécifiées lors de l’envoi, les événements peuvent se voir attribuer automatiquement une partition disponible ou demander une partition spécifique.

Le EventHubProducerClient publie immédiatement, garantissant un résultat déterministe pour chaque opération d’envoi, mais exige que les appelants soient responsables de la création et de la gestion des lots.

Dans les scénarios où il n’est pas important d’avoir des événements publiés immédiatement et où l’optimisation de la disponibilité des partitions n’est pas une exigence, il est recommandé d’envisager d’utiliser , EventHubBufferedProducerClientqui prend la responsabilité de générer et de gérer les lots afin de réduire la complexité de le faire dans le code d’application.

EventHubProducerClientOptions

Ensemble d’options qui peuvent être spécifiées lors de la création d’un EventHubProducerClient pour configurer son comportement.

SendEventBatchFailedEventArgs

Contient des informations sur un lot qui n’a pas pu être publié, ainsi que l’exception qui s’est produite et la partition sur laquelle le lot a été publié.

SendEventBatchSucceededEventArgs

Contient des informations sur un lot publié et la partition sur laquelle il a été publié.

SendEventOptions

Ensemble d’options qui peuvent être spécifiées pour influencer la façon dont les événements sont publiés sur le service Event Hubs.