DataStax Astra Developer Hub

Welcome to the DataStax Astra Developer Hub. You'll find comprehensive guides and documentation to help you start working with DataStax Astra as quickly as possible. Use the included APIs to create, modify, and terminate databases, and interact with the databases you create. Let's do it!

Astra Docs      API Reference      CQL for Astra

Creating your Astra database

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

Procedure

  1. In your DataStax Astra dashboard, select Add Database.

Select Add Database.

  1. Select your tier and plan based on your application needs. See Service tier options for a description of your plan options.

📘

Note

You cannot change your tier after creating your databasedatabase - A group of distributed instances for storing data. Each paid Astra database has at least three instances.. For paid tiers, you can increase your capacity unitcapacity unit - Represents three database instances grouped together with three replicas. (CUs) to increase the storage size of the database for the selected plan.

📘

Note

You can have only one Free database at a time.

  1. Select your cloud provider:
  • AWS
  • GCP
  • Azure

📘

Note

There is no choice for the cloud provider for the Free tier.

  1. Select the regionregion - A group of related nodes configured together within a database for replication purposes. A region is virtual datacenter hosted on your selected cloud provider. Using separate regions prevents transactions from being impacted by other workloads and lowers latency. Depending on the replication factor, data can be written to multiple regions. Regions cannot span physical locations. A region in Astra is the same concept as a "datacenter" in Apache Cassandra™ or DataStax Enterprise. where you want to launch your database from the region menu, which reflects the available regions based on your selected cloud provider.

📘

Note

You can preview estimated costs for the database Per Minute or Per Month. The estimates are calculated for when the database is running and parked.

  1. Select Configure to continue.
  2. Enter your database details:
    • Database Name: Name your database something meaningful. The database name cannot be altered after the database is created. Use only alphanumeric characters; there is no character limit.
    • Keyspace Name: Name your keyspacekeyspace - The defining container for replication, similar to a schema in a relational database. All tables belong to a keyspace. Each keyspace can contain as many as 200 tables. to reflect your data model. You can’t name your keyspace “dse” or “system”. Use only alphanumeric characters and no more than 48 total characters.
    • Database Username: Your username should be useful. You can’t name your user cassandra, root, dse, or system. Use only alphanumeric characters and no more than 48 total characters. Astra forces usernames to lowercase; enclose the name in quotes to preserve case or use special characters in the name.
    • Database Password: Make sure your password is secure. Use at least 8 alphanumeric characters. We recommend you use capital and lowercase letters along with numbers to keep your data safe. You must enter your database password again to confirm the password.
  3. Select Create Database.
  4. If you are creating your first database on a paid tier and you do not have a payment method available, enter and Save the required New Card information.
  5. Select Launch Database to create the database.

Results

You are redirected to your Organization Dashboard. The new database and status is shown under Databases.

You will receive an email when your database creation is complete. Select the database name to manage or connect with your new database.

Updated 24 days ago



Creating your Astra database


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

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.