Transaction Events Streaming

Learn about streaming transaction events to your applications using the Oracle NoSQL Database Streams API.

Oracle NoSQL Database supports an optional feature that allows you to configure transaction events streaming in your subscription. A transaction is a logical sequence of database operations treated as a single unit of work.

All write operations in a single committed transaction are encapsulated in a single stream operation and delivered to subscribers. The default behavior is each committed write, either a PUT or a DELETE, is a single stream operation.

For example, for a transaction with 10 updates that is committed on a data store, the Streams API will include a discrete list of 10 committed write events. However, if you have configured to stream transaction events, the Streams API will include a single committed transaction event containing a list of 10 write operations performed in the transaction event.

To explicitly deliver transaction events to subscribers, you must:

  1. Configure the subscription to stream transaction events for the table of interest. For method details, see Using NoSQLSubscriptionConfig.
  2. Configure the subscriber to receive a stream with transaction events. For method details, see Using the StreamOperation Class.

Note:

The Streams API allows you to configure a subscription to stream either a list of individual committed write operations, or a list of committed transaction events containing one or more writes for a table. If you already have a default subscription and want to stream transaction events, you must unsubscribe the table and resubscribe it to deliver transaction events.