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
+12-12Lines changed: 12 additions & 12 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -11,26 +11,26 @@ ms.author: acomet
11
11
ms.reviewer: jrasnick
12
12
---
13
13
14
-
# Connect to Synapse Link for Cosmos DB
14
+
# Connect to Synapse Link for Azure Cosmos DB
15
15
16
-
This article describes how to access an Azure Cosmos database from Azure Synapse Analytics studio with Synapse Link.
16
+
This article describes how to access an Azure Cosmos DB database from Azure Synapse Analytics studio with Synapse Link.
17
17
18
18
## Prerequisites
19
19
20
-
Before you connect a Cosmos DB account to your workspace, there are a few things that you need.
20
+
Before you connect an Azure Cosmos DB account to your workspace, there are a few things that you need.
21
21
22
-
* Existing Cosmos DB account or create a new account following this [quickstart](https://docs.microsoft.com/azure/cosmos-db/how-to-manage-database-account)
22
+
* 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)
23
23
* Existing Synapse workspace or create a new workspace following this [quickstart](https://docs.microsoft.com/azure/synapse-analytics/quickstart-create-workspace)
24
24
25
-
## Enable Cosmos DB analytical store
25
+
## Enable Azure Cosmos DB analytical store
26
26
27
-
To run large-scale analytics into Cosmos DB without impacting your operational performance, we recommend enabling Synapse Link for 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 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.
28
28
29
-
## Connect a Cosmos DB database to a Synapse workspace
29
+
## Connect an Azure Cosmos DB database to a Synapse workspace
30
30
31
-
Connecting a 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 Cosmos DB.
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.
32
32
33
-
From the Data Object Explorer, you can directly connect a Cosmos DB database by doing the following steps:
33
+
From the Data Object Explorer, you can directly connect an Azure Cosmos DB database by doing the following steps:
34
34
1. Select ***+*** icon near Data
35
35
2. Select **Connect to external data**
36
36
3. Select the API that you want to connect to: SQL or MongoDB
@@ -39,7 +39,7 @@ From the Data Object Explorer, you can directly connect a Cosmos DB database by
39
39
6. Select the **Cosmos DB account name** and **database name**
40
40
7. Select ***Create***
41
41
42
-
Cosmos DB database are visible under the tab **Linked** in the Cosmos DB section. You can differentiate an HTAP enabled Cosmos DB container from an OLTP only container with the following icons:
42
+
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:
43
43
44
44
**Synapse container**:
45
45
@@ -51,8 +51,8 @@ Cosmos DB database are visible under the tab **Linked** in the Cosmos DB section
51
51
52
52
## Quickly interact with code-generated actions
53
53
54
-
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 Cosmos DB and will consume Request Units.
54
+
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.
55
55
56
56
## Next steps
57
57
58
-
*[Learn what is supported between Synapse and Cosmos DB](./synapse-link/concept-synapse-link-cosmos-db-support.md)
58
+
*[Learn what is supported between Synapse and Azure Cosmos DB](./synapse-link/concept-synapse-link-cosmos-db-support.md)
|**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)|
25
25
|**Cosmos DB API support**|API support as a Synapse Link| SQL / Mongo DB | SQL / Mongo DB |
26
-
|**Object**|Objects such as table that can be created, pointing directly to Cosmos DB container| View, Table | View |
27
-
|**Read**|Read data from a Cosmos DB container| OLTP / HTAP | HTAP |
28
-
|**Write**|Write data from run-time into a Cosmos DB container| OLTP | n/a |
26
+
|**Object**|Objects such as table that can be created, pointing directly to Azure Cosmos DB container| View, Table | View |
27
+
|**Read**|Read data from an Azure Cosmos DB container| OLTP / HTAP | HTAP |
28
+
|**Write**|Write data from run-time into an Azure Cosmos DB container| OLTP | n/a |
29
29
30
-
Writing back into a Cosmos DB container from Spark only happens through the transactional store of Cosmos DB and will impact the transactional performance of Cosmos DB by consuming Request Units. Data will be automatically replicated into the analytical store if analytical store is enabled at the database level.
30
+
Writing back into an Azure Cosmos DB container from Spark only happens through the transactional store of Azure Cosmos DB and will impact the transactional performance of Azure Cosmos DB by consuming Request Units. Data will be automatically replicated into the analytical store if analytical store is enabled at the database level.
31
31
32
32
## Supported code-generated actions for Spark
33
33
34
34
| Gesture | Description |OLTP only container |HTAP container |
0 commit comments