Merge pull request #114971 from julieMSFT/20200512_updatescosmosdb

updates for naming

Author: tfosmark

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

@@ -1,6 +1,6 @@
 ---
 title: Azure Synapse Link for Azure Cosmos DB supported features
-description: Understand the current list of actions supported by Azure Synapse Link for Cosmos DB
+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 
@@ -26,7 +26,7 @@ You can connect to an Azure Cosmos DB container without enabling Synapse Link, i
 | 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 |
+| **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 |

articles/synapse-analytics/synapse-link/how-to-connect-synapse-link-cosmos-db.md

@@ -1,6 +1,6 @@
 ---
-title: Connect to Azure Synapse Link for Cosmos DB
-description: How to connect a Cosmos DB to a Synapse workspace with Azure Synapse Link
+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 
@@ -17,9 +17,9 @@ 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, you'll need the following:
+Before you connect an Azure Cosmos DB database 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 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
@@ -32,16 +32,16 @@ From your Synapse workspace, select **Launch Synapse Studio**. On the Synapse St
 
 ## Connect an Azure Cosmos DB database to a Synapse workspace 
 
-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. 
+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 MongoDB API
+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 **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)
+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:

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

@@ -1,6 +1,6 @@
 ---
 title: Query Azure Cosmos DB Analytical Store with Synapse Spark
-description: How to query Cosmos DB analytical with Synapse Spark
+description: How to query Azure Cosmos DB analytical with Synapse Spark
 services: synapse-analytics 
 author: ArnoMicrosoft
 ms.service: synapse-analytics 
@@ -22,7 +22,7 @@ In this step, you'll read data from Azure Cosmos DB analytical store in a Spark
 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>")
+# To select a preferred list of regions in a multi-region Azure Cosmos DB account, add .option("spark.cosmos.preferredRegions", "<Region1>,<Region2>")
 
 df = spark.read.format("cosmos.olap")\
     .option("spark.synapse.linkedService", "INFERRED")\
@@ -34,7 +34,7 @@ df = spark.read.format("cosmos.olap")\
 
 The equivalent code gesture in **Scala** would be the following code:
 ```java
-// To select a preferred list of regions in a multi-region Cosmos DB account, add option("spark.cosmos.preferredRegions", "<Region1>,<Region2>")
+// To select a preferred list of regions in a multi-region Azure Cosmos DB account, add option("spark.cosmos.preferredRegions", "<Region1>,<Region2>")
 
 val df_olap = spark.read.format("cosmos.olap").
     option("spark.synapse.linkedService", "pySparkSamplesDb").
@@ -50,7 +50,7 @@ This scenario is convenient to reuse tables through third-party tools and provid
 
 ```sql
 %%sql
--- To select a preferred list of regions in a multi-region Cosmos DB account, add spark.cosmos.preferredRegions '<Region1>,<Region2>' in the config options
+-- To select a preferred list of regions in a multi-region Azure Cosmos DB account, add spark.cosmos.preferredRegions '<Region1>,<Region2>' in the config options
 
 create table call_center using cosmos.olap options (
     spark.synapse.linkedService 'INFERRED',
@@ -63,8 +63,8 @@ create table call_center using cosmos.olap options (
 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
-# To select a preferred list of regions in a multi-region Cosmos DB account, add .option("spark.cosmos.preferredRegions", "<Region1>,<Region2>")
+# Write a Spark DataFrame into an Azure Cosmos DB container
+# To select a preferred list of regions in a multi-region Azure Cosmos DB account, add .option("spark.cosmos.preferredRegions", "<Region1>,<Region2>")
 
 
 YOURDATAFRAME.write.format("cosmos.oltp")\
@@ -77,7 +77,7 @@ YOURDATAFRAME.write.format("cosmos.oltp")\
 
 The equivalent code gesture in **Scala** would be the following code:
 ```java
-// To select a preferred list of regions in a multi-region Cosmos DB account, add option("spark.cosmos.preferredRegions", "<Region1>,<Region2>")
+// To select a preferred list of regions in a multi-region Azure Cosmos DB account, add option("spark.cosmos.preferredRegions", "<Region1>,<Region2>")
 
 import org.apache.spark.sql.SaveMode
 
@@ -92,10 +92,10 @@ 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. 
 
-If the folder */localReadCheckpointFolder* isn't created, 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 Azure Cosmos DB.
 
 ```python
-# To select a preferred list of regions in a multi-region Cosmos DB account, add .option("spark.cosmos.preferredRegions", "<Region1>,<Region2>")
+# To select a preferred list of regions in a multi-region Azure Cosmos DB account, add .option("spark.cosmos.preferredRegions", "<Region1>,<Region2>")
 
 dfStream = spark.readStream\
     .format("cosmos.oltp")\
@@ -110,7 +110,7 @@ dfStream = spark.readStream\
 
 The equivalent code gesture in **Scala** would be the following code:
 ```java
-// To select a preferred list of regions in a multi-region Cosmos DB account, add .option("spark.cosmos.preferredRegions", "<Region1>,<Region2>")
+// To select a preferred list of regions in a multi-region Azure Cosmos DB account, add .option("spark.cosmos.preferredRegions", "<Region1>,<Region2>")
 
 val dfStream = spark.readStream.
     format("cosmos.oltp").
@@ -124,10 +124,10 @@ val dfStream = spark.readStream.
 ```
 
 ## Write streaming DataFrame to container
-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.
+In this gesture, you'll write a streaming dataframe into the Azure 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 Azure Cosmos DB.
 
 ```python
-# To select a preferred list of regions in a multi-region Cosmos DB account, add .option("spark.cosmos.preferredRegions", "<Region1>,<Region2>")
+# To select a preferred list of regions in a multi-region Azure Cosmos DB account, add .option("spark.cosmos.preferredRegions", "<Region1>,<Region2>")
 
 streamQuery = dfStream\
         .writeStream\
@@ -144,7 +144,7 @@ streamQuery.awaitTermination()
 
 The equivalent code gesture in **Scala** would be the following code:
 ```java
-// To select a preferred list of regions in a multi-region Cosmos DB account, add .option("spark.cosmos.preferredRegions", "<Region1>,<Region2>")
+// To select a preferred list of regions in a multi-region Azure Cosmos DB account, add .option("spark.cosmos.preferredRegions", "<Region1>,<Region2>")
 
 val query = dfStream.
             writeStream.
@@ -161,4 +161,4 @@ query.awaitTermination()
 ## Next steps
 
 * [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)
+* [Connect to Synapse Link for Azure Cosmos DB](../quickstart-connect-synapse-link-cosmos-db.md)