Connecting to your Astra DB database

You can access your databases in the Astra Portal or programmatically. The Astra Portal is best for administration and monitoring, such as user management and monitoring database health metrics. Use programmatic options for nuanced data manipulation operations, such as inserting rows and querying data, and developing applications that use your Astra DB databases.

Astra DB Classic offers several programmatic options to connect to your database:

Option Description

APIs

Use the Stargate APIs on Astra to interact with your database and self-manage the schema.

The legacy Stargate APIs are deprecated for Astra DB Classic as of September 2024, and end-of-life (EOL) is scheduled for the end of 2025. As EOL approaches, DataStax will provide migration information to support your transition to other options.

If you have questions or concerns, contact your account representative or DataStax Support.

DataStax drivers

Initialize one of the DataStax drivers to manage database connections for your application.

CQL shell (cqlsh)

Use Cassandra Query Language (CQL) for Astra DB to interact with your database.

Drivers

DataStax offers the following officially-supported drivers for Astra DB Classic:

Language Language dependency Driver documentation

C++

2.14 or later

DataStax C++ driver

C#

3.17 or later

DataStax C# driver

Go

1.18 or later

Go driver

Java

3.x series: 3.11 or later

4.x series: 4.6 or later

DataStax Java driver

Node.js

4.4 or later

DataStax Node.js driver

Python

3.25 or later

DataStax Python driver

For more information about working with drivers, see DataStax driver matrix and Developing applications with DataStax drivers.

The following Legacy drivers were developed for Apache Cassandra®. They are not actively maintained. DataStax recommends using supported DataStax drivers. Only use the following legacy drivers to migrate an existing Cassandra application developed with a legacy driver to Astra DB:

If you are using a driver for an unsupported language, consider using DataStax CQL Proxy, that can enable unsupported drivers to work with Astra DB Classic.

DataStax CQL Proxy simplifies connecting to Astra DB Classic without having to change your Cassandra driver, driver version, or framework. This open source tool securely forwards your application’s CQL traffic to an appropriate database service, including automatically discovering Astra DB Classic and configuring a connection to it.

Astra Portal

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

For fine-grained data manipulation and nuanced searches, you must use a programmatic approach, such as the Data API.

If your organization has strict firewall rules, you might need to authorize the following ports and third-party domains to access the Astra Portal:

  • app.pendo.io

  • sdk.split.io

  • 443: APIs and Astra DB metrics

  • 29000-32767: Other services

If these ports and domains aren’t authorized, browsers can render the Astra Portal incorrectly and some functionality can be unavailable.

Was this helpful?

Give Feedback

How can we improve the documentation?

© 2024 DataStax | Privacy policy | Terms of use

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: +1 (650) 389-6000, info@datastax.com