MongoDB迁移至Cosmos DB（Mongo API）：如何实现多键索引？

我刚帮好几个从MongoDB迁移到Cosmos DB（Mongo API）的项目处理过这个问题，其实两者在多键索引的支持上几乎无缝对齐，不过有几个细节要留意，确保你能完全复刻原MongoDB的索引行为：

一、创建多键索引的基本操作 #

和原生MongoDB完全一致，你不需要学习新的语法——当你为数组类型字段创建索引时，Cosmos DB会自动将其识别为多键索引；当然你也可以显式指定multiKey: true参数，效果完全相同。

举个实际例子：假设你的集合里有这类带数组字段的文档：

{
  "_id": "doc1",
  "categories": ["database", "cloud", "nosql"],
  "meta": { "tags": ["migration", "indexing"] }
}

创建顶级数组的多键索引 #

// 自动识别为多键索引
db.products.createIndex({ categories: 1 })

// 显式指定multiKey（可选，仅用于明确标识）
db.products.createIndex({ categories: 1 }, { multiKey: true })

创建嵌套数组的多键索引 #

针对嵌套在文档里的数组字段，语法也和MongoDB一致：

db.products.createIndex({ "meta.tags": 1 })

验证已创建的索引 #

执行以下命令查看索引详情，确认multiKey字段为true：

db.products.getIndexes()

二、确保与MongoDB行为一致的关键要点 #

虽然大部分逻辑对齐，但有几个核心规则需要和原MongoDB环境保持一致：

• 复合多键索引的限制：和MongoDB一样，Cosmos DB不允许在一个复合索引中包含两个及以上的数组字段（避免索引数据量爆炸），比如下面的操作会报错：

  // 错误：复合索引不能包含两个数组字段
  db.products.createIndex({ categories: 1, "meta.tags": 1 })
  

• 覆盖索引的使用：如果想实现覆盖索引（仅从索引返回数据，避免回表查询），逻辑和MongoDB完全相同——确保查询的返回字段全部包含在索引中：

  // 创建包含categories和name的复合多键索引
  db.products.createIndex({ categories: 1, name: 1 })
  
  // 查询仅返回name和categories，会触发覆盖索引
  db.products.find({ categories: "cloud" }, { name: 1, categories: 1, _id: 0 })
  

• TTL+多键索引的行为：如果你的数组字段存储日期并需要设置自动过期，操作和MongoDB一致——TTL索引会在数组中任意一个日期字段过期时，删除整个文档（而非仅删除数组元素）：

  // 为expiryDates数组字段创建TTL索引，24小时后过期
  db.products.createIndex({ expiryDates: 1 }, { expireAfterSeconds: 86400 })
  

三、验证索引是否生效 #

和MongoDB一样，用explain()命令查看查询计划，确认多键索引被正确使用：

db.products.find({ categories: "nosql" }).explain("executionStats")

在返回结果的executionStats.executionStages.inputStage中，若stage为IXSCAN且indexName匹配你创建的多键索引，就说明索引已正常生效。

总的来说，Cosmos DB的Mongo API在多键索引上的实现高度贴合原生MongoDB，迁移时几乎不需要修改原有的索引脚本，只要注意上述规则并做好验证，就能保证和原环境一致的索引性能与行为。

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