使用Mongo API的CosmoDB执行聚合查询时请求超时

针对你用Robo 3T连接Cosmos DB执行聚合查询时遇到的请求超时（错误码50）问题，我整理了几个实用的排查和解决方向：

1. 给查询过滤字段添加索引 #

你的聚合查询第一步是$match: {customer: "printabled"}，但Cosmos DB默认只有_id字段的索引。如果customer字段没有索引，这个匹配阶段会触发全集合扫描，数据量稍大就会超时。

你可以先执行这条命令创建索引：

db.events.createIndex({customer: 1})

索引创建完成后再重新运行聚合查询，应该能大幅减少扫描的数据量。

2. 检查并调整Cosmos DB的RU配置 #

Cosmos DB用**请求单位（RU）**来计量资源消耗，聚合查询（尤其是$group阶段）通常会消耗较多RU。如果当前容器的RU配额不足，就会触发超时。

• 登录Azure门户，找到你的Cosmos DB资源，进入对应的数据容器
• 查看“请求单位使用率”的监控图表，如果峰值接近或达到设置的RU上限，说明资源不够
• 可以临时调高RU配额（比如从400调到1000），测试查询是否能正常执行；如果查询只是偶尔运行，用完再调回即可

3. 调整Robo 3T的查询超时设置 #

Robo 3T默认的查询超时时间可能偏短，导致还没等Cosmos DB返回结果就触发了超时：

• 打开Robo 3T，点击顶部菜单的Edit -> Preferences
• 切换到MongoDB标签页，找到Query Timeout选项
• 把超时时间调大（比如改成300000毫秒，也就是5分钟），或者设置为0表示永不超时
• 保存设置后重启Robo 3T，再重新执行查询

4. 优化聚合查询的执行效率 #

如果数据量确实很大，可以尝试优化查询逻辑来降低资源消耗：

• 如果不需要统计所有历史数据，在$match阶段加上时间范围过滤，比如{ $match: {customer: "printabled", start_time: { $gte: ISODate("2024-01-01")} } }，缩小处理的数据集
• 给聚合查询加上allowDiskUse: true参数，允许使用磁盘来处理大结果集（Cosmos DB的Mongo API支持该参数），修改后的查询如下：

db.getCollection('events').aggregate(
  [
    { $match: {customer: "printabled"}},
    { $group: { _id: null, totalCOUNTTEMP:{ $sum:"$AMBIENT_TEMPERATURE" } } }
  ],
  { allowDiskUse: true }
);

5. 排查网络连接问题 #

如果是本地环境连接Azure的Cosmos DB，网络延迟过高也可能导致超时：

• 试试用Azure Cloud Shell执行相同的查询，看是否能成功运行，排除本地网络的问题
• 检查本地防火墙或代理是否限制了与Cosmos DB端点的连接

6. 查看Cosmos DB的诊断日志 #

如果以上方法都没用，可以通过Azure门户查看详细的诊断日志，定位具体的耗时环节：

• 进入Cosmos DB资源的“诊断设置”，开启日志收集
• 在“日志”页面查询聚合相关的操作日志，查看是$match还是$group阶段耗时过长，针对性优化

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