Java driver for Apache Cassandra®
This page describes the versions of the Java driver for Apache Cassandra® that are compatible with DSE, HCD, Astra DB, and open-source Cassandra.
DataStax officially supports the last 12 months of releases, and DataStax recommends using the latest driver version whenever possible. Compatibility is not guaranteed for earlier versions.
New features and bug fixes are developed on the latest minor version of the driver, and users are encouraged to stay current with those minor releases. APIs are maintained stable according to semantic versioning conventions, and upgrades should be trivial.
Unless otherwise specified, version ranges include all patch versions. For example, a range of 4.0 to 4.3 includes all versions from 4.0.0 to the last 4.3.z release.
|
Fully compatible |
|
Partially compatible |
Not compatible |
Java driver ownership
Starting with versions 3.12 and 4.18, the Java driver is maintained by the Apache Software Foundation. Prior versions were maintained by DataStax.
If you are on the 3.x series, DataStax recommends that you upgrade to the 4.x series.
To upgrade to version 4.18 or later, you must change the groupId
from com.datastax.cassandra
to org.apache.cassandra
in your Java project dependencies.
-
Latest version
-
Version 4.17 and earlier
<dependency>
<groupId>org.apache.cassandra</groupId>
<artifactId>java-driver-core</artifactId>
<version>4.19.0</version>
</dependency>
<dependency>
<groupId>com.datastax.oss</groupId>
<artifactId>java-driver-core</artifactId>
<version>4.17.0</version>
</dependency>
Java driver 4.x series compatibility
-
Cassandra
-
DSE
-
HCD
-
Astra DB
Driver version |
Apache Cassandra® version |
||
---|---|---|---|
5.0+ |
4.0+ |
3.0+ |
|
4.19 and later |
|
|
|
4.18 a |
b |
|
|
b |
|
|
|
c |
|
|
|
w |
|
a Starting with this version, this driver is maintained by the Apache Software Foundation.
b Doesn’t support vectors of arbitrary subtype.
c Doesn’t support new features introduced in Cassandra 5.0 or later. May not be compatible with changes to existing functionality released in Cassandra 5.0 or later.
w Limited to the Cassandra 3.x API.
Driver version |
DataStax Enterprise (DSE) version |
||
---|---|---|---|
6.9 |
6.8 |
5.1 |
|
4.19 and later |
|
|
|
4.18 a |
|
|
|
|
|
|
|
q |
|
|
|
q,z |
z |
|
|
q,z |
z |
z |
a Starting with this version, this driver is maintained by the Apache Software Foundation.
q Doesn’t support the vector type
z Doesn’t support all DSE features.
Unsupported Java driver versions
If you are using an unsupported version of the Java driver, DataStax recommends that you upgrade to the 4.x series.
For information about upgrading to the 4.x series, see the following:
Java driver 3.x series (Maintenance)
The 3.x series of the Java driver entered maintenance status in 2023.
-
Cassandra
-
DSE
-
HCD
-
Astra DB
Driver version |
Apache Cassandra® version |
||
---|---|---|---|
5.0+ |
4.0+ |
3.0+ |
|
3.12 a |
c |
|
|
c |
|
|
|
w |
|
a Starting with this version, this driver is maintained by the Apache Software Foundation.
c Doesn’t support new features introduced in Cassandra 5.0 or later. May not be compatible with changes to existing functionality released in Cassandra 5.0 or later.
w Limited to the Cassandra 3.x API.
Driver version |
DataStax Enterprise (DSE) version |
||
---|---|---|---|
6.9 |
6.8 |
5.1 |
|
3.12 a |
q,z |
z |
z |
q,z |
z |
z |
a Starting with this version, this driver is maintained by the Apache Software Foundation.
q Doesn’t support the vector type
z Doesn’t support all DSE features.
Driver version |
Hyper-Converged Database (HCD) version |
---|---|
1.1+ |
|
3.12 a |
q,z |
q,z |
a Starting with this version, this driver is maintained by the Apache Software Foundation.
q Doesn’t support the vector type
z Doesn’t support all DSE features.
DataStax Java driver 2.x series (EOL)
The 2.x series of the Java driver was superseded by the 3.x series in 2016.
DataStax doesn’t support the 2.x series of the Java driver, and it isn’t compatible with Astra DB, HCD, or any LTS or latest version of DSE or Cassandra.
DSE Java driver (EOL)
The DSE-only Java driver reached EOL in January 2022.
For more information, see End-of-life drivers for Apache Cassandra®.