知识条目 / Azure Cosmos DB
Azure Cosmos DB RU 消耗过高如何排查?
通过 RU 计费明细、分区键与索引策略定位高消耗查询,区分跨分区查询与索引膨胀。
Cosmos DB 以请求单位计费,一次查询消耗的 RU 取决于数据量、索引和分区命中情况。出现 429 或成本飙升时,先找出高 RU 语句,再检查分区键与索引策略。
处理步骤
- 定位高 RU 操作开启诊断日志或使用门户指标查看按操作类型、集合和查询文本的 RU 分布,优先处理单次 RU 高或调用量大的语句。
- 检查分区键命中跨分区查询会 fan-out 到多个分区并显著增加 RU。确认查询条件包含分区键,避免无条件扫描和高基数聚合。
- 优化索引策略默认全字段索引会增加写入 RU。对不参与过滤的路径使用排除策略,并确认范围与复合索引满足常用排序查询。
- 处理限流与重试遇到 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