Merge branch 'release-build-synapse' into aron_cosmosdb

Author: julieMSFT

articles/synapse-analytics/quickstart-connect-synapse-link-cosmos-db.md

@@ -0,0 +1,59 @@
+---
+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: ArnoMicrosoft
+ms.service: synapse-analytics 
+ms.topic: quickstart
+ms.subservice: 
+ms.date: 04/21/2020
+ms.author: acomet
+ms.reviewer: jrasnick
+---
+
+# Connect to Synapse Link for Azure Cosmos DB
+
+This article describes how to access an Azure Cosmos DB database from Azure Synapse Analytics studio with Synapse Link. 
+
+## Prerequisites
+
+Before you connect an Azure Cosmos DB account to your workspace, there are a few things that you need.
+
+* Existing Azure 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 Azure Cosmos DB analytical store
+
+To run large-scale analytics into Azure Cosmos DB without impacting your operational performance, we recommend enabling  Synapse Link for Azure 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 an Azure Cosmos DB database to a Synapse workspace 
+
+Connecting an Azure 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 Azure Cosmos DB. 
+
+From the Data Object Explorer, you can directly connect an Azure 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 containers. We recommend using a friendly name.
+6. Select the **Cosmos DB account name** and **database name**
+7. (Optional) If no region is specified, Synapse run-time operations will be routed toward the nearest region where the analytical store is enabled. However you can set manually which region you want your users to access Cosmos DB analytical store. Select **Additional connection properties** and then **New**. Under **Property Name**, write ***PreferredRegions*** and set the **Value** to the region you want (example: WestUS2, there is no space between words and number)
+8. Select ***Create***
+
+Azure Cosmos DB database are visible under the tab **Linked** in the Azure Cosmos DB section. You can differentiate an HTAP enabled Azure Cosmos DB container from an OLTP only container with the following icons:
+
+**Synapse container**:
+
+![HTAP container](./media/quickstart-connect-synapse-link-cosmosdb/htap-container.png)
+
+**OLTP only container**:
+
+![OLTP container](./media/quickstart-connect-synapse-link-cosmosdb/oltp-container.png)
+
+## Quickly interact with code-generated actions
+
+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 Azure Cosmos DB and will consume Request Units.  
+
+## Next steps
+
+* [Learn what is supported between Synapse and Azure Cosmos DB](./synapse-link/concept-synapse-link-cosmos-db-support.md)

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

@@ -1,4 +1,5 @@
 ---
+
 title: Azure Synapse Link for Cosmos DB supported features
 description: Understand the current list of actions supported by Azure Synapse Link for Cosmos DB
 services: synapse-analytics 
@@ -11,6 +12,7 @@ ms.author: acomet
 ms.reviewer: jrasnick
 ---
 
+
 # Azure Synapse Link for Azure Cosmos DB supported features
 
 This article describes what functionalities are currently supported in Azure Synapse Link for Azure Cosmos DB. 
@@ -39,6 +41,7 @@ Here is list of the currently supported features within Synapse Link for Cosmos
 ## Supported code-generated actions for Spark
 
 | Gesture              | Description |OLTP |HTAP  |
+
 | :-------------------- | :----------------------------------------------------------- |:----------------------------------------------------------- |:----------------------------------------------------------- |
 | **Load to DataFrame** |Load and read data into a Spark DataFrame |X| ✓ |
 | **Create Spark table** |Create a table pointing to an Azure Cosmos DB container|X| ✓ |
@@ -57,4 +60,6 @@ Here is list of the currently supported features within Synapse Link for Cosmos
 
 ## Next steps
 
+
 See how to [connect to Synapse Link for Azure Cosmos DB](./how-to-connect-synapse-link-cosmos-db.md)
+

articles/synapse-analytics/toc.yml

@@ -32,6 +32,8 @@
       href: ./sql-data-warehouse/quickstart-bulk-load-copy-tsql.md?toc=/azure/synapse-analytics/toc.json&bc=/azure/synapse-analytics/breadcrumb/toc.json
   - name: Use SQL on-demand
     href: quickstart-sql-on-demand.md
+  - name: Connect to Synapse Link for Cosmos DB
+    href: quickstart-connect-synapse-link-cosmos-db.md
 - name: Tutorials
   items:
   # - name: Get started