Requirements
This page describes the required tools and their versions to use ScalarDL correctly.
Client SDK
Because ScalarDL is written in Java, the easiest way to interact with ScalarDL is to use the Java client SDK.
Java
The following Java Development Kits (JDKs) are verified and supported:
- Oracle JDK: 8, 11, 17, or 21 (LTS versions)
- OpenJDK (Eclipse Temurin, Amazon Corretto, or Microsoft Build of OpenJDK): 8, 11, 17, or 21 (LTS versions)
Other languages
ScalarDL uses gRPC, so you can create your own client by using the generated clients of your preferred languages.
Databases
ScalarDL is middleware that runs on top of the following databases and their versions.
Relational databases
- Oracle Database
- Db2
- MySQL
- PostgreSQL
- Amazon Aurora MySQL
- Amazon Aurora PostgreSQL
- MariaDB
- SQL Server
- SQLite
- YugabyteDB
| Version | Oracle Database 23ai | Oracle Database 21c | Oracle Database 19c |
|---|---|---|---|
| ScalarDL 3.12 | ✅ | ✅ | ✅ |
| ScalarDL 3.11 | ✅ | ✅ | ✅ |
| ScalarDL 3.10 | ✅ | ✅ | ✅ |
| ScalarDL 3.9 | ✅ | ✅ | ✅ |
| Version | Db2 12.1 | Db2 11.5 |
|---|---|---|
| ScalarDL 3.12 | ✅ | ✅ |
| ScalarDL 3.11 | ❌ | ❌ |
| ScalarDL 3.10 | ❌ | ❌ |
| ScalarDL 3.9 | ❌ | ❌ |
| Version | MySQL 8.4 | MySQL 8.0 |
|---|---|---|
| ScalarDL 3.12 | ✅ | ✅ |
| ScalarDL 3.11 | ✅ | ✅ |
| ScalarDL 3.10 | ✅ | ✅ |
| ScalarDL 3.9 | ✅ | ✅ |
| Version | PostgreSQL 17 | PostgreSQL 16 | PostgreSQL 15 | PostgreSQL 14 | PostgreSQL 13 |
|---|---|---|---|---|---|
| ScalarDL 3.12 | ✅ | ✅ | ✅ | ✅ | ✅ |
| ScalarDL 3.11 | ✅ | ✅ | ✅ | ✅ | ✅ |
| ScalarDL 3.10 | ✅ | ✅ | ✅ | ✅ | ✅ |
| ScalarDL 3.9 | ✅ | ✅ | ✅ | ✅ | ✅ |
| Version | Aurora MySQL 3 | Aurora MySQL 2 |
|---|---|---|
| ScalarDL 3.12 | ✅ | ✅ |
| ScalarDL 3.11 | ✅ | ✅ |
| ScalarDL 3.10 | ✅ | ✅ |
| ScalarDL 3.9 | ✅ | ✅ |
| Version | Aurora PostgreSQL 16 | Aurora PostgreSQL 15 | Aurora PostgreSQL 14 | Aurora PostgreSQL 13 |
|---|---|---|---|---|
| ScalarDL 3.12 | ✅ | ✅ | ✅ | ✅ |
| ScalarDL 3.11 | ✅ | ✅ | ✅ | ✅ |
| ScalarDL 3.10 | ✅ | ✅ | ✅ | ✅ |
| ScalarDL 3.9 | ✅ | ✅ | ✅ | ✅ |
| Version | MariaDB 11.4 | MariaDB 10.11 |
|---|---|---|
| ScalarDL 3.12 | ✅ | ✅ |
| ScalarDL 3.11 | ✅ | ✅ |
| ScalarDL 3.10 | ✅ | ✅ |
| ScalarDL 3.9 | ✅ | ✅ |
| Version | SQL Server 2022 | SQL Server 2019 | SQL Server 2017 |
|---|---|---|---|
| ScalarDL 3.12 | ✅ | ✅ | ✅ |
| ScalarDL 3.11 | ✅ | ✅ | ✅ |
| ScalarDL 3.10 | ✅ | ✅ | ✅ |
| ScalarDL 3.9 | ✅ | ✅ | ✅ |
| Version | SQLite 3 |
|---|---|
| ScalarDL 3.12 | ✅ |
| ScalarDL 3.11 | ✅ |
| ScalarDL 3.10 | ✅ |
| ScalarDL 3.9 | ✅ |
| Version | YugabyteDB 2 |
|---|---|
| ScalarDL 3.12 | ✅ |
| ScalarDL 3.11 | ✅ |
| ScalarDL 3.10 | ✅ |
| ScalarDL 3.9 | ❌ |
NoSQL databases
- Amazon DynamoDB
- Apache Cassandra
- Azure Cosmos DB for NoSQL
| Version | DynamoDB |
|---|---|
| ScalarDL 3.12 | ✅ |
| ScalarDL 3.11 | ✅ |
| ScalarDL 3.10 | ✅ |
| ScalarDL 3.9 | ✅ |
| Version | Cassandra 4.1 | Cassandra 4.0 | Cassandra 3.11 | Cassandra 3.0 |
|---|---|---|---|---|
| ScalarDL 3.12 | ❌ | ❌ | ✅ | ✅ |
| ScalarDL 3.11 | ❌ | ❌ | ✅ | ✅ |
| ScalarDL 3.10 | ❌ | ❌ | ✅ | ✅ |
| ScalarDL 3.9 | ❌ | ❌ | ✅ | ✅ |
| Version | Cosmos DB for NoSQL |
|---|---|
| ScalarDL 3.12 | ✅ |
| ScalarDL 3.11 | ✅ |
| ScalarDL 3.10 | ✅ |
| ScalarDL 3.9 | ✅ |
ScalarDL uses ScalarDB to abstract underlying databases. For details on how to configure each database, see Configurations for the Underlying Databases of ScalarDB.
The following list shows the versions of ScalarDB used in ScalarDL internally. This version list will help you if:
- You want to know what available backend databases you can use in ScalarDL. For details about which backend databases are supported and can be used in ScalarDL based on the version of ScalarDB, see the list of databases that ScalarDB supports.
- You want to know what ScalarDB APIs are available for the
Functionfeature in ScalarDL.
| ScalarDL version | ScalarDB version |
|---|---|
| 3.12 | 3.16 |
| 3.11 | 3.15 |
| 3.10 | 3.14 |
| 3.9 | 3.12 |
Required ports
ScalarDL requires the following ports to be accessible. These default port numbers can be configured as needed:
- ScalarDL Ledger
- 50051 (normal request)
- 50052 (privileged request)
- 50053 (pause request)
- 8080 (metrics)
- ScalarDL Auditor
- 40051 (normal request)
- 40052 (privileged request)
- 40053 (pause request)
- 8080 (metrics)
- ScalarDL Gateway
- 30051 (normal request)
- 30052 (privileged request)
- 30053 (pause request)
- 8080 (metrics)
Kubernetes
ScalarDL is provided as a Pod on the Kubernetes platform in production environments. ScalarDL supports the following platforms and tools.
Platform
- Kubernetes: 1.31 - 1.34
- Red Hat OpenShift: TBD
Package manager
- Helm: 3.5+