Getting started with DataStax Apollo on Constellation

Create an account and then create a database to get started with DataStax Apollo on Constellation.

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

  1. Create an Apollo database.
  2. Download the secure connect bundle.
  3. Connect to your database.

Creating a DataStax Apollo database

Create and launch an Apollo database.

Complete the following steps to create and launch an Apollo database using the DataStax Constellation console.

Procedure

  1. Open a browser, navigate to the DataStax Constellation console, and log in.
  2. Click Create New Database.
  3. In the Create New Database page, select AWS as the cloud provider.
  4. 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).
  5. 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 naming convention.
    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 Apollo on Constellation 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.
  6. Choose the compute size for the database.
    Note: Compute size cannot be changed after database creation. However, you can add CUs to increase the storage size of the database for the selected service tier.
    • Developer: low-cost development option, 25 GB storage.
    • Startup: starter configuration for development and light production workloads.
    • Standard: higher throughput, lower latency, 99.9% uptime SLA, plus support.
    • Enterprise: highest throughput, lowest latency, 99.99% uptime SLA, and best support tier.
  7. 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.

  8. If this is your first database, click Enter Payment Details.
    1. Enter the required credit card information and associated billing details.
    2. Click Submit to save the entered billing information.
  9. Click Launch Database to create the database.

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

Results

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 Apollo 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

If you chose the Developer tier as the compute size, then your database has a 25 GB capacity, which is great to start development.

All Apollo databases are created with a replication factor of three to provide optimal uptime and data integrity. By default, each Apollo 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 Apollo database limits.

CAUTION: To ensure you experience the latest, most stable deployment, all databases 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 Apollo 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 Apollo 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 Apollo 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 Apollo database.
I know CQL and want to connect quickly to use my database. Use the CQL shell 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 Apollo database.

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

Prerequisites

Create an Apollo database using the DataStax Constellation console.

Procedure

  1. Open a browser, navigate to the DataStax Constellation console, 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 secure-connect-database_name.zip 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 secure-connect-database_name.zip file:
    curl -L "<secure-connect-database_name-download-URL>" > database_name.zip

What's next

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