Cosmos DB无分区键仅靠ID读取单文档的最优方案咨询

其实不用非得走全集合查询的路子！Cosmos DB提供了更高效的方案——直接调用ReadItemAsync并启用跨分区读取，比你写的那种遍历查询要省事儿得多，性能也更好。

最佳实现方式 #

当你只有文档ID、不知道分区键时，只需要在调用ReadItemAsync时：

• 把分区键参数传为PartitionKey.None
• 开启跨分区读取的选项

这样Cosmos DB会帮你跨所有分区定位目标文档，不用自己写查询迭代器扫集合。示例代码如下：

using Microsoft.Azure.Cosmos;
using System.Net;

try
{
    var requestOptions = new ItemRequestOptions
    {
        EnableCrossPartitionQuery = true
    };

    // 替换成你的实际文档ID
    var targetDocumentId = "your-document-id-here";
    
    // 跨分区读取目标文档
    var response = await VesselContainer.ReadItemAsync<CoachVessel>(
        id: targetDocumentId,
        partitionKey: PartitionKey.None,
        requestOptions: requestOptions
    );

    CoachVessel foundVessel = response.Resource;
    // 这里处理找到的文档逻辑
}
catch (CosmosException ex) when (ex.StatusCode == HttpStatusCode.NotFound)
{
    // 处理文档不存在的情况
    Console.WriteLine("目标文档不存在");
}

为什么不推荐你原来的查询方式？ #

你之前写的那种Linq查询迭代器方案确实能拿到结果，但存在两个明显问题：

• 性能拉胯：如果集合有多个分区，会触发全跨分区扫描，RU消耗高、耗时久，远不如ReadItemAsync的定向查找高效。
• 代码冗余：要写好几行迭代器循环代码，不如直接调用ReadItemAsync简洁直观。

另外补充个小细节：如果你的集合是无分区集合（创建时没指定分区键），那连EnableCrossPartitionQuery都可以不用加，直接传PartitionKey.None就能读取文档。

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