Skip to content

Commit 343cf4f

Browse files
authored
Merge pull request #113773 from SnehaGunda/partners
Updating autoscale and partners doc
2 parents 16e1b72 + 4ec540f commit 343cf4f

13 files changed

+101
-105
lines changed

articles/cosmos-db/TOC.yml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -139,7 +139,7 @@
139139
- name: Provision throughput on containers and databases
140140
displayName: request units, RUs, RU, limits, database throughput, shared throughput, container throughput
141141
href: set-throughput.md
142-
- name: Provision throughput - autoscale mode
142+
- name: Provision throughput - autoscale
143143
href: provision-throughput-autoscale.md
144144
- name: Autoscale FAQ
145145
href: autoscale-faq.md
@@ -1062,7 +1062,7 @@
10621062
href: monitor-server-side-latency.md
10631063
- name: Monitor request unit usage
10641064
href: monitor-request-unit-usage.md
1065-
- name : Use diagnostic logs
1065+
- name : Use Azure monitor logs
10661066
items:
10671067
- name: Monitor with diagnostic logs
10681068
href: cosmosdb-monitor-resource-logs.md

articles/cosmos-db/autoscale-faq.md

Lines changed: 20 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: Frequently asked questions on autoscale mode in Azure Cosmos DB
2+
title: Frequently asked questions on autoscale provisioned throughput in Azure Cosmos DB
33
description: Frequently asked questions about autoscale provisioned throughput for Azure Cosmos DB databases and containers
44
author: deborahc
55
ms.author: dech
@@ -10,36 +10,36 @@ ms.date: 04/28/2020
1010

1111
# Frequently asked questions about autoscale provisioned throughput in Azure Cosmos DB
1212

13-
With provisioned throughput in autoscale mode, Azure Cosmos DB will automatically manage and scale the RU/s of your container or database based on usage. This article answers commonly asked questions about autoscale.
13+
With autoscale provisioned throughput, Azure Cosmos DB will automatically manage and scale the RU/s of your container or database based on usage. This article answers commonly asked questions about autoscale.
1414

1515
## Frequently asked questions
1616

17-
### Is autoscale mode supported for all APIs?
18-
Yes, autoscale mode is supported for all APIs: Core (SQL), Gremlin, Table, Cassandra, and API for MongoDB.
17+
### Is autoscale supported for all APIs?
18+
Yes, autoscale is supported for all APIs: Core (SQL), Gremlin, Table, Cassandra, and API for MongoDB.
1919

20-
### Is autoscale mode supported for multi-master accounts?
21-
Yes, autoscale mode is supported for multi-master accounts. The max RU/s are available in each region that is added to the Cosmos account.
20+
### Is autoscale supported for multi-master accounts?
21+
Yes, autoscale is supported for multi-master accounts. The max RU/s are available in each region that is added to the Cosmos account.
2222

23-
### What is the pricing for autoscale?
23+
### What is the pricing for autoscale ?
2424
Refer to the Azure Cosmos DB [pricing page](https://azure.microsoft.com/pricing/details/cosmos-db/) for details.
2525

2626
### How do I enable autoscale for my containers or databases?
27-
Autoscale mode can be enabled on new containers and databases created using the Azure portal.
27+
Autoscale can be enabled on new containers and databases created using the Azure portal.
2828

29-
### Is there CLI or SDK support to create containers or databases with autoscale mode?
30-
Currently, you can only create resources with autoscale mode from the Azure portal. Support for CLI and SDK is not yet available.
29+
### Is there CLI or SDK support to create containers or databases with autoscale provisioned throughput?
30+
Currently, you can only create resources with autoscale provisioned throughput from the Azure portal. Support for CLI and SDK is not yet available.
3131

3232
### Can I enable autoscale on an existing container or a database?
33-
Currently, you can enable autoscale on new containers and databases when creating them. Support to enable autoscale mode on existing containers and databases is not yet available. You can migrate existing containers to a new container using [Azure Data Factory](../data-factory/connector-azure-cosmos-db.md) or [change feed](change-feed.md).
33+
Currently, you can enable autoscale on new containers and databases when creating them. Support to enable autoscale on existing containers and databases is not yet available. You can migrate existing containers to a new container using [Azure Data Factory](../data-factory/connector-azure-cosmos-db.md) or [change feed](change-feed.md).
3434

35-
### Can I turn off autoscale mode on a container or database?
36-
Yes, you can turn off autoscale by switching to the 'Manual' option for the provisioned throughput. In the current release, after switching from autoscale mode to manual mode, you cannot enable autoscale again for the same resource.
35+
### Can I turn off autoscale on a container or database?
36+
Yes, you can turn off autoscale by switching to the 'standard (Manual)' option for the provisioned throughput. In the current release, after switching from autoscale to standard provisioned throughput, you cannot enable autoscale again for the same resource.
3737

38-
### Is autoscale mode supported for shared throughput databases?
39-
Yes, autoscale mode is supported for shared throughput databases. To enable this feature, select autoscale mode and the **Provision throughput** option when creating the database.
38+
### Is autoscale supported for shared throughput databases?
39+
Yes, autoscale is supported for shared throughput databases. To enable this feature, select autoscale and the **Provision throughput** option when creating the database.
4040

4141
### What is the number of allowed collections per shared throughput database when autoscale is enabled?
42-
For shared throughput databases with autoscale mode enabled, the number of allowed collections is: MIN(25, Max RU/s of database / 1000). For example, if the max throughput of the database is 20,000 RU/s, the database can have MIN(25, 20,000 RU/s / 1000) = 20 collections.
42+
For shared throughput databases with autoscale enabled, the number of allowed collections is: MIN(25, Max RU/s of database / 1000). For example, if the max throughput of the database is 20,000 RU/s, the database can have MIN(25, 20,000 RU/s / 1000) = 20 collections.
4343

4444

4545
### What is the storage limit associated with each max RU/s option?
@@ -50,13 +50,13 @@ See the [autoscale limits](provision-throughput-autoscale.md#autoscale-limits) a
5050
If the storage limit associated with the max throughput of the database or container is exceeded, Azure Cosmos DB will automatically increase the max throughput to the next highest tier that can support that level of storage. For example, suppose a database or container is provisioned with the 4000 RU/s max throughput option, which has a storage limit of 50 GB. If the storage of the resource increases to 100 GB, the max RU/s of the database or container will be automatically increased to 20,000 RU/s, which can support up to 200 GB.
5151

5252
### How quickly will autoscale up and down based on spikes in traffic?
53-
In autoscale mode, you can instantaneously scale up or scale down the RU/s within the minimum and maximum RU/s range, based on incoming traffic. Billing is done at a 1-hour granularity, where you are charged for the highest RU/s in a particular hour.
53+
With autoscale, you can instantaneously scale up or scale down the RU/s within the minimum and maximum RU/s range, based on incoming traffic. Billing is done at a 1-hour granularity, where you are charged for the highest RU/s in a particular hour.
5454

55-
### Can I specify a custom max throughput (RU/s) value for autoscale mode?
55+
### Can I specify a custom max throughput (RU/s) value for autoscale?
5656
Currently, you can select between [four options](provision-throughput-autoscale.md#autoscale-limits) for max throughput (RU/s).
5757

5858
### Can I increase the max RU/s (move to a higher tier) on the database or container?
59-
Yes. From the **Scale & Settings** option for your container, or **Scale** option for your database, you can select a higher max RU/s for autoscale mode. This is an asynchronous scale-up operation that may take sometime to complete (typically 4-6 hours, depending on the RU/s selected) as the service provisions more resources to support the higher scale.
59+
Yes. From the **Scale & Settings** option for your container, or **Scale** option for your database, you can select a higher max RU/s for autoscale. This is an asynchronous scale-up operation that may take sometime to complete (typically 4-6 hours, depending on the RU/s selected) as the service provisions more resources to support the higher scale.
6060

6161
### Can I reduce the max RU/s (move to a lower tier) on the database or container?
6262
Yes. As long as the current storage of the database or container is below the [storage limit](#what-is-the-storage-limit-associated-with-each-max-rus-option) associated with the max RU/s tier you want to scale down to, you can reduce the max RU/s to that tier. For example, if you have selected 20,000 RU/s as the max RU/s, you can scale down the max RU/s to 4000 RU/s if you have less than 50 GB of storage (the storage limit associated with 4000 RU/s).
@@ -82,5 +82,5 @@ For example, if you select the 20,000 RU/s max throughput option and have 200 GB
8282
## Next steps
8383

8484
* Learn how to [enable autoscale on an Azure Cosmos container or database](provision-throughput-autoscale.md#create-db-container-autoscale).
85-
* Learn about the [benefits of provisioned throughput in autoscale mode](provision-throughput-autoscale.md#autoscale-benefits).
85+
* Learn about the [benefits of provisioned throughput with autoscale ](provision-throughput-autoscale.md#autoscale-benefits).
8686
* Learn more about [logical and physical partitions](partition-data.md).

articles/cosmos-db/concepts-limits.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -133,9 +133,9 @@ Cosmos DB uses HMAC for authorization. You can use either a master key, or a [re
133133

134134
Cosmos DB supports execution of triggers during writes. The service supports a maximum of one pre-trigger and one post-trigger per write operation.
135135

136-
## Autoscale mode limits
136+
## Limits for autoscale provisioned throughput
137137

138-
See the [Autoscale](provision-throughput-autoscale.md#autoscale-limits) article for the throughput and storage limits in autoscale mode.
138+
See the [Autoscale](provision-throughput-autoscale.md#autoscale-limits) article for the throughput and storage limits with autoscale.
139139

140140
## SQL query limits
141141

articles/cosmos-db/manage-cassandra-with-resource-manager.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,7 @@ To create any of the Azure Cosmos DB resources below, copy the following example
2424

2525
<a id="create-autoscale"></a>
2626

27-
## Azure Cosmos account for Cassandra with autoscale throughput
27+
## Azure Cosmos account for Cassandra with autoscale provisioned throughput
2828

2929
This template creates an Azure Cosmos account in two regions with options for consistency and failover, with a keyspace and table configured for autoscale throughput. This template is also available for one-click deploy from Azure Quickstart Templates Gallery.
3030

@@ -34,9 +34,9 @@ This template creates an Azure Cosmos account in two regions with options for co
3434

3535
<a id="create-manual"></a>
3636

37-
## Azure Cosmos account for Cassandra with manual throughput
37+
## Azure Cosmos account for Cassandra with standard (manual) provisioned throughput
3838

39-
This template creates an Azure Cosmos account in two regions with options for consistency and failover, with a keyspace and table configured for manual throughput. This template is also available for one-click deploy from Azure Quickstart Templates Gallery.
39+
This template creates an Azure Cosmos account in two regions with options for consistency and failover, with a keyspace and table configured for standard throughput. This template is also available for one-click deploy from Azure Quickstart Templates Gallery.
4040

4141
[![Deploy to Azure](https://aka.ms/deploytoazurebutton)](https://portal.azure.com/#create/Microsoft.Template/uri/https%3A%2F%2Fraw.githubusercontent.com%2FAzure%2Fazure-quickstart-templates%2Fmaster%2F101-cosmosdb-cassandra%2Fazuredeploy.json)
4242

articles/cosmos-db/manage-gremlin-with-resource-manager.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,7 @@ To create any of the Azure Cosmos DB resources below, copy the following example
2424

2525
<a id="create-autoscale"></a>
2626

27-
## Azure Cosmos DB account for Gremlin with autoscale throughput
27+
## Azure Cosmos DB account for Gremlin with autoscale provisioned throughput
2828

2929
This template will create an Azure Cosmos account for Gremlin API with a database and graph with autoscale throughput.
3030

@@ -36,9 +36,9 @@ This template is also available for one-click deploy from Azure Quickstart Templ
3636

3737
<a id="create-manual"></a>
3838

39-
## Azure Cosmos DB account for Gremlin with manual throughput
39+
## Azure Cosmos DB account for Gremlin with standard provisioned throughput
4040

41-
This template will create an Azure Cosmos account for Gremlin API with a database and graph with manual throughput.
41+
This template will create an Azure Cosmos account for Gremlin API with a database and graph with standard (manual) throughput.
4242

4343
This template is also available for one-click deploy from Azure Quickstart Templates Gallery.
4444

articles/cosmos-db/manage-mongodb-with-resource-manager.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,7 @@ To create any of the Azure Cosmos DB resources below, copy the following example
2424

2525
<a id="create-autoscale"></a>
2626

27-
## Azure Cosmos account for MongoDB with autoscale throughput
27+
## Azure Cosmos account for MongoDB with autoscale provisioned throughput
2828

2929
This template will create an Azure Cosmos account for MongoDB API (3.2 or 3.6) with two collections that share autoscale throughput at the database level. This template is also available for one-click deploy from Azure Quickstart Templates Gallery.
3030

@@ -34,9 +34,9 @@ This template will create an Azure Cosmos account for MongoDB API (3.2 or 3.6) w
3434

3535
<a id="create-manual"></a>
3636

37-
## Azure Cosmos account for MongoDB with manual throughput
37+
## Azure Cosmos account for MongoDB with standard provisioned throughput
3838

39-
This template will create an Azure Cosmos account for MongoDB API (3.2 or 3.6) with two collections that share 400 RU/s manual throughput at the database level. This template is also available for one-click deploy from Azure Quickstart Templates Gallery.
39+
This template will create an Azure Cosmos account for MongoDB API (3.2 or 3.6) with two collections that share 400 RU/s standard (manual) throughput at the database level. This template is also available for one-click deploy from Azure Quickstart Templates Gallery.
4040

4141
[![Deploy to Azure](https://aka.ms/deploytoazurebutton)](https://portal.azure.com/#create/Microsoft.Template/uri/https%3A%2F%2Fraw.githubusercontent.com%2FAzure%2Fazure-quickstart-templates%2Fmaster%2F101-cosmosdb-mongodb%2Fazuredeploy.json)
4242

articles/cosmos-db/manage-scale-cassandra.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -53,9 +53,9 @@ You can scale the system dynamically with code by executing the [CQL ALTER comma
5353

5454
The advantage of this approach is that it allows you to respond to scale needs dynamically and in a custom way that suits your application. With this approach, you can still leverage the standard RU/s charges and rates. If your system's scale needs are mostly predictable (around 70% or more), using SDK with CQL may be a more cost-effective method of auto-scaling than using autoscale. The disadvantage of this approach is that it can be quite complex to implement retries while rate limiting may increase latency.
5555

56-
## <a id="use-autoscale"></a>Use autoscale
56+
## <a id="use-autoscale"></a>Use autoscale provisioned throughput
5757

58-
In addition to manual or programmatic way of provisioning throughput, you can also configure Azure cosmos containers in autoscale mode. Autoscale mode will automatically and instantly scale to your consumption needs within specified RU ranges without compromising SLAs. To learn more, see the [Create Azure Cosmos containers and databases in autoscale mode](provision-throughput-autoscale.md) article.
58+
In addition to standard (manual) or programmatic way of provisioning throughput, you can also configure Azure cosmos containers in autoscale provisioned throughput. Autoscale will automatically and instantly scale to your consumption needs within specified RU ranges without compromising SLAs. To learn more, see the [Create Azure Cosmos containers and databases in autoscale](provision-throughput-autoscale.md) article.
5959

6060
The advantage of this approach is that it is the easiest way to manage the scaling needs in your system. It guarantees not to apply rate-limiting **within the configured RU ranges**. The disadvantage is that, if the scaling needs in your system are predictable, autoscale may be a less cost-effective way of handling your scaling needs than using the bespoke control plane or SDK level approaches mentioned above.
6161

articles/cosmos-db/manage-sql-with-resource-manager.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -35,9 +35,9 @@ This template creates an Azure Cosmos account in two regions with options for co
3535

3636
<a id="create-manual"></a>
3737

38-
## Azure Cosmos account with manual throughput
38+
## Azure Cosmos account with standard (manual) throughput
3939

40-
This template creates an Azure Cosmos account in two regions with options for consistency and failover, with database and container configured for manual throughput that has most policy options enabled. This template is also available for one-click deploy from Azure Quickstart Templates Gallery.
40+
This template creates an Azure Cosmos account in two regions with options for consistency and failover, with database and container configured for standard throughput that has most policy options enabled. This template is also available for one-click deploy from Azure Quickstart Templates Gallery.
4141

4242
[![Deploy to Azure](https://aka.ms/deploytoazurebutton)](https://portal.azure.com/#create/Microsoft.Template/uri/https%3A%2F%2Fraw.githubusercontent.com%2FAzure%2Fazure-quickstart-templates%2Fmaster%2F101-cosmosdb-sql%2Fazuredeploy.json)
4343

articles/cosmos-db/manage-table-with-resource-manager.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -37,9 +37,9 @@ This template will create an Azure Cosmos account for Table API with one table w
3737

3838
<a id="create-manual"></a>
3939

40-
## Azure Cosmos account for Table with manual throughput
40+
## Azure Cosmos account for Table with standard (manual) throughput
4141

42-
This template will create an Azure Cosmos account for Table API with one table with manual throughput. This template is also available for one-click deploy from Azure Quickstart Templates Gallery.
42+
This template will create an Azure Cosmos account for Table API with one table with standard throughput. This template is also available for one-click deploy from Azure Quickstart Templates Gallery.
4343

4444
[![Deploy to Azure](https://aka.ms/deploytoazurebutton)](https://portal.azure.com/#create/Microsoft.Template/uri/https%3A%2F%2Fraw.githubusercontent.com%2FAzure%2Fazure-quickstart-templates%2Fmaster%2F101-cosmosdb-table%2Fazuredeploy.json)
4545

articles/cosmos-db/mongodb-pre-migration.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -25,7 +25,7 @@ If you have already completed the above pre-requisites for migration, you can [M
2525

2626
The following are specific characteristics about Azure Cosmos DB's API for MongoDB:
2727

28-
- **Capacity model**: Database capacity on Azure Cosmos DB is based on a throughput-based model. This model is based on [Request Units per second](request-units.md), which is a unit that represents the number of database operations that can be executed against a collection on a per-second basis. This capacity can be allocated at [a database or collection level](set-throughput.md), and it can be provisioned on an allocation model, or using the [Autoscale model](provision-throughput-autoscale.md).
28+
- **Capacity model**: Database capacity on Azure Cosmos DB is based on a throughput-based model. This model is based on [Request Units per second](request-units.md), which is a unit that represents the number of database operations that can be executed against a collection on a per-second basis. This capacity can be allocated at [a database or collection level](set-throughput.md), and it can be provisioned on an allocation model, or using the [autoscale provisioned throughput](provision-throughput-autoscale.md).
2929

3030
- **Request Units**: Every database operation has an associated Request Units (RUs) cost in Azure Cosmos DB. When executed, this is subtracted from the available request units level on a given second. If a request requires more RUs than the currently allocated RU/s there are two options to solve the issue - increase the amount of RUs, or wait until the next second starts and then retry the operation.
3131

0 commit comments

Comments
 (0)