Cosmos DB Link

Author: ArnoMicrosoft

articles/synapse-analytics/cosmos-db-integration/concept-cosmos-db-support.md

@@ -1,6 +1,6 @@
 ---
-title: Connect Cosmos DB to Synapse workspace  
-description: How to connect a Cosmos DB to a Synapse workspace
+title: Connect to Synapse Link for Cosmos DB
+description: How to connect a Cosmos DB to a Synapse workspace with Synapse Link
 services: synapse-analytics 
 author: acomet
 ms.service: synapse-analytics 
@@ -11,9 +11,9 @@ ms.author: acomet
 ms.reviewer: jrasnick
 ---
 
-# Connect and access an Azure Cosmos DB database (preview) in Azure Synapse Analytics
+# Connect to Synapse Link for Cosmos DB
 
-This article describes how to access an Azure Cosmos database from Azure Synapse Analytics studio.
+This article describes how to access an Azure Cosmos database from Azure Synapse Analytics studio with Synapse Link. 
 
 ## Prerequisites
 
@@ -24,7 +24,7 @@ Before you connect a Cosmos DB account to your workspace, there are a few things
 
 ## Enable Cosmos DB analytical store
 
-To run large-scale analytics into Cosmos DB without impacting your operational performance, we recommend using HTAP collections. HTAP collections can be enabled through the analytical store. Follow this quickstart to enable HTAP containers.
+To run large-scale analytics into Cosmos DB without impacting your operational performance, we recommend enabling  Synapse Link for Cosmos DB which bring HTAP capability to a container and built-in support in Azure Synapse. Follow this quickstart to enable Synapse Link  for Cosmos DB containers.
 
 ## Connect a Cosmos DB database to a Synapse workspace 
 
@@ -35,24 +35,24 @@ From the Data Object Explorer, you can directly connect a Cosmos DB database by
 2. Select **Connect to external data**
 3. Select the API that you want to connect to: SQL or MongoDB
 4. Select ***Continue***
-5. Name the linked service. The name will be displayed in the Object Explorer and used by Synapse run-times to connect to the database and collections. We recommend using a friendly name.
+5. Name the linked service. The name will be displayed in the Object Explorer and used by Synapse run-times to connect to the database and containers. We recommend using a friendly name.
 6. Select the **Cosmos DB account name** and **database name**
 7. Select ***Create***
 
-The Cosmos DB database, should be visible under the tab **Linked** in the Cosmos DB section. You can differentiate an HTAP enabled Cosmos DB collection from an OLTP only collection with the following icons:
+Cosmos DB database are visible under the tab **Linked** in the Cosmos DB section. You can differentiate an HTAP enabled Cosmos DB container from an OLTP only container with the following icons:
 
-**HTAP collection**:
+**Synapse container**:
 
-![HTAP collection](./media/quickstart-connect-cosmos-db/htap-collection.png)
+![HTAP container](./media/quickstart-connect-synapse-link-cosmosdb/htap-container.png)
 
-**OLTP only collection**:
+**OLTP only container**:
 
-![OLTP collection](./media/quickstart-connect-cosmos-db/oltp-collection.png)
+![OLTP container](./media/quickstart-connect-synapse-link-cosmosdb/oltp-container.png)
 
 ## Quickly interact with code-generated actions
 
-By right-clicking into a collection, you can use the following gesture that will trigger a Spark or SQL run-time. 
+By right-clicking into a container, you have list of gestures that will trigger a Spark or SQL run-time. Writing into a container will happen through the Transactional Store of Cosmos DB and will consume Request Units.  
 
 ## Next steps
 
-* [Learn what is supported between Synapse and Cosmos DB](./cosmos-db-integration/concept-cosmos-db-support.md)
+* [Learn what is supported between Synapse and Cosmos DB](./synapse-link/concept-synapse-link-cosmos-db-support.md)

articles/synapse-analytics/media/quickstart-connect-cosmos-db/htap-collection.png renamed to articles/synapse-analytics/media/quickstart-connect-synapse-link-cosmosdb/htap-container.png

@@ -0,0 +1,53 @@
+---
+title: Synapse Link for Cosmos DB supported features
+description: Understand the current list of actions supported by Synapse Link for Cosmos DB
+services: synapse-analytics 
+author: acomet
+ms.service: synapse-analytics 
+ms.topic: quickstart
+ms.subservice: 
+ms.date: 04/21/2020
+ms.author: acomet
+ms.reviewer: jrasnick
+---
+
+# Synapse Link for Cosmos DB supported features
+
+This article describes what functionalities are currently supported in Synapse Link for Cosmos DB. 
+
+## Azure Synapse support
+
+Here is list of the currently supported features within Synapse Link for Cosmos DB. 
+
+| Category              | Description |Spark | SQL serverless |
+| :-------------------- | :----------------------------------------------------------- |:----------------------------------------------------------- | :----------------------------------------------------------- | :----------------------------------------------------------- |
+| **Run-time Support** |Support for read or write by Azure Synapse run-time| ✓ | [Contact Us](mailto:[email protected]?subject=[Enable%20Preview%20Feature]%20SQL%20serverless%20for%20Cosmos%20DB)|
+| **Cosmos DB API support** |API support as a Synapse Link| SQL / Mongo DB | SQL / Mongo DB |
+| **Object**  |Objects such as table that can be created, pointing directly to  Cosmos DB container| View, Table | View |
+| **Read**    |Read data from a Cosmos DB container| OLTP / HTAP | HTAP |
+| **Write**   |Write data from run-time into a Cosmos DB container| OLTP | n/a |
+
+Writing back into a Cosmos DB container from Spark only happens through the transactional store of Cosmos DB and will impact the transactional performance of Cosmos DB by consuming Request Units. Data will be automatically replicated into the analytical store if analytical store is enabled at the database level.
+
+## Supported code-generated actions for Spark
+
+| Gesture              | Description |OLTP only container |HTAP container |
+| :-------------------- | :----------------------------------------------------------- |:----------------------------------------------------------- |:----------------------------------------------------------- |
+| **Load to DataFrame** |Load and read data into a Spark DataFrame |X| ✓ |
+| **Create Spark table** |Create a table pointing to a Cosmos DB container|X| ✓ |
+| **Write DataFrame to container** |Write data into a container|✓| ✓ |
+| **Load streaming DataFrame from container** |Stream data using Cosmos DB change feed|✓| ✓ |
+| **Write streaming DataFrame to container** |Stream data using Cosmos DB change feed|✓| ✓ |
+
+
+
+## Supported code-generated actions for SQL serverless
+
+| Gesture              | Description |OLTP only container |HTAP container |
+| :-------------------- | :----------------------------------------------------------- |:----------------------------------------------------------- |:----------------------------------------------------------- |
+| **Select top 100** |Preview top 100 items from a container|X| ✓ |
+| **Create view** |Create a view to directly have BI access in a container through Synapse SQL|X| ✓ |
+
+## Next steps
+
+See the [Connect to Synapse Link for Cosmos DB quickstart](../quickstart-connect-synapse-link-cosmos-db.md)