The EventHubBufferedProducerClient
class is used to send events to an Event Hub.
Use the options
parmeter to configure retry policy or proxy settings.
The connection string to use for connecting to the Event Hub instance. It is expected that the shared key properties and the Event Hub path are contained in this connection string. e.g. 'Endpoint=sb://my-servicebus-namespace.servicebus.windows.net/;SharedAccessKeyName=my-SA-name;SharedAccessKey=my-SA-key;EntityPath=my-event-hub-name'.
A set of options to apply when configuring the client.
retryOptions
: Configures the retry policy for all the operations on the client.
For example, { "maxRetries": 4 }
or { "maxRetries": 4, "retryDelayInMs": 30000 }
.webSocketOptions
: Configures the channelling of the AMQP connection over Web Sockets.userAgent
: A string to append to the built in user agent string that is passed to the service.The EventHubBufferedProducerClient
class is used to send events to an Event Hub.
Use the options
parmeter to configure retry policy or proxy settings.
The connection string to use for connecting to the Event Hub instance. It is expected that the shared key properties and the Event Hub path are contained in this connection string. e.g. 'Endpoint=sb://my-servicebus-namespace.servicebus.windows.net/;SharedAccessKeyName=my-SA-name;SharedAccessKey=my-SA-key;EntityPath=my-event-hub-name'.
The name of the specific Event Hub to connect the client to.
A set of options to apply when configuring the client.
retryOptions
: Configures the retry policy for all the operations on the client.
For example, { "maxRetries": 4 }
or { "maxRetries": 4, "retryDelayInMs": 30000 }
.webSocketOptions
: Configures the channelling of the AMQP connection over Web Sockets.userAgent
: A string to append to the built in user agent string that is passed to the service.The EventHubBufferedProducerClient
class is used to send events to an Event Hub.
Use the options
parmeter to configure retry policy or proxy settings.
The full namespace which is likely to be similar to
The name of the specific Event Hub to connect the client to.
An credential object used by the client to get the token to authenticate the connection
with the Azure Event Hubs service.
See @azure/identity for creating credentials that support AAD auth.
Use the AzureNamedKeyCredential
from @azure/core-auth if you want to pass in a SharedAccessKeyName
and SharedAccessKey
without using a connection string. These fields map to the name
and key
field respectively
in AzureNamedKeyCredential
.
Use the AzureSASCredential
from @azure/core-auth if you want to pass in a SharedAccessSignature
without using a connection string. This field maps to signature
in AzureSASCredential
.
A set of options to apply when configuring the client.
retryOptions
: Configures the retry policy for all the operations on the client.
For example, { "maxRetries": 4 }
or { "maxRetries": 4, "retryDelayInMs": 30000 }
.webSocketOptions
: Configures the channelling of the AMQP connection over Web Sockets.userAgent
: A string to append to the built in user agent string that is passed to the service.Closes the AMQP connection to the Event Hub instance, returning a promise that will be resolved when disconnection is completed.
This will wait for enqueued events to be flushed to the service before closing
the connection.
To close without flushing, set the flush
option to false
.
The set of options to apply to the operation call.
Promise
Enqueues an event into the buffer to be published to the Event Hub. If there is no capacity in the buffer when this method is invoked, it will wait for space to become available and ensure that the event has been enqueued.
When this call returns, the event has been accepted into the buffer, but it may not have been published yet. Publishing will take place at a nondeterministic point in the future as the buffer is processed.
A set of options that can be specified to influence the way in which the event is sent to the associated Event Hub.
abortSignal
: A signal used to cancel the enqueueEvent operation.partitionId
: The partition this set of events will be sent to. If set, partitionKey
can not be set.partitionKey
: A value that is hashed to produce a partition assignment. If set, partitionId
can not be set.The total number of events that are currently buffered and waiting to be published, across all partitions.
Enqueues events into the buffer to be published to the Event Hub. If there is no capacity in the buffer when this method is invoked, it will wait for space to become available and ensure that the events have been enqueued.
When this call returns, the events have been accepted into the buffer, but it may not have been published yet. Publishing will take place at a nondeterministic point in the future as the buffer is processed.
An array of EventData or AmqpAnnotatedMessage
.
A set of options that can be specified to influence the way in which events are sent to the associated Event Hub.
abortSignal
: A signal used to cancel the enqueueEvents operation.partitionId
: The partition this set of events will be sent to. If set, partitionKey
can not be set.partitionKey
: A value that is hashed to produce a partition assignment. If set, partitionId
can not be set.The total number of events that are currently buffered and waiting to be published, across all partitions.
Attempts to publish all events in the buffer immediately.
This may result in multiple batches being published,
the outcome of each of which will be individually reported by
the onSendEventsSuccessHandler
and onSendEventsErrorHandler
handlers.
The set of options to apply to the operation call.
Provides the Event Hub runtime information.
The set of options to apply to the operation call.
A promise that resolves with information about the Event Hub instance.
Provides the id for each partition associated with the Event Hub.
The set of options to apply to the operation call.
A promise that resolves with an Array of strings representing the id for each partition associated with the Event Hub.
Provides information about the state of the specified partition.
The id of the partition for which information is required.
The set of options to apply to the operation call.
A promise that resolves with information about the state of the partition .
Generated using TypeDoc
The
EventHubBufferedProducerClient
is used to publish events to a specific Event Hub.The
EventHubBufferedProducerClient
does not publish events immediately. Instead, events are buffered so they can be efficiently batched and published when the batch is full or themaxWaitTimeInMs
has elapsed with no new events enqueued.Depending on the options specified when events are enqueued, they may be automatically assigned to a partition, grouped according to the specified partition key, or assigned a specifically requested partition.
This model is intended to shift the burden of batch management from callers, at the cost of non-deterministic timing, for when events will be published. There are additional trade-offs to consider, as well:
onSendEventsSuccessHandler
andonSendEventsErrorHandler
handlers.EventHubBufferedProducerClient
may take longer to recover than other producers.In scenarios where it is important to have events published immediately with a deterministic outcome, ensure that partition keys are assigned to a partition consistent with other publishers, or where maximizing availability is a requirement, using the
EventHubProducerClient
is recommended.