Az cosmosdb sql container redistribute-partition-throughput
← Back to DP-420 Terminology Reference
Category: Throughput & Scaling
Summary: CLI: reallocates RU/s unevenly across physical partitions to relieve a hot partition.
Overview
The Azure CLI command 'az cosmosdb sql container redistribute-partition-throughput' lets you manually redistribute a container's provisioned RU/s unevenly across its physical partitions — allocating more throughput to specific physical partitions and less to others — which is useful when you've identified a known hot physical partition (e.g., via PartitionKeyRUConsumption) and want to temporarily relieve its throttling without increasing the container's total provisioned throughput.
More Info & Links
DP-420 Style Practice Questions
Q1. What does 'az cosmosdb sql container redistribute-partition-throughput' allow you to do?
- A. Manually allocate more RU/s to specific physical partitions and less to others, without changing total throughput
- B. Increase the container's total provisioned RU/s
- C. Change the container's partition key definition
- D. Switch the container between manual and autoscale throughput
Q2. Which diagnostic log table would typically help you identify which physical partition needs more redistributed throughput?
- A. PartitionKeyRUConsumption
- B. ControlPlaneRequests
- C. QueryRuntimeStatistics
- D. DataPlaneRequests
Answer Key
Answers are listed at the very end so you can attempt the questions first.
- Q1 (az cosmosdb sql container redistribute-partition-throughput): A. Manually allocate more RU/s to specific physical partitions and less to others, without changing total throughput — This command redistributes existing RU/s unevenly across physical partitions rather than adding new total throughput.
- Q2 (az cosmosdb sql container redistribute-partition-throughput): A. PartitionKeyRUConsumption — PartitionKeyRUConsumption reports per-second RU consumption per partition key, helping identify hot partitions that could benefit from redistributed throughput.
DP-420: Designing and Implementing Cloud-Native Applications Using Microsoft Azure Cosmos DB — term detail page
