Connect to Astra Managed Clusters databases

When you develop applications that interact with your Astra Managed Clusters databases, you must connect to your databases programmatically.

There are several ways to connect to your databases, including APIs, CLI tools, and Apache Cassandra® drivers. Depending on your use case, you might use one or more of these methods.

Use case Recommended methods

Application development with an Astra Managed Clusters database

CQL and Drivers

Maintain a legacy application that relies on a driver or CQL

CQL and Drivers

Administration

Streaming

Migration and bulk loading

Third-party integrations

Varies by provider and use case; see Integrations overview

Programmatic authentication is handled through an application token and the Secure Connect Bundle (SCB).

DevOps API

Use the DevOps API for administration and high-level database management tasks, such as database creation, user management, and security configurations.

For more information, see Get started with the Astra DevOps API.

Drivers

You can use Cassandra drivers to interact with your Astra Managed Clusters databases through the Cassandra Query Language (CQL).

Astra Managed Clusters databases are compatible with the following Cassandra drivers:

Supported drivers
Language Driver Latest version Documentation

C++

cpp-driver

Latest cpp-driver release on GitHub

Get started with the C++ driver

C#

csharp-driver

Latest CassandraCSharpDriver release on NuGet

Get started with the C# driver

Go

gocql-astra (with cassandra-gocql-driver)

Latest gocql release on GitHub

Get started with the Go driver

Java

cassandra-java-driver

Latest cassandra-java-driver release on GitHub

Get started with the Java driver

Node.js

cassandra-driver

Latest cassandra-driver release on GitHub

Get started with the Node.js driver

Python

cassandra-driver

Latest cassandra-driver release on GitHub

Get started with the Python driver

Scala

cassandra-spark-connector

Latest cassandra-spark-connector release on GitHub

Get started with the Apache Cassandra Spark Connector

For more information, see Cassandra driver compatibility.

CQL shell (cqlsh)

Because Astra DB is powered by Apache Cassandra®, you can use Cassandra Query Language (CQL) to programmatically interact with your databases through cqlsh or a driver. For more information, see CQL for Astra DB.

DataStax Bulk Loader (DSBulk)

DSBulk supports large data uploads and migrations. For more information, see About DataStax Bulk Loader (DSBulk).

Astra CLI

The Astra CLI is a command-line interface that lets you create and manage Astra resources from your terminal, including Astra DB databases and Astra Streaming tenants.

For example:

For more information and commands, see the Astra CLI documentation

You can use Astra CLI in addition to other connection methods.

Astra Portal

The Astra Portal provides a web-based interface to manage your Astra organizations and Astra DB databases. It is best for administrative tasks and high-level database management, including inspecting database health metrics.

For application development, fine-grained data manipulation, and nuanced searches, you must use a programmatic approach.

For information about accessing the Astra Portal, see Manage your Astra account and Firewall rules for the Astra Portal.

Legacy Stargate APIs (deprecated)

Legacy Stargate APIs are no longer supported for Astra. Specifically, the Document API, REST API, GraphQL API, and gRPC API are no longer supported for Astra. As an alternative, you can use the Cassandra drivers, or you can migrate to Astra DB Serverless to use the Astra DB Serverless Data API.

Was this helpful?

Give Feedback

How can we improve the documentation?

© Copyright IBM Corporation 2026 | Privacy policy | Terms of use Manage Privacy Choices

Apache, Apache Cassandra, Cassandra, Apache Tomcat, Tomcat, Apache Lucene, Apache Solr, Apache Hadoop, Hadoop, Apache Pulsar, Pulsar, Apache Spark, Spark, Apache TinkerPop, TinkerPop, Apache Kafka and Kafka are either registered trademarks or trademarks of the Apache Software Foundation or its subsidiaries in Canada, the United States and/or other countries. Kubernetes is the registered trademark of the Linux Foundation.

General Inquiries: Contact IBM