如何解读Cosmos DB Query Stats及文档大小超限疑问咨询

我来帮你理清这两个问题——首先是怎么获取Cosmos DB的Query Stats，然后解释你遇到的文档大小统计困惑：

一、读取Cosmos DB Query Stats的几种方法 #

Azure门户操作 #

这是最直观的方式，适合快速查看：

• 登录Azure门户，进入你的Cosmos DB账户
• 切换到「数据资源管理器」，选中对应的容器
• 点击「新建SQL查询」，输入并执行你的查询
• 查询完成后，点击结果区域上方的「查询统计」按钮，就能看到完整的Query Stats，包括请求消耗的RU、检索到的文档总大小、索引命中情况等细节。

通过SDK获取（以.NET为例） #

如果你需要在代码里获取Query Stats，可以从查询响应的诊断信息中提取：

var queryIterator = container.GetItemQueryIterator<YourItemType>("SELECT * FROM c");
while (queryIterator.HasMoreResults)
{
    var response = await queryIterator.ReadNextAsync();
    // 诊断信息里包含完整的Query Stats
    var queryMetrics = response.Diagnostics.ToString();
    Console.WriteLine("Query Stats:\n" + queryMetrics);
    // 也可以直接获取请求费用（RU消耗）
    Console.WriteLine($"本次请求消耗: {response.RequestCharge} RU");
}

其他语言的SDK（比如Python、Java）逻辑类似，都能从查询响应的诊断属性中拿到Query Stats数据。

REST API方式 #

调用Cosmos DB的查询REST API时，只需在请求头中添加x-ms-documentdb-populatequerymetrics: true，响应头里的x-ms-documentdb-query-metrics就会返回JSON格式的Query Stats数据。

二、关于文档大小统计的困惑解释 #

你在Query Stats里看到的「检索到的文档大小超过5MB」，绝对不是单个Item的大小——这里统计的是本次查询返回的所有Item的总大小之和。

Cosmos DB的单个Item 2MB硬限制是刚性的：任何试图写入超过2MB的Item都会直接失败，根本无法存储到数据库中。举个简单的例子：如果你的查询返回了3个各1.8MB的Item，总大小就是5.4MB，这时候Query Stats里的总检索大小就会显示超过5MB，但每个单个Item都符合2MB的限制，这完全是正常场景。

另外要补充一点：Query Stats里的这个数值偶尔还会包含索引相关的临时计算数据，但核心还是多个Item的总大小，和单个Item的2MB限制没有冲突。

内容的提问来源于stack exchange，提问作者Phuong Duyen Huynh Ngoc