Compartir a través de


Azure.Messaging.EventHubs.Producer Espacio de nombres

Clases

CreateBatchOptions

Conjunto de opciones que se pueden especificar para influir en la forma en que se comporta un lote de eventos y se envía al servicio Event Hubs.

EnqueueEventOptions

Conjunto de opciones que se pueden especificar para influir en la forma en que se publican los eventos en el servicio Event Hubs.

EventDataBatch

Un conjunto de con restricciones de EventData tamaño conocidas por adelantado, diseñadas para enviarse al servicio Event Hubs en una sola operación. Cuando se publica, el resultado es atómico; todos los eventos que pertenecen al lote se realizaron correctamente o todos han producido un error. No es posible realizar el éxito parcial.

EventHubBufferedProducerClient

Un cliente responsable de publicar instancias de EventData en un centro de eventos específico. Según las opciones especificadas cuando se ponen en cola los eventos, pueden asignarse automáticamente a una partición, agruparse según la clave de partición especificada o asignar una partición solicitada específicamente.

EventHubBufferedProducerClient no se publica inmediatamente, sino que usa un modelo diferido en el que se recopilan eventos en un búfer para que se puedan procesar por lotes y publicarse de forma eficaz cuando el lote esté lleno o MaximumWaitTime que haya transcurrido sin nuevos eventos en cola.

Este modelo está pensado para cambiar la carga de la administración por lotes de los autores de llamadas, a costa del tiempo no determinista, para cuando se publiquen los eventos. Hay ventajas y desventajas adicionales que se deben tener en cuenta, así como:

  • Si la aplicación se bloquea, los eventos del búfer no se habrán publicado. Para evitar la pérdida de datos, se recomienda a los autores de llamadas realizar un seguimiento del progreso de la publicación mediante los SendEventBatchSucceededAsync controladores y SendEventBatchFailedAsync .
  • Los eventos que especifican una clave de partición se pueden asignar a una partición diferente de las que usan la misma clave con otros productores.
  • En el improbable caso de que una partición deje de estar disponible temporalmente, EventHubBufferedProducerClient puede tardar más tiempo en recuperarse que otros productores.

En escenarios en los que es importante que los eventos se publiquen inmediatamente con un resultado determinista, asegúrese de que las claves de partición se asignan a una partición coherente con otros publicadores, o donde maximizar la disponibilidad es un requisito, se recomienda usar EventHubProducerClient .

EventHubBufferedProducerClientOptions

Conjunto de opciones que se pueden especificar al crear un EventHubBufferedProducerClient objeto para configurar su comportamiento.

EventHubProducerClient

Un cliente responsable de publicar EventData en un centro de eventos específico, agrupado en lotes. Dependiendo de las opciones especificadas al enviar, los eventos se pueden asignar automáticamente a una partición disponible o pueden solicitar una partición específica.

El EventHubProducerClient se publica inmediatamente, lo que garantiza un resultado determinista para cada operación de envío, aunque requiere que los autores de las llamadas tengan la responsabilidad de crear y administrar lotes.

En escenarios en los que no es importante que los eventos se publiquen inmediatamente y donde maximizar la disponibilidad de las particiones no es un requisito, se recomienda considerar el uso EventHubBufferedProducerClientde , que asume la responsabilidad de compilar y administrar lotes para reducir la complejidad de hacerlo en el código de la aplicación.

EventHubProducerClientOptions

Conjunto de opciones que se pueden especificar al crear un EventHubProducerClient objeto para configurar su comportamiento.

SendEventBatchFailedEventArgs

Contiene información sobre un lote en el que no se pudo publicar, así como la excepción que se produjo y la partición en la que se publicó el lote.

SendEventBatchSucceededEventArgs

Contiene información sobre un lote publicado y la partición en la que se publicó.

SendEventOptions

Conjunto de opciones que se pueden especificar para influir en la forma en que se publican los eventos en el servicio Event Hubs.