Merge pull request #115278 from julieMSFT/release-build-synapse

Build 2020  release-build-synapse

Author: SyntaxC4

articles/synapse-analytics/includes/note-preview.md

@@ -10,4 +10,4 @@ ms.author: jrasnick
 > This preview version is provided without a service level agreement, and it's not recommended for production workloads. Certain features might not be supported or might have constrained capabilities. 
 > For more information, see [Supplemental Terms of Use for Microsoft Azure Previews](https://azure.microsoft.com/support/legal/preview-supplemental-terms/).
 >
-> To access the preview features of Azure Synapse, request access [here](https://aka.ms/synapsepreview). Microsoft will triage all requests and respond as soon as possible.
+

articles/synapse-analytics/media/quickstart-connect-synapse-link-cosmosdb/htap-container.png

@@ -0,0 +1,64 @@
+---
+title: Connect to Synapse Link for Azure Cosmos DB
+description: How to connect an Azure 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. This function brings HTAP capability to a container and built-in support in Azure Synapse. Follow this quickstart to enable Synapse Link for Cosmos DB containers.
+
+## Navigate to Synapse Studio 
+
+From your Synapse workspace, select **Launch Synapse Studio**. On the Synapse Studio home page, select **Data, which will take you to the **Data Object Explorer**.
+
+## 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 numbers)
+8. Select ***Create***
+
+Azure Cosmos DB databases 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
+
+When you right-click into a container, you'll have a 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)
+* [Learn how to query an analytical store with Synapse Spark](synapse-link/how-to-query-analytical-store-spark.md)

articles/synapse-analytics/media/quickstart-connect-synapse-link-cosmosdb/oltp-container.png

@@ -15,23 +15,19 @@ ms.reviewer: igorstan
 # What is Azure Synapse Analytics (formerly SQL DW)?
 
 > [!NOTE] 
-> Try the latest Azure Synapse features such as workspaces, Spark, SQL on demand, and the integrated Synapse Studio experience 
-> by [requesting access to Azure Synapse (workspaces preview)](https://aka.ms/synapsepreview). 
->
 >Explore the [Azure Synapse (workspaces preview) documentation](../overview-what-is.md).
+>
 
 Azure Synapse is an analytics service that brings together enterprise data warehousing and Big Data analytics. It gives you the freedom to query data on your terms, using either serverless on-demand or provisioned resources—at scale. Azure Synapse brings these two worlds together with a unified experience to ingest, prepare, manage, and serve data for immediate BI and machine learning needs.
 
 Azure Synapse has four components:
 
 - Synapse SQL: Complete T-SQL based analytics – Generally Available
   - SQL pool (pay per DWU provisioned)
-  - SQL on-demand (pay per TB processed) – (Preview)
-- Spark: Deeply integrated Apache Spark (Preview)
-- Synapse Pipelines: Hybrid data integration (Preview)
-- Studio: Unified user experience.  (Preview)
-
-
+  - SQL on-demand (pay per TB processed) (preview)
+- Spark: Deeply integrated Apache Spark (preview)
+- Synapse Pipelines: Hybrid data integration (preview)
+- Studio: Unified user experience. (preview)
 
 ## Synapse SQL pool in Azure Synapse
 

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

@@ -0,0 +1,59 @@
+---
+title: Azure Synapse Link for Azure Cosmos DB supported features
+description: Understand the current list of actions supported by Azure Synapse Link for Azure Cosmos DB
+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
+---
+
+# Azure Synapse Link for Azure Cosmos DB supported features
+
+This article describes the functionalities that are currently supported in Azure Synapse Link for Azure Cosmos DB. 
+
+## Azure Synapse support
+
+There are two types of containers in Azure Cosmos DB:
+* HTAP container - A container with Synapse Link enabled. This container has both transactional store and analytical store. 
+* OLTP container - A container with only transaction store; Synapse Link is not enabled. 
+
+You can connect to an Azure Cosmos DB container without enabling Synapse Link, in which case you can only read/write to the transactional store. What follows a is list of the currently supported features within Synapse Link for Azure Cosmos DB. 
+
+| Category              | Description |[Spark](https://docs.microsoft.com/azure/synapse-analytics/sql/on-demand-workspace-overview) | [SQL serverless](https://docs.microsoft.com/azure/synapse-analytics/sql/on-demand-workspace-overview) |
+| -------------------- | ----------------------------------------------------------- |----------------------------------------------------------- | ----------------------------------------------------------- | ----------------------------------------------------------- |
+| **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)|
+| **Azure Cosmos DB API support** |API support as a Synapse Link| SQL / MongoDB | SQL / MongoDB |
+| **Object**  |Objects such as a table that can be created, pointing directly to Azure Cosmos DB container| View, Table | View |
+| **Read**    |Read data from an Azure Cosmos DB container| OLTP / HTAP | HTAP  |
+| **Write**   |Write data from run-time into an Azure Cosmos DB container| OLTP | n/a |
+
+* If you write data into an Azure Cosmos DB container from Spark, this process happens through the transactional store of Azure Cosmos DB and will impact the transactional performance of Azure Cosmos DB by consuming Request Units.
+* SQL pool integration through external tables is currently not supported.
+
+## 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| ✓ |
+| **Write DataFrame to container** |Write data into a container|✓| ✓ |
+| **Load streaming DataFrame from container** |Stream data using Azure Cosmos DB change feed|✓| ✓ |
+| **Write streaming DataFrame to container** |Stream data using Azure Cosmos DB change feed|✓| ✓ |
+
+
+
+## Supported code-generated actions for SQL serverless
+
+| Gesture              | Description |OLTP |HTAP |
+| -------------------- | ----------------------------------------------------------- |----------------------------------------------------------- |----------------------------------------------------------- |
+| **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 how to [connect to Synapse Link for Azure Cosmos DB](../quickstart-connect-synapse-link-cosmos-db.md)
+* [Learn how to query the analytical store with Spark](how-to-query-analytical-store-spark.md)

articles/synapse-analytics/sql-data-warehouse/sql-data-warehouse-overview-what-is.md

@@ -0,0 +1,64 @@
+---
+title: Connect to Azure Synapse Link for Azure Cosmos DB
+description: How to connect an Azure Cosmos DB to a Synapse workspace with Azure 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 Azure Synapse Link for Azure Cosmos DB
+
+This article describes how to access an Azure Cosmos DB database from Azure Synapse Analytics Studio with Azure Synapse Link. 
+
+## Prerequisites
+
+Before you connect an Azure Cosmos DB database to your workspace, you'll need the following:
+
+* Existing Azure Cosmos DB database 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. Synapse Link brings HTAP capability to a container and built-in support in Azure Synapse.
+
+## Navigate to Synapse Studio 
+
+From your Synapse workspace, select **Launch Synapse Studio**. On the Synapse Studio home page, select **Data, which will take you to the **Data Object Explorer**. 
+
+## Connect an Azure Cosmos DB database to a Synapse workspace 
+
+Connecting an Azure Cosmos DB database is done as a linked service. An Azure 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 to 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 API or API for 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 **Azure 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 Azure 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 databases are visible under the tab **Linked** in the Azure Cosmos DB section. With Azure Cosmos DB, you can differentiate an HTAP enabled container from an OLTP only container through the following icons:
+
+**OLTP only container**:
+
+![OLTP container](../media/quickstart-connect-synapse-link-cosmosdb/oltp-container.png)
+
+**HTAP enabled container**:
+
+![HTAP container](../media/quickstart-connect-synapse-link-cosmosdb/htap-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](./concept-synapse-link-cosmos-db-support.md)
+* [Learn how to query the analytical store with Spark](./how-to-query-analytical-store-spark.md)