Best practices for choosing and designing partition keys in Azure Cosmos DB.
When to Apply
Reference these guidelines when:
- Choosing a partition key for a new container
- Evaluating partition key cardinality
- Designing for even write distribution
- Using hierarchical partition keys
- Planning for logical partition size limits
Rules
- partition-high-cardinality - Choose high-cardinality partition keys
- partition-avoid-hotspots - Distribute writes evenly
- partition-hierarchical - Use hierarchical partition keys for flexibility
- partition-query-patterns - Align partition key with query patterns
- partition-synthetic-keys - Create synthetic keys when needed
- partition-key-length - Respect partition key value length limits
- partition-immutable-key - Choose immutable properties as partition keys
- partition-20gb-limit - Plan for 20GB logical partition limit
Full Compiled Document
For all rules expanded: AGENTS.md