Illustration Image

Cassandra.Link

The best knowledge base on Apache Cassandra®

Helping platform leaders, architects, engineers, and operators build scalable real time data platforms.

8/28/2018

Reading time:5 min

Introduction to the Azure Cosmos DB Cassandra API

by John Doe


 Contributors
 Azure Cosmos DB provides the Cassandra API (preview) for applications that are written for Apache Cassandra that need premium capabilities like:Scalable storage size and throughput.Turn-key global distributionSingle-digit millisecond latencies at the 99th percentile.Five well-defined consistency levelsAutomatic indexing of data without requiring you to deal with schema and index management. Guaranteed high availability, all backed by industry-leading SLAsWhat is the Azure Cosmos DB Apache Cassandra API?Azure Cosmos DB can be used as the data store for apps written for Apache Cassandra, by using the Apache Cassandra API. This means that by using existing Apache licensed drivers compliant with CQLv4, your application written for Cassandra can now communicate with the Azure Cosmos DB Cassandra API. In many cases, you can switch from using Apache Cassandra to using Azure Cosmos DB 's Apache Cassandra API, by simply changing a connection string. Using this functionality, you can easily build and run Cassandra API database applications in the Azure cloud with Azure Cosmos DB's global distribution and comprehensive industry-leading SLAs, while continuing to use familiar skills and tools for Cassandra API.The Cassandra API enables you to interact with data stored in Azure Cosmos DB using the Cassandra Query Language based tools (like CQLSH) and Cassandra client drivers you’re already familiar with. Learn more about it in this Microsoft Mechanics video with Principal Engineering Manager Kirill Gavrylyuk.What is the benefit of using Apache Cassandra API for Azure Cosmos DB?No operations management: As a true fully managed service, Azure Cosmos DB ensures that Cassandra API administrators do not have to worry about managing and monitoring a myriad settings across OS, JVM, and yaml files and their interplay. Azure Cosmos DB provides monitoring of throughput, latency, storage and availability, and configurable alerts. Performance management: Azure Cosmos DB provides SLA backed low latency reads and writes for the 99th percentile. Users do not need to worry about lot of operational overhead to provide good read and write SLAs. These typically include scheduling compaction, managing tombstones, bloom filters setting, and replica lags. Azure Cosmos DB takes away the worry of managing these issues and lets you focus on the application deliverables.Automatic indexing: Azure Cosmos DB automatically indexes all the columns of table in Cassandra API database. Azure Cosmos DB does not require creation of secondary indices to speed up queries. It provides low latency read and write experience while doing automatic consistent indexing. Ability to use existing code and tools: Azure Cosmos DB provides wire protocol level compatibility with existing SDKs and tools. This compatibility ensures you can use your existing codebase with Cassandra API of Azure Cosmos DB with trivial changes.Throughput and storage elasticity: Azure Cosmos platform provides elasticity of guaranteed throughput across regions via simple portal, PowerShell, or CLI operations. You can elastically scale Azure Cosmos DB Tables with predictable performance seamlessly as your application grows. Azure Cosmos DB supports Cassandra API tables that can scale to virtually unlimited storage sizes. Global distribution and availability: Azure Cosmos DB provides the ability to distribute data throughout Azure regions to enable users with a low latency experience while ensuring availability. Azure Cosmos DB provides 99.99% availability within a region and 99.999% read availability across the regions with no operations overhead. Azure Cosmos DB is available in 30+ Azure Regions. Learn more in Distribute data globally. Choice of consistency: Azure Cosmos DB provides the choice of five well-defined consistency levels to achieve optimal trade-off between consistency and performance. These consistency levels are strong, bounded-staleness, session, consistent prefix, and eventual. These granular, well-defined consistency levels allow developer to make sound trade-offs between consistency, availability, and latency. Learn more in Using consistency levels to maximize availability and performance. Enterprise grade: Azure cosmos DB provides compliance certifications to ensure users can use the platform securely. Azure Cosmos DB also provides encryption at rest and in motion, IP firewall, and audit logs for control plane activities. If you already have an Azure subscription, you can sign up to join the Cassandra API (preview) program in the Azure portal. If you’re new to Azure, sign up for a free trial where you get 12 months of free access to Azure Cosmos DB. Complete the following steps to request access to the Cassandra API (preview) program.In the Azure portal, click Create a resource > Databases > Azure Cosmos DB. In the New Account page, select Cassandra in the API box. In the Subscription box, select the Azure subscription that you want to use for this account.Click Sign up to preview today. In the Sign up to preview today pane, click OK. Once you submit the request, the status changes to Pending approval in the New account pane. After you submit your request, wait for email notification that your request has been approved. Due to the high volume of requests, you should receive notification within a week. You do not need to create a support ticket to complete the request. Requests will be reviewed in the order in which they were received. How to get startedOnce you've joined the preview program, follow the Cassandra API quickstarts to create an app by using the Cassandra API:Quickstart: Build a Cassandra web app with Node.js and Azure Cosmos DBQuickstart: Build a Cassandra web app with Java and Azure Cosmos DBQuickstart: Build a Cassandra web app with .NET and Azure Cosmos DBQuickstart: Build a Cassandra web app with Python and Azure Cosmos DBNext stepsInformation about the Azure Cosmos DB Cassandra API is integrated into the overall Azure Cosmos DB documentation, but here are a few pointers to get you started:Follow the Quickstarts to create an account and a new app by using a Git sampleFollow the Tutorial to create a new app programmatically.Follow the Import Cassandra data tutorial to import your existing data into Azure Cosmos DB.Read the FAQ.

Illustration Image

Azure Cosmos DB provides the Cassandra API (preview) for applications that are written for Apache Cassandra that need premium capabilities like:

What is the Azure Cosmos DB Apache Cassandra API?

Azure Cosmos DB can be used as the data store for apps written for Apache Cassandra, by using the Apache Cassandra API. This means that by using existing Apache licensed drivers compliant with CQLv4, your application written for Cassandra can now communicate with the Azure Cosmos DB Cassandra API. In many cases, you can switch from using Apache Cassandra to using Azure Cosmos DB 's Apache Cassandra API, by simply changing a connection string. Using this functionality, you can easily build and run Cassandra API database applications in the Azure cloud with Azure Cosmos DB's global distribution and comprehensive industry-leading SLAs, while continuing to use familiar skills and tools for Cassandra API.

Azure Cosmos DB Cassandra API

The Cassandra API enables you to interact with data stored in Azure Cosmos DB using the Cassandra Query Language based tools (like CQLSH) and Cassandra client drivers you’re already familiar with. Learn more about it in this Microsoft Mechanics video with Principal Engineering Manager Kirill Gavrylyuk.

What is the benefit of using Apache Cassandra API for Azure Cosmos DB?

No operations management: As a true fully managed service, Azure Cosmos DB ensures that Cassandra API administrators do not have to worry about managing and monitoring a myriad settings across OS, JVM, and yaml files and their interplay. Azure Cosmos DB provides monitoring of throughput, latency, storage and availability, and configurable alerts.

Performance management: Azure Cosmos DB provides SLA backed low latency reads and writes for the 99th percentile. Users do not need to worry about lot of operational overhead to provide good read and write SLAs. These typically include scheduling compaction, managing tombstones, bloom filters setting, and replica lags. Azure Cosmos DB takes away the worry of managing these issues and lets you focus on the application deliverables.

Automatic indexing: Azure Cosmos DB automatically indexes all the columns of table in Cassandra API database. Azure Cosmos DB does not require creation of secondary indices to speed up queries. It provides low latency read and write experience while doing automatic consistent indexing.

Ability to use existing code and tools: Azure Cosmos DB provides wire protocol level compatibility with existing SDKs and tools. This compatibility ensures you can use your existing codebase with Cassandra API of Azure Cosmos DB with trivial changes.

Throughput and storage elasticity: Azure Cosmos platform provides elasticity of guaranteed throughput across regions via simple portal, PowerShell, or CLI operations. You can elastically scale Azure Cosmos DB Tables with predictable performance seamlessly as your application grows. Azure Cosmos DB supports Cassandra API tables that can scale to virtually unlimited storage sizes.

Global distribution and availability: Azure Cosmos DB provides the ability to distribute data throughout Azure regions to enable users with a low latency experience while ensuring availability. Azure Cosmos DB provides 99.99% availability within a region and 99.999% read availability across the regions with no operations overhead. Azure Cosmos DB is available in 30+ Azure Regions. Learn more in Distribute data globally.

Choice of consistency: Azure Cosmos DB provides the choice of five well-defined consistency levels to achieve optimal trade-off between consistency and performance. These consistency levels are strong, bounded-staleness, session, consistent prefix, and eventual. These granular, well-defined consistency levels allow developer to make sound trade-offs between consistency, availability, and latency. Learn more in Using consistency levels to maximize availability and performance.

Enterprise grade: Azure cosmos DB provides compliance certifications to ensure users can use the platform securely. Azure Cosmos DB also provides encryption at rest and in motion, IP firewall, and audit logs for control plane activities.

If you already have an Azure subscription, you can sign up to join the Cassandra API (preview) program in the Azure portal. If you’re new to Azure, sign up for a free trial where you get 12 months of free access to Azure Cosmos DB. Complete the following steps to request access to the Cassandra API (preview) program.

  1. In the Azure portal, click Create a resource > Databases > Azure Cosmos DB.

  2. In the New Account page, select Cassandra in the API box.

  3. In the Subscription box, select the Azure subscription that you want to use for this account.

  4. Click Sign up to preview today.

    Azure Cosmos DB Cassandra API

  5. In the Sign up to preview today pane, click OK.

    Once you submit the request, the status changes to Pending approval in the New account pane.

After you submit your request, wait for email notification that your request has been approved. Due to the high volume of requests, you should receive notification within a week. You do not need to create a support ticket to complete the request. Requests will be reviewed in the order in which they were received.

How to get started

Once you've joined the preview program, follow the Cassandra API quickstarts to create an app by using the Cassandra API:

Next steps

Information about the Azure Cosmos DB Cassandra API is integrated into the overall Azure Cosmos DB documentation, but here are a few pointers to get you started:

Related Articles

node
api
cosmos

Create a profile app with Node.js using the API for Cassandra

TheovanKraay

3/7/2024

Checkout Planet Cassandra

Claim Your Free Planet Cassandra Contributor T-shirt!

Make your contribution and score a FREE Planet Cassandra Contributor T-Shirt! 
We value our incredible Cassandra community, and we want to express our gratitude by sending an exclusive Planet Cassandra Contributor T-Shirt you can wear with pride.

Join Our Newsletter!

Sign up below to receive email updates and see what's going on with our company

Explore Related Topics

AllKafkaSparkScyllaSStableKubernetesApiGithubGraphQl

Explore Further

cassandra