CosmosDB创建含嵌套字段的复合唯一索引报错求助

1. 明确Cosmos DB MongoDB API的唯一索引限制 #

Cosmos DB的唯一索引规则和原生MongoDB存在差异，核心限制如下：

• 全局唯一索引：必须包含集合的分区键，且只能由「分区键 + 一个或多个唯一约束字段」组成，无法创建不包含分区键的全局唯一复合索引。
• 分区内唯一索引：可无需包含分区键，但需确保所有被索引字段（包括嵌套字段）路径语法正确，且字段不存在数组类型（数组字段无法作为唯一索引的组成部分）。

2. 针对嵌套字段的复合唯一索引创建方案 #

情况1：需要分区内唯一的复合索引 #

若仅需在单个分区内保证复合字段唯一，直接使用标准MongoDB语法创建即可，注意嵌套字段用.分隔层级：

db.yourCollection.createIndex(
  { "evaluated.rut": 1, "anotherField": 1 },
  { unique: true }
)

创建前需检查：

• 嵌套字段evaluated.rut对应的字段是否为数组类型，Cosmos DB不允许数组字段加入唯一索引。
• 集合中是否已有重复的evaluated.rut + anotherField组合数据，唯一索引要求现有数据无重复冲突。

情况2：需要全局唯一的复合索引 #

若要实现全局范围的唯一约束，必须将分区键加入复合索引中。假设集合分区键为tenantId，创建语句示例：

db.yourCollection.createIndex(
  { "tenantId": 1, "evaluated.rut": 1, "anotherField": 1 },
  { unique: true }
)

该索引会在全局范围内保证tenantId + evaluated.rut + anotherField的组合唯一，符合Cosmos DB的全局唯一索引规则。

3. 常见报错排查 #

若仍无法创建索引，优先排查以下内容：

• 确认Cosmos DB MongoDB API版本为3.6及以上，低版本可能不支持部分嵌套字段索引特性。
• 检查嵌套字段路径是否存在拼写、层级错误（如evaluated.rut是否与文档实际嵌套结构匹配）。
• 若集合已有数据，先清理违反唯一约束的重复数据后再尝试创建索引。

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