Skip to content

Commit f464f52

Browse files
authored
Update configure-synapse-link.md
1 parent bc51076 commit f464f52

File tree

1 file changed

+11
-6
lines changed

1 file changed

+11
-6
lines changed

articles/cosmos-db/configure-synapse-link.md

Lines changed: 11 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -182,18 +182,18 @@ except exceptions.CosmosResourceExistsError:
182182
```
183183
### Command Line Tools
184184

185-
Create analytical store enabled containers by setting `analytical ttl` to `-1`. For information on the various Analytical TTL config options, see the [analytical TTL supported values](analytical-store-introduction.md#analytical-ttl) article.
185+
Analytical store is enabled by setting the `analytical TTL` property when you create the new container. For information on the various Analytical TTL config options, see the [analytical TTL supported values](analytical-store-introduction.md#analytical-ttl) article.
186186

187187
#### Azure CLI
188188

189-
Use the options below with `--analytical-storage-ttl -1` for SQL API containers or `--analytical-storage-ttl -1` for MongoDB API collections.
189+
Use the options below using `--analytical-storage-ttl -1` to enable analytical store with infinite retention for both SQL API containers or MongoDB API collections.
190190

191191
* [Create an Azure Cosmos DB MongoDB collection](/cli/azure/cosmosdb/mongodb/collection#az_cosmosdb_mongodb_collection_create-examples)
192192
* [Create an Azure Cosmos DB SQL API container](/cli/azure/cosmosdb/sql/container#az_cosmosdb_sql_container_create)
193193

194194
#### PowerShell
195195

196-
Use the options below with `--AnalyticalStorageTtl -1` for both SQL API containers or MongoDB API collections.
196+
Use the options below using `-AnalyticalStorageTtl -1` to enable analytical store with infinite retention for both SQL API containers or MongoDB API collections.
197197

198198
* [Create an Azure Cosmos DB MongoDB collection](/powershell/module/az.cosmosdb/new-azcosmosdbmongodbcollection#description)
199199
* [Create an Azure Cosmos DB SQL API container](/powershell/module/az.cosmosdb/new-azcosmosdbsqlcontainer)
@@ -208,7 +208,7 @@ You can turn analytical store on for existing containers in Cosmos DB SQL API ac
208208
* You won't be able to query analytical store of an existing container until the end of the initial sync process.
209209

210210
> [!NOTE]
211-
> Due to short-term capacity constraints, you need to register to enable Synapse Link on your existing containers. Depending on the pending requests, approving this request may take anywhere from a day to a week. Please come back here to check the status. If you have any issues or questions, please reach out to [[email protected]](mailto:[email protected]).
211+
> Due to short-term capacity constraints, you need to register to enable Synapse Link on your existing containers. Depending on the pending requests, approving this request may take anywhere from a day to a week. Please come back here to check the status. If you have any issues or questions, please reach out to [[email protected]](mailto:[email protected]). This step is required once per subscription, and all new database accounts will also have this capability enabled.
212212
213213

214214
> [!NOTE]
@@ -225,17 +225,22 @@ You can turn analytical store on for existing containers in Cosmos DB SQL API ac
225225

226226
### Command Line Tools
227227

228-
Create analytical store enabled containers by setting `analytical ttl` to `-1`. For information on the various Analytical TTL config options, see the [analytical TTL supported values](analytical-store-introduction.md#analytical-ttl) article. Please check that the registration request is also necessary for Azure CLI and PowerShell.
228+
Analytical store is enabled by setting the `analytical TTL` property when you update your container. For information on the various Analytical TTL config options, see the [analytical TTL supported values](analytical-store-introduction.md#analytical-ttl) article.
229+
229230

230231
### Azure CLI
231232

232-
* [Register for approval](/cli/azure/feature/registration) by using `az feature registration create --namespace Microsoft.DocumentDB --name AnalyticalStoreMigration`.
233+
Use the options below using `--analytical-storage-ttl -1` to enable analytical store with infinite retention for SQL API containers.
234+
235+
* [Register for approval](/cli/azure/feature/registration) by using `az feature registration create --namespace Microsoft.DocumentDB --name AnalyticalStoreMigration`.
233236
* [Check the request status](/cli/azure/feature/registration) by using `az feature registration show --namespace Microsoft.DocumentDB --name AnalyticalStoreMigration`.
234237
* [Update Analytical ttl](/cli/azure/cosmosdb/sql/container?view=azure-cli-latest#az_cosmosdb_sql_container_update) to `-1` after the request approval.
235238
* Check the migration status in the Azure portal.
236239

237240
### PowerShell
238241

242+
Use the options below using `-AnalyticalStorageTtl -1` to enable analytical store with infinite retention for both SQL API containers.
243+
239244
* [Register for approval](/powershell/module/az.resources/register-azproviderfeature) using `Register-AzProviderFeature -ProviderName "Microsoft.DocumentDB" -FeatureName "AnalyticalStoreMigration"`.
240245
* [Check the request status](/powershell/module/az.resources/get-azproviderfeature).
241246
* [Update Analytical ttl](/powershell/module/az.cosmosdb/update-azcosmosdbsqlcontainer) to `-1` after the request approval.

0 commit comments

Comments
 (0)