如何正确解读Azure Advisor的Azure Cosmos DB缺失索引推荐？

算力阿峰

2026-6-13

正确解读Azure Cosmos DB Advisor的索引推荐及解决方案

你确实误解了Advisor的推荐内容，以下是核心问题解析和修正方案：

1. Advisor推荐的真实含义

Advisor列出的/someField1 ASC、/someField2 ASC这类条目，指的是单字段范围/排序索引，而非多字段复合索引。

你的默认索引策略"path": "/*"会自动为所有字段创建哈希（Hash）索引，哈希索引仅适用于相等匹配查询；但如果你的业务查询中存在针对这些字段的范围查询（如>、<、BETWEEN）或排序操作，哈希索引无法高效支持，因此Advisor会推荐显式为这些字段添加范围（Range）类型的单字段索引（指定升序/降序）。

2. 你之前操作的问题

你添加的五字段复合索引，仅适用于同时涉及这五个字段的组合查询（比如多字段排序、多字段过滤+排序的场景），完全不符合Advisor的推荐意图：

复合索引无法替代单字段范围索引满足Advisor的检查条件，因此推荐不会消失；
查询规划器会优先尝试使用复合索引，即使查询只用到其中单个字段，反而会因为索引结构不匹配导致性能下降。

3. 正确的索引策略调整

保留原有的默认includedPaths配置，新增singleIndexes节点，为每个推荐字段单独添加单字段范围索引：

{ 
    "includedPaths": [
        {
            "path": "/*"
        }
    ],
    "singleIndexes": [
        {
            "path": "/someField1",
            "order": "ascending"
        },
        {
            "path": "/someField2",
            "order": "ascending"
        },
        {
            "path": "/someField3",
            "order": "ascending"
        },
        {
            "path": "/someField4",
            "order": "ascending"
        },
        {
            "path": "/someField5",
            "order": "ascending"
        }
    ]
}