RethinkDB binding spec

Detailed documentation on the RethinkDB binding component

Introduction

The RethinkDB state store supports transactions which means it can be used to support Dapr actors. Dapr persists only the actor’s current state which doesn’t allow the users to track how actor’s state may have changed over time.

To enable users to track change of the state of actors, this binding leverages RethinkDB’s built-in capability to monitor RethinkDB table and event on change with both the old and new state. This binding creates a subscription on the Dapr state table and streams these changes using the Dapr input binding interface.

Setup Dapr component

Create the following YAML file and save this to the components directory in your application directory. (Use the --components-path flag with dapr run to point to your custom components dir)

  1. apiVersion: dapr.io/v1alpha1
  2. kind: Component
  3. metadata:
  4. name: changes
  5. spec:
  6. type: bindings.rethinkdb.statechange
  7. version: v1
  8. metadata:
  9. - name: address
  10. value: <REPLACE-RETHINKDB-ADDRESS> # Required, e.g. 127.0.0.1:28015 or rethinkdb.default.svc.cluster.local:28015).
  11. - name: database
  12. value: <REPLACE-RETHINKDB-DB-NAME> # Required, e.g. dapr (alpha-numerics only)

For example on how to combine this binding with Dapr Pub/Sub to stream state changes to a topic see here.

Related links

Last modified February 16, 2021: Merge pull request #1235 from dapr/update-v0.11 (b4e9fbb)