Skip to content

Commit cdf70f7

Browse files
committed
Renaming files
1 parent 5055c96 commit cdf70f7

9 files changed

+31
-21
lines changed

.openpublishing.redirection.json

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2352,6 +2352,16 @@
23522352
"redirect_url": "/azure/cosmos-db/conflict-resolution-policies",
23532353
"redirect_document_id": true
23542354
},
2355+
{
2356+
"source_path": "articles/cosmos-db/provision-throughput-autopilot.md",
2357+
"redirect_url": "/azure/cosmos-db/provision-throughput-autoscale",
2358+
"redirect_document_id": true
2359+
},
2360+
{
2361+
"source_path": "articles/cosmos-db/autopilot-faq.md",
2362+
"redirect_url": "/azure/cosmos-db/autoscale-faq",
2363+
"redirect_document_id": true
2364+
},
23552365
{
23562366
"source_path": "articles/cosmos-db/how-to-custom-synchronization.md",
23572367
"redirect_url": "/azure/cosmos-db/how-to-multi-master",

articles/cosmos-db/TOC.yml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -137,9 +137,9 @@
137137
displayName: request units, RUs, RU, limits, database throughput, shared throughput, container throughput
138138
href: set-throughput.md
139139
- name: Provision throughput - autoscale mode
140-
href: provision-throughput-autopilot.md
140+
href: provision-throughput-autoscale.md
141141
- name: Autoscale FAQ
142-
href: autopilot-faq.md
142+
href: autoscale-faq.md
143143
- name: SQL query
144144
items:
145145
- name: Getting started

articles/cosmos-db/autopilot-faq.md renamed to articles/cosmos-db/autoscale-faq.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ author: deborahc
55
ms.author: dech
66
ms.service: cosmos-db
77
ms.topic: conceptual
8-
ms.date: 04/24/2020
8+
ms.date: 04/28/2020
99
---
1010

1111
# Frequently asked questions about autoscale provisioned throughput in Azure Cosmos DB
@@ -44,7 +44,7 @@ For shared throughput databases with autoscale mode enabled, the number of allow
4444

4545
### What is the storage limit associated with each max RU/s option?
4646
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.
47-
See the [autoscale limits](provision-throughput-autopilot.md#autoscale-limits) article for the available max RU/s and storage options.
47+
See the [autoscale limits](provision-throughput-autoscale.md#autoscale-limits) article for the available max RU/s and storage options.
4848

4949
### What happens if I exceed the storage limit associated with my max throughput?
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.
@@ -53,7 +53,7 @@ If the storage limit associated with the max throughput of the database or conta
5353
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.
5454

5555
### Can I specify a custom max throughput (RU/s) value for autoscale mode?
56-
Currently, you can select between [four options](provision-throughput-autoscale.md#autopilot-limits) for max throughput (RU/s).
56+
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?
5959
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.
@@ -70,9 +70,9 @@ The Max RU/s of the database or container is divided evenly across all physical
7070
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.
7171

7272
> [!NOTE]
73-
> 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).
73+
> 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](#autoscale-rate-limiting).
7474
75-
### Is it still possible to see 429s (throttling/rate limiting) when autoscale is enabled?
75+
### <a id="autoscale-rate-limiting"></a> Is it still possible to see 429s (throttling/rate limiting) when autoscale is enabled?
7676
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.
7777

7878
Second, if there is a hot partition, i.e. a logical partition key value that has a disproportionately higher amount of requests compared to other partition key values, it is possible for the underlying physical partition to exceed its RU/s budget. As a best practice, to avoid hot partitions, [choose a good partition key](partitioning-overview.md#choose-partitionkey) that results in an even distribution of both storage and throughput.
@@ -81,6 +81,6 @@ For example, if you select the 20,000 RU/s max throughput option and have 200 GB
8181

8282
## Next steps
8383

84-
* Learn how to [enable autoscale on an Azure Cosmos container or database](provision-throughput-autopilot.md#create-a-database-or-a-container-with-autopilot-mode).
85-
* Learn about the [benefits of provisioned throughput in autoscale mode](provision-throughput-autopilot.md#benefits-of-autopilot-mode).
84+
* 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).
8686
* Learn more about [logical and physical partitions](partition-data.md).

articles/cosmos-db/concepts-limits.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -135,7 +135,7 @@ Cosmos DB supports execution of triggers during writes. The service supports a m
135135

136136
## Autoscale mode limits
137137

138-
See the [Autoscale](provision-throughput-autopilot.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 in autoscale mode.
139139

140140
## SQL query limits
141141

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

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -45,7 +45,7 @@ The Azure Cosmos DB's API for Cassandra provides the capability to adjust throug
4545

4646
The advantage of this method is that you can automate the scaling up or down of resources based on a timer to account for peak activity, or periods of low activity. Take a look at our sample [here](https://github.com/Azure-Samples/azure-cosmos-throughput-scheduler) for how to accomplish this using Azure Functions and Powershell.
4747

48-
A disadvantage with this approach may be that you cannot respond to unpredictable changing scale needs in real-time. Instead, you may need to leverage the application context in your system, at the client/SDK level, or using [Autoscale](provision-throughput-autopilot.md).
48+
A disadvantage with this approach may be that you cannot respond to unpredictable changing scale needs in real-time. Instead, you may need to leverage the application context in your system, at the client/SDK level, or using [Autoscale](provision-throughput-autoscale.md).
4949

5050
## <a id="use-cql-queries"></a>Use CQL queries with a specific SDK
5151

@@ -55,7 +55,7 @@ The advantage of this approach is that it allows you to respond to scale needs d
5555

5656
## <a id="use-autoscale"></a>Use Autoscale
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-autopilot.md) article.
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.
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/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-autopilot.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 model](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

articles/cosmos-db/provision-throughput-autopilot.md renamed to articles/cosmos-db/provision-throughput-autoscale.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,27 +1,27 @@
11
---
22
title: Create Azure Cosmos containers and databases in autoscale mode.
3-
description: Learn about the benefits, use cases, and how to provision Azure Cosmos databases and containers in autopilot mode.
3+
description: Learn about the benefits, use cases, and how to provision Azure Cosmos databases and containers in autoscale mode.
44
author: kirillg
55
ms.author: kirillg
66
ms.service: cosmos-db
77
ms.topic: conceptual
8-
ms.date: 11/04/2019
8+
ms.date: 04/28/2020
99
---
1010

1111
# Create Azure Cosmos containers and databases in autoscale mode
1212

1313
Azure Cosmos DB allows you to provision throughput on your containers in either manual or autoscale mode. This article describes the benefits and use cases of autoscale mode.
1414

1515
> [!NOTE]
16-
> You can [enable autoscale for new databases and containers](#create-a-database-or-a-container-with-autopilot-mode) only. It is not available for existing containers and databases.
16+
> You can [enable autoscale for new databases and containers](#create-db-container-autoscale) only. It is not available for existing containers and databases.
1717
1818
In addition to manual provisioning of throughput, you can now configure Azure Cosmos containers in autoscale mode. Containers and databases configured in autoscale mode will **automatically and instantly scale the provisioned throughput based on your application needs without impacting the availability, latency, throughput, or performance of the workload globally.**
1919

2020
When configuring containers and databases in autoscale mode, you need to specify the maximum throughput `Tmax` not to be exceeded. Containers can then scale their throughput so that `0.1*Tmax < T < Tmax`. In other words, containers and databases scale instantly based on the workload needs, from as low as 10% of the maximum throughput value that you have configured up to the configured maximum throughput value. After configuring autoscale, you can change the maximum throughput (`Tmax`) setting on a database or container at any point in time. With the autoscale option, the 400 RU/s minimum throughput per container or database is no longer applicable.
2121

2222
For the specified maximum throughput on the container or the database, the system allows operating within the calculated storage limit. If the storage limit is exceeded, then the maximum throughput is automatically adjusted to a higher value. When using database level throughput with autoscale mode, the number of containers allowed within a database is calculated as: `0.001*TMax`. For example, if you provision 20,000 autoscale RU/s, then the database can have 20 containers.
2323

24-
## Benefits of autoscale mode
24+
## <a id="autoscale-benefits"></a> Benefits of autoscale mode
2525

2626
Azure Cosmos containers that are configured in autoscale mode have the following benefits:
2727

@@ -33,7 +33,7 @@ Azure Cosmos containers that are configured in autoscale mode have the following
3333

3434
* **Highly available:** Containers in autoscale mode use the same globally distributed, fault-tolerant, highly available backend to ensure data durability and high availability.
3535

36-
## Use cases of autoscale mode
36+
## <a id="autoscale-usecases"></a> Use cases of autoscale mode
3737

3838
The use cases for Azure Cosmos containers configured in autoscale mode include:
3939

@@ -61,7 +61,7 @@ Solutions to the previous problems not only require an enormous amount of time i
6161
| **Pricing** | Manually provisioned RU/s per hour. | For single write region accounts, you pay for the throughput used on an hourly basis, by using the autoscale RU/s per hour rate. <br/><br/>For accounts with multiple write regions, there is no extra charge for autoscale. You pay for the throughput used on hourly basis using the same multi-master RU/s per hour rate. |
6262
| **Best suited for workload types** | Predictable and stable workloads| Unpredictable and variable workloads |
6363

64-
## Create a database or a container with autoscale mode
64+
## <a id="create-db-container-autoscale"></a> Create a database or a container with autoscale mode
6565

6666
You can configure autoscale for new databases or containers when creating them through the Azure portal. Use the following steps to create a new database or container, enable autoscale, and specify the maximum throughput (RU/s).
6767

@@ -71,7 +71,7 @@ You can configure autoscale for new databases or containers when creating them t
7171

7272
1. Select **New Container.** Enter a name for your database, container, and a partition key. Under **Throughput**, select the **Autoscale** option, and choose the maximum throughput (RU/s) that the database or container cannot exceed when using the autoscale option.
7373

74-
![Creating a container and configuring Autoscale throughput](./media/provision-throughput-autopilot/create-container-autopilot-mode.png)
74+
![Creating a container and configuring Autoscale throughput](./media/pprovision-throughput-autoscale/create-container-autoscale-mode.png)
7575

7676
1. Select **OK**.
7777

@@ -90,7 +90,7 @@ The following table shows the maximum throughout and storage limits for differen
9090

9191
## Next steps
9292

93-
* Review the [autoscale FAQ](autopilot-faq.md).
93+
* Review the [autoscale FAQ](autoscale-faq.md).
9494
* Learn more about [logical partitions](partition-data.md).
9595
* Learn how to [provision throughput on an Azure Cosmos container](how-to-provision-container-throughput.md).
9696
* Learn how to [provision throughput on an Azure Cosmos database](how-to-provision-database-throughput.md).

0 commit comments

Comments
 (0)