Skip to content

Commit 22db1af

Browse files
Merge pull request #262326 from tarabhatiamsft/docs-editor/merge-1704318211
Removed shared throughput DB from limitations
2 parents 297bcfe + 9c6af3a commit 22db1af

File tree

1 file changed

+54
-3
lines changed

1 file changed

+54
-3
lines changed

articles/cosmos-db/merge.md

Lines changed: 54 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -92,11 +92,25 @@ Install-Module @parameters
9292

9393
Use [`az extension add`](/cli/azure/extension#az-extension-add) to install the [cosmosdb-preview](https://github.com/azure/azure-cli-extensions/tree/main/src/cosmosdb-preview) Azure CLI extension.
9494

95+
96+
97+
98+
99+
100+
101+
102+
103+
104+
95105
```azurecli-interactive
96106
az extension add \
97107
--name cosmosdb-preview
98108
```
99109

110+
111+
112+
113+
100114
---
101115

102116
#### [API for NoSQL](#tab/nosql/azure-powershell)
@@ -138,6 +152,24 @@ az cosmosdb sql container merge \
138152
--name '<cosmos-container-name>'
139153
```
140154

155+
For **shared throughput databases**, start the merge by using `az cosmosdb sql database merge`.
156+
157+
158+
159+
160+
161+
```azurecli
162+
az cosmosdb sql database merge \
163+
--account-name '<cosmos-account-name>'
164+
--name '<cosmos-database-name>'
165+
--resource-group '<resource-group-name>'
166+
```
167+
168+
169+
```http
170+
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/sqlDatabases/{databaseName}/partitionMerge?api-version=2023-11-15-preview
171+
```
172+
141173
#### [API for MongoDB](#tab/mongodb/azure-powershell)
142174

143175
Use `Invoke-AzCosmosDBMongoDBCollectionMerge` with the `-WhatIf` parameter to preview the merge without actually performing the operation.
@@ -167,16 +199,36 @@ Invoke-AzCosmosDBMongoDBCollectionMerge @parameters
167199

168200
#### [API for MongoDB](#tab/mongodb/azure-cli)
169201

170-
Start the merge by using [`az cosmosdb mongodb collection merge`](/cli/azure/cosmosdb/mongodb/collection#az-cosmosdb-mongodb-collection-merge).
202+
For **shared-throughput databases**, start the merge by using [`az cosmosdb mongodb database merge`](/cli/azure/cosmosdb/mongodb/database?view=azure-cli-latest).
203+
204+
205+
206+
```azurecli
207+
az cosmosdb mongodb database merge \
208+
--account-name '<cosmos-account-name>'
209+
--name '<cosmos-database-name>'
210+
--resource-group '<resource-group-name>'
211+
```
212+
213+
214+
```http
215+
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/mongodbDatabases/{databaseName}/partitionMerge?api-version=2023-11-15-preview
216+
```
217+
218+
For **provisioned containers**, start the merge by using [`az cosmosdb mongodb collection merge`](/cli/azure/cosmosdb/mongodb/collection#az-cosmosdb-mongodb-collection-merge).
171219

172220
```azurecli-interactive
173221
az cosmosdb mongodb collection merge \
174222
--resource-group '<resource-group-name>' \
175223
--account-name '<cosmos-account-name>' \
176224
--database-name '<cosmos-database-name>' \
177225
--name '<cosmos-collection-name>'
226+
178227
```
179228

229+
230+
231+
180232
---
181233

182234
### Monitor merge operations
@@ -197,8 +249,6 @@ To enroll in the preview, your Azure Cosmos DB account must meet all the followi
197249

198250
- Your Azure Cosmos DB account uses API for NoSQL or MongoDB with version >=3.6.
199251
- Your Azure Cosmos DB account is using provisioned throughput (manual or autoscale). Merge doesn't apply to serverless accounts.
200-
- Currently, merge isn't supported for shared throughput databases. You may enroll an account that has both shared throughput databases and containers with dedicated throughput (manual or autoscale).
201-
- However, only the containers with dedicated throughput are able to be merged.
202252
- Your Azure Cosmos DB account is a single-write region account (merge isn't currently supported for multi-region write accounts).
203253
- Your Azure Cosmos DB account doesn't use any of the following features:
204254
- [Point-in-time restore](continuous-backup-restore-introduction.md)
@@ -267,3 +317,4 @@ If you enroll in the preview, the following connectors fail.
267317
- Learn more about [using Azure CLI with Azure Cosmos DB.](/cli/azure/azure-cli-reference-for-cosmos-db)
268318
- Learn more about [using Azure PowerShell with Azure Cosmos DB.](/powershell/module/az.cosmosdb/)
269319
- Learn more about [partitioning in Azure Cosmos DB.](partitioning-overview.md)
320+

0 commit comments

Comments
 (0)