Merge pull request #115273 from MicrosoftDocs/release-build-cosmosdb

Release build Cosmos DB

Author: SyntaxC4

.openpublishing.redirection.json

@@ -2447,6 +2447,26 @@
       "redirect_url": "/azure/cosmos-db/how-to-multi-master",
       "redirect_document_id": true
     },
+    {
+      "source_path": "articles/cosmos-db/analytics-usecases.md",
+      "redirect_url": "/azure/cosmos-db/synapse-link",
+      "redirect_document_id": true
+    },
+    {
+      "source_path": "articles/cosmos-db/analytics-solution-architectures.md",
+      "redirect_url": "/azure/cosmos-db/synapse-link",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "articles/cosmos-db/lambda-architecture.md",
+      "redirect_url": "/azure/cosmos-db/synapse-link",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "articles/cosmos-db/globally-distributed-transactional-analytical-storage.md",
+      "redirect_url": "/azure/cosmos-db/synapse-link",
+      "redirect_document_id": false
+    },
     {
       "source_path": "articles/cosmos-db/sql-api-java-get-started.md",
       "redirect_url": "/azure/cosmos-db/create-sql-api-java",

articles/cosmos-db/TOC.yml

@@ -119,8 +119,6 @@
         href: global-dist-under-the-hood.md
       - name: Regional presence
         href: regional-presence.md
-      - name: Transactional and analytical storage
-        href: globally-distributed-transactional-analytical-storage.md
     - name: Partitioning
       items:
       - name: Partitioning overview
@@ -494,14 +492,16 @@
         href: change-feed-functions.md
       - name: Change feed pull model
         href: change-feed-pull-model.md
-    - name: Globally distributed analytics and AI
+    - name: Analytics with Synapse Link
       items:
-      - name: Analytics use cases
-        href: analytics-usecases.md
-      - name: Analytics - solution architectures
-        href: analytics-solution-architectures.md
-      - name: Lambda architecture
-        href: lambda-architecture.md
+      - name: Synapse Link for Azure Cosmos DB
+        href: synapse-link.md
+      - name: Analytical store - Overview
+        href: analytical-store-introduction.md
+      - name: Synapse Link FAQ
+        href: synapse-link-frequently-asked-questions.md
+      - name: Synapse Link use cases
+        href: synapse-link-use-cases.md
     - name: Built-in Jupyter notebooks
       items:
       - name: Jupyter notebooks overview
@@ -1020,6 +1020,10 @@
         href: how-to-migrate-from-change-feed-library.md
       - name: Change feed - Async Java sample
         href: create-sql-api-java-changefeed.md
+    - name: Analytics with Synapse Link
+      items:
+      - name: Configure Synapse Link
+        href: configure-synapse-link.md
     - name: Built-in analytics with Apache Spark
       items:
       - name: Azure Databricks Spark connector

articles/cosmos-db/analytical-store-introduction.md

@@ -99,9 +99,13 @@ Azure Cosmos DB Cassandra API is a managed service platform. It does not require
 
 * Azure portal's data explorer, metrics, log diagnostics, PowerShell, and CLI are other supported mechanisms to manage the account.
 
-## CQL Shell  
+## Hosted CQL shell (preview)
 
-CQLSH command-line utility comes with Apache Cassandra 3.1.1 and works out of box by setting some environment variables.
+You can open a hosted native Cassandra shell (CQLSH v5.0.1) directly from the Data Explorer in the [Azure portal](data-explorer.md) or the [Azure Cosmos explorer](https://cosmos.azure.com/). Before enabling the CQL shell, you must [enable the Notebooks](enable-notebooks.md) feature in your account (if not already enabled, you will be prompted when clicking on `Open Cassandra Shell`). Check the highlighted note in [Enable notebooks for Azure Cosmos DB accounts](enable-notebooks.md) for supported Azure Regions.
+
+![CQLSH](./media/cassandra-support/cqlsh.png)
+
+You can also connect to the Cassandra API in Azure Cosmos DB by using the CQLSH installed on a local machine. It comes with Apache Cassandra 3.1.1 and works out of the box by setting the environment variables. The following sections include the instructions to install, configure, and connect to Cassandra API in Azure Cosmos DB, on Windows or Linux using CQLSH.
 
 **Windows:**
 
@@ -193,9 +197,8 @@ ALTER TABLE gks1.t1 WITH cosmosdb_provisioned_throughput=10000 ;
 
 ## Usage of Cassandra retry connection policy
 
-Azure Cosmos DB is a resource governed system. This means you can do a certain number of operations in a given second based on the request units consumed by the operations. If an application exceeds that limit in a given second,  requests are rate-limited and exceptions will be thrown. The Cassandra API in Azure Cosmos DB translates these exceptions to overloaded errors on the Cassandra native protocol. To ensure that your application can intercept and retry requests in case rate limitation, the [spark](https://mvnrepository.com/artifact/com.microsoft.azure.cosmosdb/azure-cosmos-cassandra-spark-helper) and the [Java](https://github.com/Azure/azure-cosmos-cassandra-extensions) extensions are provided. If you use other SDKs to access Cassandra API in Azure Cosmos DB, create a connection policy to retry on these exceptions.
+Azure Cosmos DB is a resource governed system. This means you can do a certain number of operations in a given second based on the request units consumed by the operations. If an application exceeds that limit in a given second,  requests are rate-limited and exceptions will be thrown. The Cassandra API in Azure Cosmos DB translates these exceptions to overloaded errors on the Cassandra native protocol. To ensure that your application can intercept and retry requests in case of rate limitation, the [spark](https://mvnrepository.com/artifact/com.microsoft.azure.cosmosdb/azure-cosmos-cassandra-spark-helper) and the [Java](https://github.com/Azure/azure-cosmos-cassandra-extensions) extensions are provided. See also Java code samples for [version 3](https://github.com/Azure-Samples/azure-cosmos-cassandra-java-retry-sample) and [version 4](https://github.com/Azure-Samples/azure-cosmos-cassandra-java-retry-sample-v4) Datastax drivers, when connecting to Cassandra API in Azure Cosmos DB. If you use other SDKs to access Cassandra API in Azure Cosmos DB, create a connection policy to retry on these exceptions.
 
 ## Next steps
 
 - Get started with [creating a Cassandra API account, database, and a table](create-cassandra-api-account-java.md) by using a Java application
-