| id | index |
|---|---|
| title | Relational databases |
| sidebar_label | Overview |
| description | Learn how relational databases work in Camunda 8 Self-Managed as a core Orchestration Cluster capability and navigate to setup, support, and configuration guides. |
Relational database (RDBMS) support is a core capability of the Orchestration Cluster in Camunda 8 Self-Managed.
RDBMS is a standard secondary storage option for Orchestration Cluster installations, alongside Elasticsearch and OpenSearch.
With RDBMS secondary storage, the RDBMS exporter writes orchestration data to your relational database, and the Orchestration Cluster API queries it. Operate, Tasklist, and Admin use that API rather than querying the database directly.
In this context:
- Primary storage is the broker-managed store for workflow execution state management.
- Secondary storage is an external store used for indexing, querying, analytics, and retention.
For a deeper conceptual comparison, see understanding primary vs secondary storage.
graph LR
exporter["RDBMS Exporter"]
api["Orchestration Cluster API"]
rdbms["RDBMS\n(secondary storage)"]
exporter -->|"Write"| rdbms
api -->|"Query"| rdbms
style exporter fill:#e4eef8,stroke:#2272c9,color:#14082c
style api fill:#e4eef8,stroke:#2272c9,color:#14082c
style rdbms fill:#fde8da,stroke:#fc5d0d,color:#14082c
- New to RDBMS in Camunda: End-to-end RDBMS setup guide
- Need supported versions and compatibility details: RDBMS version support policy
- Need application-level settings and behavior: RDBMS configuration overview
- Helm deployments: Configure RDBMS in Helm
- Manual deployments: Configure RDBMS for manual installation