Connect the Java driver to your database
DataStax recommends using the Java client with HCD databases. Use the Java driver only if you are working with an existing application that previously used a CQL-based driver or if you plan to explicitly use CQL. |
Because Hyper-Converged Database (HCD) is based on Apache Cassandra®, you can use Cassandra drivers to connect to your HCD databases.
To use the Java driver, you need to add the driver dependency to your pom.xml
, use the ConnectDatabase
class to initialize the driver, and then connect the driver to your HCD database.
This guide explains how to connect the Java driver to a database.
Prerequisites
Before you configure the Java driver, do the following:
-
Install a cluster and start an HCD database
-
Install Java project dependencies, such as a current Java version and Maven
Add the Java driver dependency
-
In your project’s
pom.xml
file, add a dependency for the Apache Cassandra Java driver.
-
Latest version
-
Version 4.17 and earlier
<dependency> <groupId>org.apache.cassandra</groupId> <artifactId>java-driver-core</artifactId> <version>VERSION</version> </dependency>
<dependency> <groupId>com.datastax.oss</groupId> <artifactId>java-driver-core</artifactId> <version>VERSION</version> </dependency>
If you choose to install an earlier version, make sure you choose a version that is compatible with HCD. If you need to query vector data, make sure your chosen version also supports vector data. For more information, see Cassandra drivers supported by DataStax.
-
Initialize and connect the Java driver
Import the necessary classes, set up a CqlSession
with authentication credentials, and specify a default keyspace:
import com.datastax.oss.driver.api.core.CqlSession;
import com.datastax.oss.driver.api.core.cql.ResultSet;
import com.datastax.oss.driver.api.core.cql.Row;
import com.datastax.oss.driver.api.core.CqlSessionBuilder;
import com.datastax.oss.driver.api.core.cql.PreparedStatement;
import com.datastax.oss.driver.api.core.data.CqlVector;
import com.datastax.oss.driver.api.core.type.codec.TypeCodecs;
import java.nio.file.Paths;
import java.util.Arrays;
import java.util.List;
public class DriverExample {
public static void main(String[] args) {
// Initialize the Java driver
String keyspace = "default_keyspace";
CqlSessionBuilder builder = CqlSession.builder();
builder.withAuthCredentials("user_name","password");
builder.withKeyspace(keyspace);
try (CqlSession session = builder.build()) {
int v_dimension = 5;
// ...
}
}
}
Next steps
Once connected, your scripts can use the driver to run commands against your database. For more information and examples, see Java driver quickstart.