You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/synapse-analytics/quickstart-connect-synapse-link-cosmos-db.md
+6-6Lines changed: 6 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,6 +1,6 @@
1
1
---
2
2
title: Connect to Synapse Link for Azure Cosmos DB
3
-
description: How to connect a Azure Cosmos DB to a Synapse workspace with Synapse Link
3
+
description: How to connect an Azure Cosmos DB to a Synapse workspace with Synapse Link
4
4
services: synapse-analytics
5
5
author: ArnoMicrosoft
6
6
ms.service: synapse-analytics
@@ -24,11 +24,11 @@ Before you connect an Azure Cosmos DB account to your workspace, there are a few
24
24
25
25
## Enable Azure Cosmos DB analytical store
26
26
27
-
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.
27
+
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.
28
28
29
29
## Navigate to Synapse Studio
30
30
31
-
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**.
31
+
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**.
32
32
33
33
## Connect an Azure Cosmos DB database to a Synapse workspace
34
34
@@ -41,10 +41,10 @@ From the Data Object Explorer, you can directly connect an Azure Cosmos DB datab
41
41
4. Select ***Continue***
42
42
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.
43
43
6. Select the **Cosmos DB account name** and **database name**
44
-
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)
44
+
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)
45
45
8. Select ***Create***
46
46
47
-
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:
47
+
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:
48
48
49
49
**Synapse container**:
50
50
@@ -56,7 +56,7 @@ Azure Cosmos DB database are visible under the tab **Linked** in the Azure Cosmo
56
56
57
57
## Quickly interact with code-generated actions
58
58
59
-
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.
59
+
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.
Copy file name to clipboardExpand all lines: articles/synapse-analytics/synapse-link/how-to-connect-synapse-link-cosmos-db.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -28,7 +28,7 @@ To run large-scale analytics into Azure Cosmos DB without impacting your operati
28
28
29
29
## Navigate to Synapse Studio
30
30
31
-
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**.
31
+
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**.
32
32
33
33
## Connect an Azure Cosmos DB database to a Synapse workspace
34
34
@@ -44,7 +44,7 @@ From the Data Object Explorer, you can directly connect to an Azure Cosmos DB da
44
44
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)
45
45
8. Select ***Create***
46
46
47
-
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:
47
+
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:
Copy file name to clipboardExpand all lines: articles/synapse-analytics/synapse-link/how-to-query-analytical-store-spark.md
+8-8Lines changed: 8 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -13,13 +13,13 @@ ms.reviewer: jrasnick
13
13
14
14
# Query Azure Cosmos DB analytical store with Synapse Spark
15
15
16
-
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. They are also perfect for discovering data with a single click.
16
+
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.
17
17
18
18
## Load to DataFrame
19
19
20
-
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 into dataframe, you can perform additional analysis.
20
+
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.
21
21
22
-
This operation does not impact the transactional store.
22
+
This operation doesn't impact the transactional store.
23
23
24
24
```python
25
25
# To select a preferred list of regions in a multi-region Cosmos DB account, add .option("spark.cosmos.preferredRegions", "<Region1>,<Region2>")
@@ -44,7 +44,7 @@ val df_olap = spark.read.format("cosmos.olap").
44
44
45
45
## Create Spark table
46
46
47
-
In this gesture, you will create a Spark table pointing to the container you selected. That operation does not incur any data movement. If you decide to delete that table, the underlying container (and corresponding analytical store) won't be impacted.
47
+
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 impacted.
48
48
49
49
This scenario is convenient to reuse tables through third-party tools and provide accessibility to the data for the run-time.
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.
62
+
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.
63
63
64
64
Make sure that you replace **YOURDATAFRAME** by the dataframe that you want to write back.
65
65
@@ -91,9 +91,9 @@ df.write.format("cosmos.oltp").
91
91
```
92
92
93
93
## Load streaming DataFrame from container
94
-
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.
94
+
In this gesture, you'll 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.
95
95
96
-
If the folder */localReadCheckpointFolder*is not created, it will be automatically created. This operation will impact the transactional performance of Cosmos DB.
96
+
If the folder */localReadCheckpointFolder*isn't created, it will be automatically created. This operation will impact the transactional performance of Cosmos DB.
97
97
98
98
```python
99
99
# To select a preferred list of regions in a multi-region Cosmos DB account, add .option("spark.cosmos.preferredRegions", "<Region1>,<Region2>")
@@ -125,7 +125,7 @@ val dfStream = spark.readStream.
125
125
```
126
126
127
127
## Write streaming DataFrame to container
128
-
In this gesture, you will write a streaming dataframe into the Cosmos DB container you selected. If the folder */localReadCheckpointFolder*is not created, it will be automatically created. This operation will impact the transactional performance of Cosmos DB.
128
+
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.
129
129
130
130
```python
131
131
# To select a preferred list of regions in a multi-region Cosmos DB account, add .option("spark.cosmos.preferredRegions", "<Region1>,<Region2>")
0 commit comments