Merge pull request #114585 from Kat-Campise/arnaud_articles

arnaud articles

Author: denrea

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

@@ -1,6 +1,6 @@
 ---
-title: Connect to Synapse Link for Cosmos DB
-description: How to connect a Cosmos DB to a Synapse workspace with Synapse Link
+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 
@@ -24,7 +24,11 @@ Before you connect an Azure Cosmos DB account to your workspace, there are a few
 
 ## 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.
+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 
 
@@ -37,10 +41,10 @@ From the Data Object Explorer, you can directly connect an Azure Cosmos DB datab
 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)
+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 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:
+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**:
 
@@ -52,8 +56,9 @@ Azure Cosmos DB database are visible under the tab **Linked** in the Azure Cosmo
 
 ## 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.  
+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 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/synapse-link/concept-synapse-link-cosmos-db-support.md

@@ -13,27 +13,25 @@ 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. 
+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 Cosmos DB container without enabling Synapse Link, in which case you can only read/write to the transactional store. 
-
-Here is list of the currently supported features within Synapse Link for Cosmos DB. 
+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)|
 | **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 Azure Cosmos DB container| View, Table | View |
+| **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 happens through the transactional store of Azure Cosmos DB and will impact the transactional performance of Azure Cosmos DB by consuming Request Units.
+* 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
@@ -57,4 +55,5 @@ 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)
+* 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/synapse-link/how-to-connect-synapse-link-cosmos-db.md

@@ -17,7 +17,7 @@ This article describes how to access an Azure Cosmos DB database from Azure Syna
 
 ## Prerequisites
 
-Before you connect an Azure Cosmos DB account to your workspace, there are a few things that you need.
+Before you connect an Azure Cosmos DB account to your workspace, you'll need the following:
 
 * 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) 
@@ -26,21 +26,25 @@ Before you connect an Azure Cosmos DB account to your workspace, there are a few
 
 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 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. 
+Connecting an Azure Cosmos DB database is done as a 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:
+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 or MongoDB
+3. Select the API that you want to connect to: SQL API or MongoDB API
 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)
+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. With Azure Cosmos DB, you can differentiate an HTAP enabled container from an OLTP only container through the following icons:
+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**:
 

articles/synapse-analytics/synapse-link/how-to-query-analytical-store-spark.md

@@ -13,11 +13,13 @@ ms.reviewer: jrasnick
 
 # Query Azure Cosmos DB Analytical Store with Synapse Spark
 
-This article gives some examples on how you can interact with the Analytical Store from Synapse gestures. Those gestures are visible when you right-click on a container. With gestures, you can quickly generate code and tweak it to your needs. They are also perfect for discovering data with a single click.
+This article gives some examples on how you can interact with the analytical store from Synapse gestures. Gestures are visible when you right-click on a container. With gestures, you can quickly generate code and tailor it to your needs. Gestures are also perfect for discovering data with a single click.
 
 ## Load to DataFrame
 
-In this step, you will read data from Azure Cosmos DB Analytical Store in a Spark DataFrame. It will display 10 rows from the DataFrame called ***df***. Once your data is in a dataframe, you can perform additional analysis. This operation does not impact the transactional store.
+In this step, you'll read data from Azure Cosmos DB analytical store in a Spark DataFrame. It will display 10 rows from the DataFrame called ***df***. Once your data is into dataframe, you can perform additional analysis. 
+
+This operation doesn't impact the transactional store.
 
 ```python
 # To select a preferred list of regions in a multi-region Cosmos DB account, add .option("spark.cosmos.preferredRegions", "<Region1>,<Region2>")
@@ -42,7 +44,9 @@ val df_olap = spark.read.format("cosmos.olap").
 
 ## Create Spark table
 
-In this gesture, you will create a Spark table pointing to the container you selected. This operation does not incur any data movement. If you decide to delete the table, the underlying container (and corresponding Analytical Store) won't be impacted. This scenario is convenient to reuse tables through third-party tools and provide accessibility to the data at run-time.
+In this gesture, you'll create a Spark table pointing to the container you selected. That operation doesn't incur any data movement. If you decide to delete that table, the underlying container (and corresponding analytical store) won't be affected. 
+
+This scenario is convenient to reuse tables through third-party tools and provide accessibility to the data for the run-time.
 
 ```sql
 %%sql
@@ -56,7 +60,7 @@ create table call_center using cosmos.olap options (
 
 ## Write DataFrame to container
 
-In this gesture, you will write a dataframe into a container. This operation will impact the transactional performance and consume Request Units. Using Azure Cosmos DB transactional performance is ideal for write transactions. Make sure that you replace **YOURDATAFRAME** by the dataframe that you want to write back to.
+In this gesture, you'll write a dataframe into a container. This operation will impact the transactional performance and consume Request Units. Using Azure Cosmos DB transactional performance is ideal for write transactions. Make sure that you replace **YOURDATAFRAME** by the dataframe that you want to write back to.
 
 ```python
 # Write a Spark DataFrame into a Cosmos DB container
@@ -86,8 +90,9 @@ df.write.format("cosmos.oltp").
 ```
 
 ## Load streaming DataFrame from container
+In this gesture, you'll use Spark Streaming capability to load data from a container into a dataframe. The data will be stored in the primary data lake account (and file system) that you connected to the workspace. 
 
-In this gesture, you will use Spark Streaming capability to load data from a container into a dataframe. The data will be stored into the primary data lake account (and file system) that you connected to the workspace. If the folder /localReadCheckpointFolder does not exist, it will be automatically created. This operation will impact the transactional performance of Cosmos DB.
+If the folder */localReadCheckpointFolder* isn't created, it will be automatically created. This operation will impact the transactional performance of Cosmos DB.
 
 ```python
 # To select a preferred list of regions in a multi-region Cosmos DB account, add .option("spark.cosmos.preferredRegions", "<Region1>,<Region2>")
@@ -119,8 +124,7 @@ val dfStream = spark.readStream.
 ```
 
 ## Write streaming DataFrame to container
-
-In this gesture, you will write a streaming dataframe into the Cosmos DB container you selected. If the folder /localReadCheckpointFolder does not exist, it will be automatically created. This operation will impact the transactional performance of Cosmos DB.
+In this gesture, you'll write a streaming dataframe into the Cosmos DB container you selected. If the folder */localReadCheckpointFolder* isn't created, it will be automatically created. This operation will impact the transactional performance of Cosmos DB.
 
 ```python
 # To select a preferred list of regions in a multi-region Cosmos DB account, add .option("spark.cosmos.preferredRegions", "<Region1>,<Region2>")
@@ -154,8 +158,7 @@ val query = dfStream.
 
 query.awaitTermination()
 ```
-
 ## Next steps
 
-- [Learn more about Cosmos DB Analytical Store]
-<!-- (../cosmos-db/analytical-store-introduction) -->
+* [Learn what is supported between Synapse and Azure Cosmos DB](./concept-synapse-link-cosmos-db-support.md)
+* [Connect to Synapse Link for Cosmos DB](../quickstart-connect-synapse-link-cosmos-db.md)