Skip to content

Commit b8e53be

Browse files
authored
Merge pull request #219943 from seesharprun/cosmos-revise-api-intros
Cosmos DB | Rework API introduction articles
2 parents 59e007a + 8a9f44f commit b8e53be

File tree

6 files changed

+226
-213
lines changed

6 files changed

+226
-213
lines changed
Lines changed: 34 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -1,59 +1,63 @@
11
---
2-
title: Introduction to the Azure Cosmos DB for Apache Cassandra
3-
description: Learn how you can use Azure Cosmos DB to "lift-and-shift" existing applications and build new applications by using the Cassandra drivers and CQL
2+
title: Introduction
3+
titleSuffix: Azure Cosmos DB for Apache Cassandra
4+
description: Use Azure Cosmos DB for Apache Cassandra to power existing and new applications with Cassandra drivers and CQL.
45
author: TheovanKraay
56
ms.author: thvankra
67
ms.reviewer: mjbrown
78
ms.service: cosmos-db
89
ms.subservice: apache-cassandra
9-
ms.custom: ignite-2022
1010
ms.topic: overview
11-
ms.date: 11/25/2020
11+
ms.date: 11/30/2022
12+
ms.custom: ignite-2022
1213
---
1314

14-
# Introduction to the Azure Cosmos DB for Apache Cassandra
15+
# Introduction to Azure Cosmos DB for Apache Cassandra
16+
1517
[!INCLUDE[Cassandra](../includes/appliesto-cassandra.md)]
1618

17-
Azure Cosmos DB for Apache Cassandra can be used as the data store for apps written for [Apache Cassandra](https://cassandra.apache.org). This means that by using existing [Apache drivers](https://cassandra.apache.org/doc/latest/cassandra/getting_started/drivers.html?highlight=driver) compliant with CQLv4, your existing Cassandra application can now communicate with the Azure Cosmos DB for Apache Cassandra. In many cases, you can switch from using Apache Cassandra to using Azure Cosmos DB's API for Cassandra, by just changing a connection string.
19+
[Azure Cosmos DB](../introduction.md) is a fully managed NoSQL and relational database for modern app development.
1820

19-
The API for Cassandra enables you to interact with data stored in Azure Cosmos DB using the Cassandra Query Language (CQL) , Cassandra-based tools (like cqlsh) and Cassandra client drivers that you're already familiar with.
21+
Azure Cosmos DB for Apache Cassandra can be used as the data store for apps written for [Apache Cassandra](https://cassandra.apache.org). This compatibility means that by using existing [Apache drivers](https://cassandra.apache.org/doc/latest/cassandra/getting_started/drivers.html?highlight=driver) compliant with CQLv4, your existing Cassandra application can now communicate with the API for Cassandra. In many cases, you can switch from using Apache Cassandra to using the API for Cassandra, by just changing a connection string. The API for Cassandra enables you to interact with data stored in Azure Cosmos DB using the Cassandra Query Language (CQL), Cassandra-based tools (like cqlsh) and Cassandra client drivers that you're already familiar with.
2022

21-
> [!NOTE]
22-
> The [serverless capacity mode](../serverless.md) is now available on Azure Cosmos DB's API for Cassandra.
23+
> [!TIP]
24+
> Want to try the API for Cassandra with no commitment? Create an Azure Cosmos DB account using [Try Azure Cosmos DB](../try-free.md) for free.
2325
24-
## What is the benefit of using API for Apache Cassandra for Azure Cosmos DB?
26+
## API for Cassandra benefits
2527

26-
**No operations management**: As a fully managed cloud service, Azure Cosmos DB for Apache Cassandra removes the overhead of managing and monitoring a myriad of settings across OS, JVM, and yaml files and their interactions. Azure Cosmos DB provides monitoring of throughput, latency, storage, availability, and configurable alerts.
28+
The API for Cassandra has added benefits of being built on Azure Cosmos DB:
2729

28-
**Open source standard**: Despite being a fully managed service, API for Cassandra still supports a large surface area of the native [Apache Cassandra wire protocol](support.md), allowing you to build applications on a widely used and cloud agnostic open source standard.
30+
- **No operations management**: As a fully managed cloud service, API for Cassandra removes the overhead of managing and monitoring a myriad of settings across OS, JVM, and yaml files and their interactions. Azure Cosmos DB provides monitoring of throughput, latency, storage, availability, and configurable alerts.
2931

30-
**Performance management**: Azure Cosmos DB provides guaranteed low latency reads and writes at the 99th percentile, backed up by the SLAs. Users do not have to worry about operational overhead to ensure high performance and low latency reads and writes. This means that users do not need to deal with scheduling compaction, managing tombstones, setting up bloom filters and replicas manually. Azure Cosmos DB removes the overhead to manage these issues and lets you focus on the application logic.
32+
- **Open source standard**: Despite being a fully managed service, API for Cassandra still supports a large surface area of the native [Apache Cassandra wire protocol](support.md), allowing you to build applications on a widely used and cloud agnostic open source standard.
3133

32-
**Ability to use existing code and tools**: Azure Cosmos DB provides wire protocol level compatibility with existing Cassandra SDKs and tools. This compatibility ensures you can use your existing codebase with Azure Cosmos DB for Apache Cassandra with trivial changes.
34+
- **Performance management**: Azure Cosmos DB provides guaranteed low latency reads and writes at the 99th percentile, backed up by the SLAs. Users don't have to worry about operational overhead to ensure high performance and low latency reads and writes. This guarantee means that users don't need to deal with scheduling compaction, managing tombstones, setting up bloom filters and replicas manually. Azure Cosmos DB removes the overhead to manage these issues and lets you focus on the application logic.
3335

34-
**Throughput and storage elasticity**: Azure Cosmos DB provides throughput across all regions and can scale the provisioned throughput with Azure portal, PowerShell, or CLI operations. You can [elastically scale](scale-account-throughput.md) storage and throughput for your tables as needed with predictable performance.
36+
- **Ability to use existing code and tools**: Azure Cosmos DB provides wire protocol level compatibility with existing Cassandra SDKs and tools. This compatibility ensures you can use your existing codebase with API for Cassandra while only making trivial changes.
3537

36-
**Global distribution and availability**: Azure Cosmos DB provides the ability to globally distribute data across all Azure regions and serve the data locally while ensuring low latency data access and high availability. Azure Cosmos DB provides 99.99% high availability within a region and 99.999% read and write availability across multiple regions with no operations overhead. Learn more in [Distribute data globally](../distribute-data-globally.md) article.
38+
- **Throughput and storage elasticity**: Azure Cosmos DB provides throughput across all regions and can scale the provisioned throughput with Azure portal, PowerShell, or CLI operations. You can [elastically scale](scale-account-throughput.md) storage and throughput for your tables as needed with predictable performance.
3739

38-
**Choice of consistency**: Azure Cosmos DB provides the choice of five well-defined consistency levels to achieve optimal tradeoffs between consistency and performance. These consistency levels are strong, bounded-staleness, session, consistent prefix and eventual. These well-defined, practical, and intuitive consistency levels allow developers to make precise trade-offs between consistency, availability, and latency. Learn more in [consistency levels](../consistency-levels.md) article.
40+
- **Global distribution and availability**: Azure Cosmos DB globally distributes data across all Azure regions and serves the data locally while ensuring low latency data access and high availability. Azure Cosmos DB provides 99.99% high availability within a region and 99.999% read and write availability across multiple regions with no operations overhead. For more information, see [distribute data globally](../distribute-data-globally.md).
3941

40-
**Enterprise grade**: Azure Cosmos DB provides [compliance certifications](https://www.microsoft.com/trustcenter) 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.
42+
- **Choice of consistency**: Azure Cosmos DB provides the choice of five well-defined consistency levels to achieve optimal tradeoffs between consistency and performance. These consistency levels are strong, bounded-staleness, session, consistent prefix and eventual. These consistency levels allow developers to make precise trade-offs between consistency, availability, and latency. For more information, see [consistency levels](../consistency-levels.md).
4143

42-
**Event Sourcing**: API for Cassandra provides access to a persistent change log, the [Change Feed](change-feed.md), which can facilitate event sourcing directly from the database. In Apache Cassandra, the only equivalent is change data capture (CDC), which is merely a mechanism to flag specific tables for archival as well as rejecting writes to those tables once a configurable size-on-disk for the CDC log is reached (these capabilities are redundant in Azure Cosmos DB as the relevant aspects are automatically governed).
44+
- **Enterprise grade**: Azure Cosmos DB provides [compliance certifications](https://www.microsoft.com/trustcenter) 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.
45+
46+
- **Event Sourcing**: The API for Cassandra provides access to a persistent change log, the [Change Feed](change-feed.md). The change feed can facilitate event sourcing directly from the database. In Apache Cassandra, change data capture (CDC) is the only equivalent feature. CDC is merely a mechanism to flag specific tables for archival and rejecting writes to those tables once a configurable size-on-disk for the CDC log is reached. These capabilities are redundant in Azure Cosmos DB as the relevant aspects are automatically governed.
4347

4448
## Next steps
4549

46-
* You can quickly get started with building the following language-specific apps to create and manage API for Cassandra data:
50+
> [!div class="nextstepaction"]
51+
> [Get started with our Python Quickstart](manage-data-python.md)
52+
53+
Want to learn more?
54+
55+
- You can quickly get started with building the following language-specific apps to create and manage API for Cassandra data:
4756
- [Node.js app](manage-data-nodejs.md)
4857
- [.NET app](manage-data-dotnet.md)
4958
- [Python app](manage-data-python.md)
50-
51-
* Get started with [creating a API for Cassandra account, database, and a table](create-account-java.md) by using a Java application.
52-
53-
* [Load sample data to the API for Cassandra table](load-data-table.md) by using a Java application.
54-
55-
* [Query data from the API for Cassandra account](query-data.md) by using a Java application.
56-
57-
* To learn about Apache Cassandra features supported by Azure Cosmos DB for Apache Cassandra, see [Cassandra support](support.md) article.
58-
59-
* Read the [Frequently Asked Questions](cassandra-faq.yml).
59+
- Get started with [creating a API for Cassandra account, database, and a table](create-account-java.md) by using a Java application.
60+
- [Load sample data to the API for Cassandra table](load-data-table.md) by using a Java application.
61+
- [Query data from the API for Cassandra account](query-data.md) by using a Java application.
62+
- To learn about Apache Cassandra features supported by Azure Cosmos DB for Apache Cassandra, see [Cassandra support](support.md) article.
63+
- Read the [Frequently Asked Questions](cassandra-faq.yml).

0 commit comments

Comments
 (0)