知识条目 / Azure Cosmos DB

Azure Cosmos DB RU 消耗过高如何排查?

通过 RU 计费明细、分区键与索引策略定位高消耗查询,区分跨分区查询与索引膨胀。

Cosmos DB 以请求单位计费,一次查询消耗的 RU 取决于数据量、索引和分区命中情况。出现 429 或成本飙升时,先找出高 RU 语句,再检查分区键与索引策略。

处理步骤

  1. 定位高 RU 操作开启诊断日志或使用门户指标查看按操作类型、集合和查询文本的 RU 分布,优先处理单次 RU 高或调用量大的语句。
  2. 检查分区键命中跨分区查询会 fan-out 到多个分区并显著增加 RU。确认查询条件包含分区键,避免无条件扫描和高基数聚合。
  3. 优化索引策略默认全字段索引会增加写入 RU。对不参与过滤的路径使用排除策略,并确认范围与复合索引满足常用排序查询。
  4. 处理限流与重试遇到 429 时读取响应中的重试等待时间,使用 SDK 内置重试与退避。持续限流再评估手动或自动吞吐调整。

示例

SELECT TOP 20 *
FROM c
WHERE c.tenantId = "t-1001"
ORDER BY c.createdAt DESC

-- 查询返回的请求消耗可在 SDK 响应头中查看
-- x-ms-request-charge: 12.5

{
  "indexingMode": "consistent",
  "includedPaths": [{ "path": "/tenantId/?" }, { "path": "/createdAt/?" }],
  "excludedPaths": [{ "path": "/*" }]
}

修改索引策略会触发索引重建,期间查询能力可能受限。生产变更前先评估集合大小与重建耗时。

关键词

cosmos db · cosmosdb · ru · 请求单位 · 分区键 · 跨分区 · 索引策略 · 限流 · 429 · azure