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/synapse-link/how-to-connect-synapse-link-cosmos-db.md
+8-4Lines changed: 8 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -26,18 +26,22 @@ Before you connect an Azure Cosmos DB account to your workspace, you'll need the
26
26
27
27
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.
28
28
29
+
## Navigate to Synapse Studio
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**.
32
+
29
33
## Connect an Azure Cosmos DB database to a Synapse workspace
30
34
31
-
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.
35
+
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.
32
36
33
-
From the Data Object Explorer, you can directly connect an Azure Cosmos DB database by doing the following steps:
37
+
From the Data Object Explorer, you can directly connect to an Azure Cosmos DB database by doing the following steps:
34
38
1. Select ***+*** icon near Data
35
39
2. Select **Connect to external data**
36
-
3. Select the API that you want to connect to: SQL or MongoDB
40
+
3. Select the API that you want to connect to: SQL API or MongoDB API
37
41
4. Select ***Continue***
38
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.
39
43
6. Select the **Cosmos DB account name** and **database name**
40
-
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 number)
41
45
8. Select ***Create***
42
46
43
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:
0 commit comments