使用PartitionKey后Azure Cosmos DB仍仅用1个物理分区问题排查

核心逻辑：物理分区的创建依赖阈值触发，而非分区键存在即自动拆分 #

Azure Cosmos DB 的物理分区不会仅因为定义了分区键就自动生成多个，只有当单个物理分区达到以下任一阈值时，才会自动触发拆分：

• 存储容量达到 50GB
• 吞吐量消耗超过 10,000 RU/s（自动缩放容器则为容器最大 RU 的 1/10）

如果你的数据量或吞吐量还没达到上述阈值，即便分区键有多个取值，也只会保留 1 个物理分区，这属于正常行为。

具体排查方向 #

• 检查数据分布是否均匀

  • 确认容器内是否已有多个不同 range 值的数据。如果当前仅写入了 range=1 的数据，自然只会有一个物理分区。
  • 验证后续写入的数据是否正确分配到了不同 range 值上，比如是否存在 range=2、range=3 等数据。

• 确认分区键配置与使用是否正确

  • 在 Azure 门户容器的「数据资源管理器」中，查看容器的分区键是否确实设置为 /range。
  • 检查代码中 CRUD 操作是否正确传递了分区键参数，比如读取数据时：

    var response = await container.ReadItemAsync<YourModel>(
        itemId: "your-item-id",
        partitionKey: new PartitionKey("2") // 对应目标range值
    );
    

  • 确认容器创建代码中是否指定了正确的分区键：

    var containerProps = new ContainerProperties("YourContainer", "/range");
    await database.CreateContainerIfNotExistsAsync(containerProps);
    

• 查看指标确认是否达到拆分条件
  在 Azure 门户容器的「指标」面板中，查看以下指标：

  • 物理分区存储：确认是否接近 50GB 上限
  • 物理分区吞吐量使用情况：确认是否超过单分区吞吐量阈值

内容的提问来源于stack exchange，提问作者ABC DEF