Skip to content

Commit 739d367

Browse files
committed
minor
1 parent 2a843f5 commit 739d367

File tree

2 files changed

+13
-12
lines changed

2 files changed

+13
-12
lines changed

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

Lines changed: 8 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -17,21 +17,22 @@ This article describes what functionalities are currently supported in Synapse L
1717

1818
## Azure Synapse support
1919

20-
Here is list of the currently supported features within Synapse Link for Cosmos DB.
20+
Here is list of the currently supported features within Synapse Link for Cosmos DB. An OLTP container only contains a transactional store. An HTAP enabled container contains both a transactional and analytical store.
2121

22-
| Category | Description |Spark | SQL serverless |
22+
| 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) |
2323
| :-------------------- | :----------------------------------------------------------- |:----------------------------------------------------------- | :----------------------------------------------------------- | :----------------------------------------------------------- |
2424
| **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)|
2525
| **Cosmos DB API support** |API support as a Synapse Link| SQL / Mongo DB | SQL / Mongo DB |
2626
| **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 |
27+
| **Read** |Read data from an Azure Cosmos DB container| OLTP only / HTAP enabled | HTAP enabled |
28+
| **Write** |Write data from run-time into an Azure Cosmos DB container| OLTP only | n/a |
2929

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.
30+
* 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.
31+
* SQL pool integration through external tables is currently not supported.
3132

3233
## Supported code-generated actions for Spark
3334

34-
| Gesture | Description |OLTP only container |HTAP container |
35+
| Gesture | Description |OLTP only |HTAP enabled |
3536
| :-------------------- | :----------------------------------------------------------- |:----------------------------------------------------------- |:----------------------------------------------------------- |
3637
| **Load to DataFrame** |Load and read data into a Spark DataFrame |X||
3738
| **Create Spark table** |Create a table pointing to an Azure Cosmos DB container|X||
@@ -43,7 +44,7 @@ Writing back into an Azure Cosmos DB container from Spark only happens through t
4344

4445
## Supported code-generated actions for SQL serverless
4546

46-
| Gesture | Description |OLTP only container |HTAP container |
47+
| Gesture | Description |OLTP only |HTAP enabled |
4748
| :-------------------- | :----------------------------------------------------------- |:----------------------------------------------------------- |:----------------------------------------------------------- |
4849
| **Select top 100** |Preview top 100 items from a container|X||
4950
| **Create view** |Create a view to directly have BI access in a container through Synapse SQL|X||

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

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -40,16 +40,16 @@ From the Data Object Explorer, you can directly connect an Azure Cosmos DB datab
4040
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)
4141
8. Select ***Create***
4242

43-
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:
44-
45-
**Synapse container**:
46-
47-
![HTAP container](./media/quickstart-connect-synapse-link-cosmosdb/htap-container.png)
43+
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:
4844

4945
**OLTP only container**:
5046

5147
![OLTP container](./media/quickstart-connect-synapse-link-cosmosdb/oltp-container.png)
5248

49+
**HTAP enabled container**:
50+
51+
![HTAP container](./media/quickstart-connect-synapse-link-cosmosdb/htap-container.png)
52+
5353
## Quickly interact with code-generated actions
5454

5555
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.

0 commit comments

Comments
 (0)