Azure CosmosDB for MongoDB API分片键使用报错求助

Hey there, let's break down what's happening here and get your inserts working with the unlimited storage (sharded) setup.

为什么会出现这个错误？ #

When you enable unlimited storage for a Cosmos DB MongoDB collection, you're setting up a sharded cluster. Sharding requires every document you insert to include the shard key—this is the field (or nested field path) you specified when creating the collection (school.students in your case). Cosmos DB uses this key to distribute your data across different shards, so without it, the service doesn't know where to store your document.

怎么解决这个问题？ #

You have two main paths to fix this, depending on whether you want to keep the current shard key or adjust it to match your existing document structure.

1. 更新文档以包含所需的分片键 #

既然你的分片键路径是school.students，那你的文档需要包含这个嵌套字段结构。下面是修改后的插入代码示例：

from pymongo import MongoClient

# 给文档添加分片键路径
student_data = {
    "id": "abc123",
    "name": "jack",
    "school": {
        "students": "jack_123"  # 这里建议用高基数的唯一值，比如用户ID，让数据在分片中均匀分布
    }
}

client = MongoClient("mongodb://...")
db = client["school"]
collection = db["students"]
collection.insert_one(student_data)

小提示: 选择高基数的分片键值（比如唯一ID、用户专属标识），能确保数据均匀分布在各个分片中，避免出现性能热点，保证服务稳定性。

2. 用更合适的分片键重新创建集合 #

如果你不想给文档添加嵌套的school.students字段，可以删除现有集合，重新创建一个分片键匹配当前文档结构的集合（比如你已经在使用的id字段）。

注意：集合创建后无法修改分片键，所以这个方案需要重新搭建集合。

快速总结 #

• 分片集合（无限存储模式）要求每个文档必须包含你定义的分片键字段/路径。
• 要么调整文档结构加入school.students路径，要么重新创建集合并使用文档中已有的字段作为分片键。

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