Skip to content

Commit c762417

Browse files
Merge pull request #298203 from jovanpop-msft/patch-804860
Minor changes in cosmosdb page
2 parents 5f38044 + f06f58a commit c762417

File tree

1 file changed

+10
-10
lines changed

1 file changed

+10
-10
lines changed

articles/synapse-analytics/sql/query-cosmos-db-analytical-store.md

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -46,13 +46,13 @@ OPENROWSET(
4646
The SQL connection string for Azure Cosmos DB includes the following components:
4747
- **account** - The name of the Azure Cosmos DB account you are targeting.
4848
- **database** - The container name, specified without quotation marks in the OPENROWSET syntax. If the container name contains special characters (for example, a dash -), it should be enclosed in square brackets ([]).
49-
- **region** (optional) - The region of your CosmosDB analytical storage. If omitted, the container's primary region is used.
50-
- **endpoint** (optional) - required if your CosmosDB account does not follow the standard `*.documents.azure.com` format.
49+
- **region** (optional) - The region of your Cosmos DB analytical storage. If omitted, the container's primary region is used.
50+
- **endpoint** (optional) - required if your Cosmos DB account does not follow the standard `*.documents.azure.com` format.
5151

5252
> [!IMPORTANT]
5353
> The `endpoint` parameter is needed for accounts that don't match the standard `*.documents.azure.com` format. For example, if your Azure Cosmos DB account ends with `.documents.azure.us`, make sure that you add `endpoint=<account name>.documents.azure.us` in the connection string.
5454
55-
These properties can be identified from the standard CosmosDb connection string, for example:
55+
These properties can be identified from the standard Cosmos DB connection string, for example:
5656
```
5757
AccountEndpoint=https://<database account name>.documents.azure.com:443/;AccountKey=<database account master key>;
5858
```
@@ -62,7 +62,7 @@ The SQL connection string can be formatted as follows:
6262
'account=<database account name>;database=<database name>;region=<region name>'
6363
```
6464

65-
This connection string does not include the authentication information required to connect to CosmosDB analytical storage. Additional information is needed depending on the type of authentication used:
65+
This connection string does not include the authentication information required to connect to Cosmos DB analytical storage. Additional information is needed depending on the type of authentication used:
6666
- If `OPENROWSET` uses workspace managed identity to access the analytical store, you should add the `AuthType` property.
6767
- If `OPENROWSET` uses an inline account key, you should add the `key` property. This allows you to query Azure Cosmos DB collections without needing to prepare credentials.
6868
- Instead of including authentication information in the connection string, `OPENROWSET` can reference a credential that contains the Azure Cosmos DB account key. This approach can be used to create views on Azure Cosmos DB collections.
@@ -71,7 +71,7 @@ These options are described below.
7171

7272
### [OPENROWSET with key or managed identity](#tab/openrowset-key)
7373

74-
To support querying and analyzing data in an Azure Cosmos DB analytical store, a serverless SQL pool is used. The serverless SQL pool uses the `OPENROWSET` SQL syntax, so you must first convert your Azure Cosmos DB connection string to this format:
74+
The serverless SQL pool enables you to query Cosmos DB Analytical storage and authenticate with the original Cosmos DB account key or to allow Synapse managed identity to access the Cosmos DB Analytical storage. You can use the following syntax in this scenario:
7575

7676
```sql
7777
OPENROWSET(
@@ -80,20 +80,20 @@ OPENROWSET(
8080
<Container name>
8181
) [ < with clause > ] AS alias
8282
```
83-
In addition to the common properties in the SQL connection string that are described above (**account**, **database**, **region**, and **endpoint**), in this case, you need to add **one** of the following options:
84-
- **AuthType** - set this option to `ManagedIdentity` if accessing CosmosDB using the Synapse workspace Managed Identity.
85-
- **key** - The master key for accessing CosmosDB data, used if not utilizing the Synapse workspace managed identity.
83+
In addition to the common properties in the SQL connection string that are described above (**account**, **database**, **region**, and **endpoint**), you need to add **one** of the following options:
84+
- **AuthType** - set this option to `ManagedIdentity` if accessing Cosmos DB using the Synapse workspace Managed Identity.
85+
- **key** - The master key for accessing Cosmos DB data, used if not utilizing the Synapse workspace managed identity.
8686

8787
The examples of connection strings are shown in the following table:
8888

8989
| Authentication type | Connection string |
9090
| --- | --- |
91-
| CosmosDB database account master key | `account=<account name>;database=<db name>;region=<region name>;key=<account master key>` |
91+
| Cosmos DB account master key | `account=<account name>;database=<db name>;region=<region name>;key=<account master key>` |
9292
| Synapse workspace managed identity | `account=<account name>;database=<db name>;region=<region name>;authtype=ManagedIdentity` |
9393

9494
### [OPENROWSET with credential](#tab/openrowset-credential)
9595

96-
You can use `OPENROWSET` syntax that references a credential:
96+
Instead of defining the access key in OPENROWSET, you can place it in the separate credential and use `OPENROWSET` syntax that references a credential:
9797

9898
```sql
9999
OPENROWSET(

0 commit comments

Comments
 (0)