如何在Cosmos DB中使用ReadItemAsync仅传入分区键？

我尝试仅通过分区键调用ReadItemAsync方法，这个分区键是用户用来搜索的7位数字。由于我们按月份拆分数据，同一容器中同一个分区键对应多个条目，每个分区键最多有12个不同的ID。

当前代码如下：

var feedIterator = await Container.ReadItemAsync<JObject>("id", new PartitionKey(partitionKey));

数据库结构：

ReadItemAsync是用来根据ID+分区键查询单个条目的，没法直接拿它查询整个分区的所有数据。要获取同一分区键下的所有条目，得用查询迭代器执行分区扫描，两种常用实现方式如下：

方式1：SQL语句查询 #

// 构建带参数的SQL查询，避免注入风险
var query = new QueryDefinition("SELECT * FROM c WHERE c.分区键 = @partitionKey")
    .WithParameter("@partitionKey", partitionKey);

// 获取查询迭代器
var feedIterator = Container.GetItemQueryIterator<JObject>(query);
var allItems = new List<JObject>();

// 遍历所有结果页
while (feedIterator.HasMoreResults)
{
    var page = await feedIterator.ReadNextAsync();
    allItems.AddRange(page.Resource);
}

方式2：LINQ查询 #

// 构建LINQ查询条件
var query = Container.GetItemLinqQueryable<JObject>()
    .Where(item => item["分区键"].Value<string>() == partitionKey);

// 转为迭代器并遍历结果
var feedIterator = query.ToFeedIterator();
var allItems = new List<JObject>();

while (feedIterator.HasMoreResults)
{
    var page = await feedIterator.ReadNextAsync();
    allItems.AddRange(page.Resource);
}

• 分区扫描会读取该分区下所有数据，只要你的分区设计符合Cosmos DB推荐规范（单分区数据量不超过20GB），性能不会有问题。
• 如果需要按月份过滤数据，可以在查询里追加条件，比如AND c.月份 = @targetMonth，减少返回的数据量。

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