CosmosDB SQL API键相关问题：是否允许重复、是否需唯一及性能影响

咱们先把这两个问题拆开来聊清楚，毕竟CosmosDB里的「键」其实分好几种，得区别对待：

1. CosmosDB（DocumentDB/SQL API）中是否允许键重复？ #

这里得区分两种核心的键：文档主键（id字段）和分区键：

• 文档主键（id）：在同一个分区内是不允许重复的，但跨分区的话完全可以重复。举个例子：分区键是user_id，用户A的分区里不能有两个id为doc1的文档，但用户B的分区里完全可以有一个id也是doc1的文档。
• 分区键：完全允许重复，甚至在实际业务中是常态。比如按用户ID分区，同一个用户的所有文档分区键都一样，这是合理且推荐的做法，方便做跨文档事务和高效的分区内查询。
• 至于自定义字段：默认没有唯一性限制，你可以根据业务需求插入重复值，除非你手动设置了唯一键约束。

2. CosmosDB SQL API是否要求键必须唯一？键的唯一性变化会影响优化或性能吗？ #

键的唯一性要求 #

• 只有同一分区内的id字段是CosmosDB强制要求唯一的，写入重复值会直接返回409冲突错误，这是系统默认的规则。
• 分区键没有唯一性要求，自定义字段也没有强制唯一，除非你给这些字段（或字段组合）设置了唯一键约束——设置后，该字段组合在同一个分区内就必须唯一，系统会帮你校验。

对优化和性能的影响 #

• id字段的唯一性：因为CosmosDB是通过id+分区键来精准定位单个文档的，同一分区内唯一的id能让单点读取（比如SELECT * FROM c WHERE c.id = 'order123' AND c.user_id = 'u456'）的性能拉满，直接命中目标文档，不需要扫描筛选。如果（假设）允许同一分区内id重复，那读取时会返回多个结果，不仅增加数据传输量，还需要额外过滤，性能肯定下降。
• 自定义唯一键约束：设置唯一键后，写入时CosmosDB会多一步唯一性校验，会带来一点点写入开销，但换来了数据一致性的保障。另外，查询这些唯一键字段时，因为唯一性的存在，CosmosDB可以像处理id一样精准定位，查询效率会比没有唯一约束的普通字段高很多。
• 分区键的重复：只要分区键的基数合理（不要所有文档都用同一个分区键，导致分区过热；也不要基数太高导致小分区过多），重复的分区键完全不影响性能，反而有助于分区内的高效查询和事务操作——毕竟同一分区内的文档物理上存储在一起，访问速度更快。

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