Skip to content

Commit 117cb37

Browse files
deborahcSnehaGunda
andauthored
Apply wording suggestions from Sneha
Co-Authored-By: Sneha Gunda <[email protected]>
1 parent 560517b commit 117cb37

File tree

1 file changed

+10
-9
lines changed

1 file changed

+10
-9
lines changed

articles/cosmos-db/autopilot-faq.md

Lines changed: 10 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: Autopilot FAQ
2+
title: Frequently asked questions about throughput in autopilot mode
33
description: Frequently asked questions about autopilot mode for Azure Cosmos DB databases and containers
44
author: deborahc
55
ms.author: dech
@@ -24,24 +24,24 @@ Refer to the Azure Cosmos DB [pricing page](https://azure.microsoft.com/pricing/
2424
Once you are [enrolled in the preview](provision-throughput-autopilot.md#enable-autopilot), autopilot mode can be enabled on new containers and databases created using the Azure portal.
2525

2626
### Is there CLI or SDK support to create containers or databases with autopilot mode?
27-
Currently, in the preview, the only way to create resources with autopilot mode is through the Azure portal. Support for CLI and SDK is planned for GA.
27+
Currently, in the preview release, you can only create resources with autopilot mode from the Azure portal. Support for CLI and SDK is not yet available and is planned for GA release.
2828

29-
### Can autopilot be enabled on an existing container or database?
29+
### Can I enable autopilot on an existing container or a database?
3030
Currently, autopilot can only be enabled on new containers and databases when they are first created. Support to enable autopilot on existing resources is planned for GA.
3131

3232
### Can I turn off autopilot mode on a container or database?
33-
Yes, you can turn off autopilot by switching back to the 'Manual' option for provisioned throughput. However, in the preview, you will not be able to enable autopilot again for the same resource.
33+
Yes, you can turn off autopilot by switching to the 'Manual' option for the provisioned throughput. In the preview release, after switching from autopilot mode to manual mode, you cannot enable autopilot again for the same resource.
3434

3535
### Is autopilot mode supported for shared throughput databases?
36-
Yes, autopilot mode is supported for shared throughput databases. To enable this feature, select autopilot mode and the **Provision throughput** option at the time of database creation.
36+
Yes, autopilot mode is supported for shared throughput databases. To enable this feature, select autopilot mode and the **Provision throughput** option when creating the database.
3737

3838
### What is the number of allowed collections per shared throughput database when autopilot is enabled?
3939
For shared throughput databases with autopilot 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.
4040

4141

4242
### What is the storage limit associated with each max RU/s option?
4343
The storage limit in GB for each max RU/s is: Max RU/s of database or container / 100. For example, if the max RU/s is 20,000 RU/s, the resource can support 200 GB of storage.
44-
See [this article](provision-throughput-autopilot.md#autopilot-limits) for the available max RU/s and storage options.
44+
See the [autopilot limits](provision-throughput-autopilot.md#autopilot-limits) article for the available max RU/s and storage options.
4545

4646
### What happens if I exceed the storage limit associated with my max throughput?
4747
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.
@@ -50,10 +50,10 @@ If the storage limit associated with the max throughput of the database or conta
5050
Autopilot will 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.
5151

5252
### Can I specify a custom max throughput (RU/s) value for autopilot mode?
53-
Currently, in the preview, you can select between [four options](provision-throughput-autopilot.md#autopilot-limits) for max throughput (RU/s). Support for custom, user-specified values of max throughput is planned for GA.
53+
Currently, during the preview release, you can select between [four options](provision-throughput-autopilot.md#autopilot-limits) for max throughput (RU/s). Support for custom, user-specified values of max throughput is planned for GA.
5454

5555
### Can I increase the max RU/s (move to a higher tier) on the database or container?
56-
Yes. From the **Scale & Settings** option for your container, or **Scale** option for your database, you can select a higher max RU/s for autopilot. This is an asynchronous scale-up operation that may take some to complete (typically 4-6 hours, depending on the RU/s selected) as the service provisions more resources to support the higher scale.
56+
Yes. From the **Scale & Settings** option for your container, or **Scale** option for your database, you can select a higher max RU/s for autopilot. 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.
5757

5858
### Can I reduce the max RU/s (move to a lower tier) on the database or container?
5959
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).
@@ -66,7 +66,8 @@ The Max RU/s of the database or container is divided evenly across all physical
6666
### What happens if incoming requests exceed the max RU/s of the database or container?
6767
If the overall consumed RU/s exceeds the max RU/s of the container or database, requests that exceed the max RU/s will be throttled and return a 429 status code. Requests that result in over 100% normalized utilization will also be throttled. Normalized utilization is defined as the max of the RU/s utilization across all physical partitions. For example, suppose your max throughput is 20,000 RU/s and you have two physical partitions, P_1 and P_2, each capable of scaling to 10,000 RU/s. In a given second, if P_1 has used 6000 RUs, and P_2 8000 RUs, the normalized utilization is MAX(6000 RU / 10,000 RU, 8000 RU / 10,000 RU) = 0.8.
6868

69-
Note: The Azure Cosmos DB client SDKs and data import tools (Azure Data Factory, bulk executor library) automatically retry on 429s, so occasional 429s are fine. A sustained high number of 429s may indicate you need to increase the max RU/s or review your partitioning strategy for a [hot partition](#is-it-still-possible-to-see-429s-throttlingrate-limiting-when-autopilot-is-enabled).
69+
> [!NOTE]
70+
> The Azure Cosmos DB client SDKs and data import tools (Azure Data Factory, bulk executor library) automatically retry on 429s, so occasional 429s are fine. A sustained high number of 429s may indicate you need to increase the max RU/s or review your partitioning strategy for a [hot partition](#is-it-still-possible-to-see-429s-throttlingrate-limiting-when-autopilot-is-enabled).
7071
7172
### Is it still possible to see 429s (throttling/rate limiting) when autopilot is enabled?
7273
Yes. It is possible to see 429s in two scenarios. First, when the overall consumed RU/s exceeds the max RU/s of the container or database, the service will throttle requests accordingly.

0 commit comments

Comments
 (0)