Merge pull request #113102 from julieMSFT/ArnoMicrosoft_20200428_3

new articles from Arnaud

Author: ShannonLeavitt

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

@@ -0,0 +1,49 @@
+---
+title: Supported features for Cosmos DB
+description: Understand the current list of actions supported between Azure Synapse Analytics and 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
+---
+
+# Supported features between Azure Synapse Analytics and Cosmos DB
+
+This article describes what functionalities are currently supported (and not supported) between Azure Synapse and Cosmos DB analytical store. 
+
+## Azure Synapse support
+
+Here is list of the currently supported features between Azure Synapse and Cosmos DB. 
+
+| Category              | Description |Spark | SQL serverless | SQL provisioned |
+| :-------------------- | :----------------------------------------------------------- |:----------------------------------------------------------- | :----------------------------------------------------------- | :----------------------------------------------------------- |
+| **Azure Synapse 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)| n/a|
+| **Cosmos DB API support** |API support as a Synapse Link| SQL / Mongo DB | SQL / Mongo DB | n/a|
+| **Object**  |Objects such as table that can be created, pointing directly to  Cosmos DB collection| View, Table | View | n/a|
+| **Read**    |Read data from a Cosmos DB collection| OLTP / HTAP | HTAP | n/a|
+| **Write**   |Write data from Azure Synapse run-time into a Cosmos DB collection| OLTP | n/a | n/a|
+
+Writing back into a Cosmos DB collection from Spark only happens through the transactional side of Cosmos DB and will impact the transactional performance of Cosmos DB. 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 collection |HTAP collection |
+| :-------------------- | :----------------------------------------------------------- |:----------------------------------------------------------- |:----------------------------------------------------------- |
+| **Stream data** |Stream data using Cosmos DB change feed|✓| ✓ |
+| **Ingest into a collection** |Write back data into a collection with Spark|✓| ✓ |
+| **Load to data frame** |Load and read data into a Spark dataframe |✓| ✓ |
+
+## Supported code-generated actions for SQL serverless
+
+| Gesture              | Description |OLTP only collection |HTAP collection |
+| :-------------------- | :----------------------------------------------------------- |:----------------------------------------------------------- |:----------------------------------------------------------- |
+| **Select top 100** |Preview top 100 items from a collection|X| ✓ |
+| **Create view** |Create a view to directly access data in the collection through Synapse and BI tool|X| ✓ |
+
+## Next steps
+
+See the [Connect to Cosmos DB quickstart](../quickstart-connect-cosmos-db.md)

articles/synapse-analytics/media/quickstart-connect-cosmos-db/htap-collection.png

@@ -0,0 +1,58 @@
+---
+title: Connect Cosmos DB to Synapse workspace  
+description: How to connect a Cosmos DB to a Synapse workspace
+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
+---
+
+# Connect and access an Azure Cosmos DB database (preview) in Azure Synapse Analytics
+
+This article describes how to access an Azure Cosmos database from Azure Synapse Analytics studio.
+
+## Prerequisites
+
+Before you connect a Cosmos DB account to your workspace, there are a few things that you need.
+
+* Existing Cosmos DB account or create a new account following this [quickstart](https://docs.microsoft.com/azure/cosmos-db/how-to-manage-database-account)
+* Existing Synapse workspace or create a new workspace following this [quickstart](https://docs.microsoft.com/azure/synapse-analytics/quickstart-create-workspace) 
+
+## 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.
+
+## Connect a Cosmos DB database to a Synapse workspace 
+
+Connecting a Cosmos DB database is done as linked service. A Cosmos DB linked service enables users to browse and explore data, read, and write from Synapse Spark or SQL into Cosmos DB. 
+
+From the Data Object Explorer, you can directly connect a Cosmos DB database by doing the following steps:
+1. Select ***+*** icon near Data
+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.
+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:
+
+**HTAP collection**:
+
+![HTAP collection](./media/quickstart-connect-cosmos-db/htap-collection.png)
+
+**OLTP only collection**:
+
+![OLTP collection](./media/quickstart-connect-cosmos-db/oltp-collection.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. 
+
+## Next steps
+
+* [Learn what is supported between Synapse and Cosmos DB](./cosmos-db-integration/concept-cosmos-db-support.md)

articles/synapse-analytics/media/quickstart-connect-cosmos-db/oltp-collection.png

@@ -28,6 +28,8 @@
       href: quickstart-create-sql-pool.md
   - name: Use SQL on-demand
     href: quickstart-sql-on-demand.md
+  - name: Connect to Cosmos DB
+    href: quickstart-connect-cosmos-db.md
 - name: Tutorials
   items:
   - name: Run Apache Spark applications for Spark pools
@@ -316,6 +318,10 @@
         href: ./sql-data-warehouse/memory-concurrency-limits.md?toc=/azure/synapse-analytics/toc.json&bc=/azure/synapse-analytics/breadcrumb/toc.json
       - name: Resource classes
         href: ./sql-data-warehouse/resource-classes-for-workload-management.md?toc=/azure/synapse-analytics/toc.json&bc=/azure/synapse-analytics/breadcrumb/toc.json
+  - name: Synapse Link
+    items:
+    - name: Synapse Link supported features
+      href: ./cosmos-db-integration/concept-cosmos-db-support.md
   - name: Tools integration (AI, ETL, BI)
     items:
     - name: Troubleshoot Synapse Analytics Studio