能否将分区CosmosDB集合用作botbuilder-azure扩展的BotDataStore？

当然可以用分区Cosmos DB集合来作为BotDataStore——不过你遇到的报错是因为分区集合要求所有读写操作必须明确提供分区键，而默认的配置没处理这一点。下面是具体的解决方法：

为什么会报错？ #

分区Cosmos DB集合和固定集合的核心区别在于，前者依赖分区键来分配数据、实现水平扩展。如果你的操作没有传递分区键值，Cosmos DB就不知道该把数据放到哪个分区，自然会抛出System.InvalidOperationException: PartitionKey value must be supplied for this operation异常。

解决步骤 #

1. 确认分区集合的分区键配置 #

首先确保你手动创建的分区集合有明确的分区键路径（比如/userId、/conversationId或者你自定义的路径），这个路径要和后续代码配置保持一致。

2. 在BotDataStore初始化时指定分区键 #

使用CosmosDbStorage（BotBuilder-Azure中BotDataStore的实现类）时，需要通过CosmosDbStorageOptions配置分区键：

// 初始化Cosmos DB存储配置
var cosmosDbOptions = new CosmosDbStorageOptions
{
    AuthKey = "你的Cosmos DB密钥",
    AccountEndpoint = "你的Cosmos DB账户端点",
    DatabaseId = "机器人使用的数据库ID",
    ContainerId = "你创建的分区集合ID", // 旧版本可能用CollectionId
    PartitionKey = "/userId" // 这里要和你集合的分区键路径完全匹配
};

// 创建存储实例并关联到对话状态/用户状态
var storage = new CosmosDbStorage(cosmosDbOptions);
var userState = new UserState(storage);
var conversationState = new ConversationState(storage);

3. 确保数据实体包含分区键字段 #

如果你的Bot State对象（比如自定义的UserProfile）没有包含分区键对应的属性，可能需要添加它。比如如果分区键是/userId，你的状态类应该有一个userId属性：

public class UserProfile
{
    public string userId { get; set; } // 对应分区键路径
    public string Name { get; set; }
    public int Age { get; set; }
}

当你保存状态时，Bot框架会自动使用这个属性的值作为分区键，确保操作符合Cosmos DB的要求。

额外注意事项 #

• 不同版本的BotBuilder-Azure可能有API差异：比如新版本用ContainerId代替了旧版的CollectionId，请根据你使用的NuGet包版本调整代码。
• 分区键的选择很重要：建议选择基数较高的字段（比如用户ID、对话ID），这样能保证数据均匀分布在各个分区，充分发挥分区集合的扩展能力。

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