Skip to content

Commit 691dfa7

Browse files
Merge pull request #232593 from vmagelo/freshness-work2
Freshness pass - proposal for changes.
2 parents a758f90 + 2b1c59f commit 691dfa7

File tree

2 files changed

+21
-16
lines changed

2 files changed

+21
-16
lines changed

articles/cosmos-db/cassandra/manage-data-python.md

Lines changed: 11 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ ms.service: cosmos-db
77
ms.subservice: apache-cassandra
88
ms.devlang: python
99
ms.topic: quickstart
10-
ms.date: 08/13/2020
10+
ms.date: 04/03/2023
1111
ms.custom: devx-track-python, mode-api, ignite-2022, py-fresh-zinc
1212
---
1313
# Quickstart: Build a Cassandra app with Python SDK and Azure Cosmos DB
@@ -28,7 +28,7 @@ In this quickstart, you create an Azure Cosmos DB for Apache Cassandra account,
2828
## Prerequisites
2929

3030
- An Azure account with an active subscription. [Create one for free](https://azure.microsoft.com/free/?ref=microsoft.com&utm_source=microsoft.com&utm_medium=docs&utm_campaign=visualstudio). Or [try Azure Cosmos DB for free](../try-free.md) without an Azure subscription.
31-
- [Python 2.7 or 3.6+](https://www.python.org/downloads/).
31+
- [Python 3.7+](https://www.python.org/downloads/).
3232
- [Git](https://git-scm.com/downloads).
3333
- [Python Driver for Apache Cassandra](https://github.com/datastax/python-driver).
3434

@@ -40,7 +40,7 @@ Before you can create a document database, you need to create a Cassandra accoun
4040

4141
## Clone the sample application
4242

43-
Now let's clone a API for Cassandra app from GitHub, set the connection string, and run it. You see how easy it is to work with data programmatically.
43+
Now let's clone an API for Cassandra app from GitHub, set the connection string, and run it. You see how easy it's to work with data programmatically.
4444

4545
1. Open a command prompt. Create a new folder named `git-samples`. Then, close the command prompt.
4646

@@ -104,7 +104,13 @@ Now go back to the Azure portal to get your connection string information and co
104104
105105
Line 10 should now look similar to
106106
107-
`'contactPoint': 'cosmos-db-quickstarts.cassandra.cosmosdb.azure.com:10350'`
107+
`'contactPoint': 'cosmos-db-quickstarts.cassandra.cosmosdb.azure.com'`
108+
109+
1. Paste the PORT value from the portal over `<FILLME>` on line 12.
110+
111+
Line 12 should now look similar to
112+
113+
`'port': 10350,`
108114
109115
1. Copy the USERNAME value from the portal and paste it over `<FILLME>` on line 6.
110116
@@ -119,16 +125,6 @@ Now go back to the Azure portal to get your connection string information and co
119125
`'password' = '2Ggkr662ifxz2Mg==`';`
120126
121127
1. Save the *config.py* file.
122-
123-
## Use the X509 certificate
124-
125-
1. Copy the Baltimore CyberTrust Root certificate details from [https://www.digicert.com/kb/digicert-root-certificates.htm](https://www.digicert.com/kb/digicert-root-certificates.htm) into a text file. Save the file using the file extension *.cer*.
126-
127-
The certificate has serial number `02:00:00:b9` and SHA1 fingerprint `d4:de:20:d0:5e:66:fc:53:fe:1a:50:88:2c:78:db:28:52:ca:e4:74`.
128-
129-
2. Open *pyquickstart.py* and change the `path\to\cert` to point to your new certificate.
130-
131-
3. Save *pyquickstart.py*.
132128
133129
## Run the Python app
134130
@@ -172,7 +168,7 @@ Now go back to the Azure portal to get your connection string information and co
172168
173169
## Next steps
174170
175-
In this quickstart, you learned how to create an Azure Cosmos DB account with API for Cassandra, and run a Cassandra Python app that creates a Cassandra database and container. You can now import additional data into your Azure Cosmos DB account.
171+
In this quickstart, you learned how to create an Azure Cosmos DB account with API for Cassandra, and run a Cassandra Python app that creates a Cassandra database and container. You can now import other data into your Azure Cosmos DB account.
176172
177173
> [!div class="nextstepaction"]
178174
> [Import Cassandra data into Azure Cosmos DB](migrate-data.md)

articles/cosmos-db/includes/cosmos-db-create-dbaccount-cassandra.md

Lines changed: 10 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -17,17 +17,25 @@ ms.custom: include file, ignite-2022
1717

1818
1. On the **Azure Cosmos DB** page, select **Create**.
1919

20+
1. On the **API** page, select **Create** under the **Cassandra** section.
21+
22+
The API determines the type of account to create. Azure Cosmos DB provides five APIs: NoSQL for document databases, Gremlin for graph databases, MongoDB for document databases, Azure Table, and Cassandra. You must create a separate account for each API.
23+
24+
Select **Cassandra**, because in this quickstart you are creating a table that works with the API for Cassandra.
25+
26+
[Learn more about the API for Cassandra](../cassandra/introduction.md).
27+
2028
1. In the **Create Azure Cosmos DB Account** page, enter the basic settings for the new Azure Cosmos DB account.
2129

2230
|Setting|Value|Description |
2331
|---|---|---|
2432
| Subscription|Your subscription|Select the Azure subscription that you want to use for this Azure Cosmos DB account. |
2533
| Resource Group|Create new<br><br>Then enter the same name as Account Name|Select **Create new**. Then enter a new resource group name for your account. For simplicity, use the same name as your Azure Cosmos DB account name. |
2634
| Account Name|Enter a unique name|Enter a unique name to identify your Azure Cosmos DB account. Your account URI will be *cassandra.cosmos.azure.com* appended to your unique account name.<br><br>The account name can use only lowercase letters, numbers, and hyphens (-), and must be between 3 and 31 characters long.|
27-
| API|Cassandra|The API determines the type of account to create. Azure Cosmos DB provides five APIs: NoSQL for document databases, Gremlin for graph databases, MongoDB for document databases, Azure Table, and Cassandra. You must create a separate account for each API. <br><br>Select **Cassandra**, because in this quickstart you are creating a table that works with the API for Cassandra. <br><br>[Learn more about the API for Cassandra](../cassandra/introduction.md).|
2835
|Location|The region closest to your users|Select a geographic location to host your Azure Cosmos DB account. Use the location that is closest to your users to give them the fastest access to the data.|
2936
|Capacity mode|Provisioned throughput or Serverless|Select **Provisioned throughput** to create an account in [provisioned throughput](../set-throughput.md) mode. Select **Serverless** to create an account in [serverless](../serverless.md) mode.|
3037
|Apply Azure Cosmos DB free tier discount|**Apply** or **Do not apply**|With Azure Cosmos DB free tier, you will get the first 1000 RU/s and 25 GB of storage for free in an account. Learn more about [free tier](https://azure.microsoft.com/pricing/details/cosmos-db/).|
38+
|Limit total account throughput|Select to limit throughput of the account|This is useful if you want to limit the total throughput of the account to a specific value.|
3139

3240
> [!NOTE]
3341
> You can have up to one free tier Azure Cosmos DB account per Azure subscription and must opt-in when creating the account. If you do not see the option to apply the free tier discount, this means another account in the subscription has already been enabled with free tier.
@@ -40,6 +48,7 @@ ms.custom: include file, ignite-2022
4048
|---|---|---|
4149
|Geo-Redundancy|Disable|Enable or disable global distribution on your account by pairing your region with a pair region. You can add more regions to your account later.|
4250
|Multi-region Writes|Disable|Multi-region writes capability allows you to take advantage of the provisioned throughput for your databases and containers across the globe.|
51+
|Availability Zones|Disable|Availability Zones are isolated locations within an Azure region. Each zone is made up of one or more datacenters equipped with independent power, cooling, and networking.|
4352

4453
> [!NOTE]
4554
> The following options are not available if you select **Serverless** as the **Capacity mode**:

0 commit comments

Comments
 (0)