RIDDL Documentation
Toggle Dark/Light/Auto mode Toggle Dark/Light/Auto mode Toggle Dark/Light/Auto mode Back to homepage



A Saga defines a way for an external application to invoke a distributed transaction via the Saga Pattern. Sagas are necessary in distributed services that use the Database per Service Pattern, like RIDDL. The Saga Pattern definition describes the context in which Sagas are used:

You have applied the Database per Service pattern. Each service has its own database. Some business transactions, however, span multiple service so you need a mechanism to implement transactions that span services. For example, let’s imagine that you are building an e-commerce store where customers have a credit limit. The application must ensure that a new order will not exceed the customer’s credit limit. Since Orders and Customers are in different databases owned by different services the application cannot simply use a local ACID transaction.

The goal of a saga is to define a function across multiple entities that must atomically succeed with state changes, or fail with no state changes. So, a saga defines a set of commands to send to incur changes on entities, and a set of commands to undo those changes in case it cannot be atomically completed.

Sagas are very like functions but they only involve the sending of commands to entities. Sagas generally involve one or more different kinds of entities, or multiple entities of the same kind.


saga AllOrNothing is {
  requires { p1: String, p2: String }
  yields { result: String }
  action Step1 for entity Thingy is {
    command DoIt reverted by UnDoIt as {
      example One is {
        then "pass p1 to entity Thingy with DoIt"
  action Step2 for entity Thingy is {
    command CheckIt reverted by UnCheckIt as {
      example One is {
        then "pass p2 to entity Thingy with CheckIt"
        and "yield the result from the reply from Thingy"

defines saga, AllOrNothing, with two input parameters, an output string, and two steps to be done in parallel.

Further Reading