Updated: November 27, 2024 (October 6, 2024)

  Charts & Illustrations

Azure Cosmos DB Partitions Across Regions

My Atlas / Charts & Illustrations

223 wordsTime to read: 2 min
Rob Sanfilippo by
Rob Sanfilippo

Before joining Directions on Microsoft, Rob worked at Microsoft for 14 years where he designed technologies for Microsoft products and... more

Cosmos DB data is organized into several layers of hierarchy. Shown here is an example deployment with a single database and a container replicated across two Azure regions.

A customer creates a Cosmos DB account within an Azure subscription. Databases are created within the account, and containers are created within each database.

Containers are divided into logical and physical partitions to distribute storage and database activity across compute resources. Logical partitions are created by the service based on a partition key specified by the customer for a container. The partition key maps to a property on items stored in the database. The selected partition key shown here is Division. Each value of Division is stored in a separate logical partition; in this example, Division has six values, so there are six logical partitions. 

Physical partitions are created by the service based on the number and size of logical partitions. Each logical partition resides within a single physical partition, but a physical partition can contain multiple logical partitions.

Atlas Members have full access

Get access to this and thousands of other unbiased analyses, roadmaps, decision kits, infographics, reference guides, and more, all included with membership. Comprehensive access to the most in-depth and unbiased expertise for Microsoft enterprise decision-making is waiting.

Membership Options

Already have an account? Login Now