Time to Complete
Modern applications are built on APIs, and JSON documents are the most common way of expressing data payloads on those APIs. Stargate makes it easy to serve a document-style API directly from any Cassandra database, allowing you to save and search schemaless JSON documents. This is a big deal, because the traditional practice for Cassandra has been to define all your schema up front.
A Document API represents your data as JSON documents organized in collections, similar to document databases such as MongoDB. Interact with data stored in collections with familiar HTTP methods (GET/PUT/POST/DELETE) to work directly with your JSON documents, without having to learn a new database query language. To use the API, you create a namespace for your application, which can contain one or more named collections, which in turn can contain multiple documents. The documents can have similar or different structures - that’s entirely up to your application and how you want to represent the data!Next concept: Why use the Document API with Cassandra?
Stargate is now available in DataStax Astra. If you have an Astra database, the Stargate GraphQL API is already enabled. If you don’t have a Cassandra cluster and want one, you can set up a database for free at astra.datastax.com. If you have access to your own self-hosted Cassandra cluster, see the Stargate documentation for a quickstart guide for installing and using the Document API.
Check out DataStax’s BattleStax demo application, a fullstack app that uses Stargate’s Document API, Astra, and Netlify.Next: Try it out
With the Stargate Document API you can save and search schemaless JSON documents in Cassandra. Here’s two ways you can try it yourself.
Getting started using the Stargate Document API on Astra.
Built around JSON-like documents, document model databases are both natural and flexible for developers to work with.
The Stargate open source project provides an API layer that allows you to expose a document-style API on top of any Cassandra database.
Astra now offers offers a Document API via Stargate, which allows you to use your Astra database as a document database. Create collections, add documents and modify them within your database.
In this scenario we will:
As a prerequisite, be sure to setup an Astra account and create a Cassandra as a Service database at astra.datastax.com.
Let's get started with Stargate Document API on Astra!
BattleStax: Creating a Serverless REST Endpoint.