Getting started with DataStax Astra on Google Cloud

Create an account and then create a database to get started with DataStax Astra on Google Cloud.

To get started with DataStax Astra on Google Cloud, create your first database. Then, download the secure connect bundle from the DataStax Cloud console and connect to your DataStax Astra database:

  1. Access the DataStax Astra API.
  2. Create an Astra database.
  3. Download the secure connect bundle.
  4. Connect to your database.

Accessing the DataStax Astra API

Access and enable the DataStax Astra API from Google Cloud Platform.

You access and enable the DataStax Astra API from Google Cloud Platform. After authorizing the service, you can enable the DataStax Astra API and access the DataStax Cloud console, where you can create an Astra database.


This procedure assumes the following requirements:
  • You are part of an Organization resource in Google Cloud Platform.
  • You have access to a project in Google Cloud Platform with permissions to authorize APIs and services.


  1. Log in to Google Cloud Platform.
  2. Access the DataStax Astra API in Google Cloud Platform.
  3. Enable the DataStax Astra API service.
    • If this is your first time accessing the DataStax Astra API service, click Purchase Plan. Enter the required information to authorize the service and begin adding charges for any resources on the associated account.
    • If you previously authorized the service, click Enable.
  4. In the DataStax Astra API service, click Overview in the left navigation, if not already selected.
  5. Click Manage via DataStax to open the DataStax Cloud console.
    A window opens asking whether you want to share your project number and user ID. Click Confirm.


The DataStax Cloud console opens in a new browser tab, and you are logged in automatically.
Note: If this is your first time accessing the DataStax Cloud console, you are prompted to verify your email address:
  1. Follow the instructions in the dialog that displays to link your Google Cloud Platform account.
  2. Open your email and click the verification link, which directs you to the DataStax Cloud console.
  3. Read through the DataStax Beta Program Terms, and click Accept to log in to the DataStax Cloud console.

What's next

You can now Create an Astra database from the DataStax Cloud console using DataStax Astra on Google Cloud.

Creating a DataStax Astra database

Create and launch an Astra database.

Complete the following steps to create and launch an Astra database using the DataStax Cloud console.


Access the DataStax Astra API.


  1. Choose the compute size for the database.
    Note: Compute size cannot be changed after database creation. However, you can add Compute Units (CUs) to increase the storage size of the database for the selected service tier.
    • Free: Free, with 10 GB storage.
      Note: You can have only one active database on the Free tier.
    • C10: Starter configuration for development and light production workloads.
  2. Select the region where you want to launch your database from the dropdown menu.
    Note: Premium regions are denoted by an icon with double dollar signs (Premium region icon).
  3. Define the database details:
    1. Enter a name for the database.
      Important: The database name cannot be altered after the database is created. When entering a database name, use a meaningful name.
    2. Enter the keyspace name where tables for the database will be created.
    3. Enter the name of the database user, which can be reentered as the database user for additional databases.

      DataStax Astra on Google Cloud forces all names to lowercase; enclose the name in quotes to preserve case or use special characters in the name.

      CAUTION: Do not enter cassandra as the username for the database. By default, cassandra is reserved as the superuser.
    4. Enter a password for the database user.
  4. To view estimated costs for the database, select Per Minute or Per Month.

    The estimates are calculated for when the database is running and parked.

  5. Click Launch Database to create the database.

    A message indicates the database creation start time and an estimated time to complete database creation.


An email is sent when database creation is complete, including a link to the database. Click View Database to view your database.

What's next

  1. Take a tour of your database and learn about how you can use it.
  2. When the database is active, obtain access credentials for connecting your database.
  3. Connect to your database using DataStax Studio, CQLSH, or one of the DataStax drivers.

Using your new database

Learn about your new database and how you can get connected.

Welcome! While your Astra database is being created, let's cover some basics and review how you can get connected.

Your database

Your database provides the following specifications:

  • A single datacenter
  • A single keyspace
  • 500 GB of storage
  • Capacity for up to 200 tables
Note: If you chose the Free tier as the compute size, then your database has a 10 GB capacity, which is great to start development.

All Astra databases are created with a replication factor of three to provide optimal uptime and data integrity. By default, each Astra database launches with one capacity unit (CU), which represents three database nodes that are grouped together.

You can later resize the database to increase the number of CUs if required.

To better understand your database capabilities, review the DataStax Astra database limits.

CAUTION: To ensure you experience the latest, most stable deployment, all databases (except the Free tier) will be automatically removed every 72 hours to the most recently updated binaries.

All data in the database will be deleted when the database is terminated.

No configuration necessary

Use the integrated DataStax Studio instance, which is preconfigured to work with your Astra database. No configuration required. Even better, we added a DataStax Studio notebook that you can use to create tables in your keyspace, generate data, and learn the Cassandra Query Language (CQL) as you go.

CQL is the primary language for communicating with your Astra database. Use CQL to insert, update, and query data in tables, drop tables, and much more. Like SQL, CQL statements change data, look up data, store data, or change the way data is stored. If you're new to CQL, see the DataStax documentation for understanding the CQL command syntax.

Use CQL in the provided DataStax Studio notebook to interact with data:

Animated gif of a user entering CQL commands in a DataStax Studio notebook, with data returning after submitting the commands.

You have apps

We bet you do! If you want to connect those apps to your Astra database, you need the DataStax drivers. As an application developer, the drivers are your primary resource for creating solutions. Think of the drivers as on-ramps for connecting apps to your Cassandra database.

If you're new to DataStax drivers, review the best practices. These guidelines cover the rules and recommendations for improving performance and minimizing resource utilization in applications that use DataStax drivers.

After reviewing the best practices, download the driver for your preferred language. You can then use the guide for your selected driver to learn more about submitting queries and handling error conditions.

Get connected

When your database is active, it's time to get connected. There are multiple ways to connect to your database, depending on your familiarity with CQL and how you want to connect.

First, download the secure connect bundle for your database. Then, choose the option that best fits your experience and intended interaction:

Table 1. How do you want to connect?
Choices Options
I'm new to CQL, but want to use my database right now. Write queries, visualize results, and inspect the database schema using DataStax Studio, which is integrated into your Astra database.
I know some CQL and want to connect quickly to use my database. Use the integrated CQLSH console or the standalone CQLSH tool to interact with your database using CQL.
I have a DSE or DDAC cluster running and want to use the native CQL shell. Install DataStax Enterprise (DSE) or DataStax Distribution of Apache Cassandra (DDAC) locally or on a remote machine to interact with the database and run queries using the CQL shell (cqlsh).
I have an application and want to use the DataStax drivers. Initialize one of the DataStax drivers to manage database connections for your application.

Obtaining database credentials

Download the connection credentials for your Astra database.

To connect to your Astra database, download the secure database bundle from the DataStax Cloud console that contains the connection credentials.


Create an Astra database using the DataStax Cloud console.


  1. Open a browser, navigate to DataStax Astra for Apache Cassandra, and log in.
  2. From the Databases page, under Actions, click the ellipsis () for the database you want to connect to and select Connection details.
  3. In the Connection Details window, click Download secure connect bundle to download the file.

    This file contains the security certificates and credentials for your database.

    Tip: Alternatively, you can right-click the Download credentials link, copy the link source, and then use a curl command to download the file:
    curl -L "<secure-connect-database_name-download-URL>" >

What's next

Use one of the following methods to connect to your Astra database to issue CQL commands and begin developing your application.