DocumentDb与Linq：如何对含嵌套数组的文档按自定义属性排序

你遇到的异常本质是Cosmos DB的LINQ提供程序能力有限，无法将嵌套数组的筛选、取值操作映射为合法的Cosmos SQL查询路径，所以会抛出不支持方法、无法映射文档路径的错误，以下是两类可行实现方案：

方案1：使用原生SQL查询（你最终落地的方案） #

这是目前兼容性最高、灵活度最好的方案，直接通过QueryDefinition编写Cosmos原生SQL执行查询：

按Brand排序的SQL示例 #

SELECT c.*
FROM c
LEFT JOIN char IN c.Characteristics
WHERE char.Label = "Brand"
-- 若Brand的Values数组为多值，可根据业务调整取数逻辑，此处默认取第一个值排序
ORDER BY IS_NULL(char) ? "" : char.Values[0] ASC

对应C#调用代码 #

// 构造查询定义，支持参数化避免注入风险
var queryDef = new QueryDefinition(@"
    SELECT c.*
    FROM c
    LEFT JOIN char IN c.Characteristics
    WHERE char.Label = @sortLabel
    ORDER BY IS_NULL(char) ? '' : char.Values[0] ASC
").WithParameter("@sortLabel", "Brand");

// 执行查询获取结果
var queryIterator = container.GetItemQueryIterator<YourDocType>(queryDef);
var resultList = new List<YourDocType>();
while (queryIterator.HasMoreResults)
{
    var page = await queryIterator.ReadNextAsync();
    resultList.AddRange(page);
}

方案2：文档结构反规范化（适配LINQ查询） #

如果坚持要使用LINQ语法，可以调整文档结构做冗余存储，写入文档时将Brand、Category这类需要排序的属性同步到根节点：

{
   Name: "Foo",
   Brand: "TheBrand",
   Category: "TheCategory",
   Characteristics: [
      { Label: "Brand", Values: ["TheBrand"] },
      { Label: "Category", Values: ["TheCategory"] },
      { Label: "Colors", Values: ["blue", "red"] }
]}

调整后直接使用LINQ排序即可，不会触发异常：

var query = client.CreateDocumentQuery<T>(documentCollectionUri)
    .OrderBy(d => d.Brand);

该方案查询性能更好，不需要额外JOIN嵌套数组，仅需要在写入时多做一次属性同步。

注意事项 #

• 不管使用哪种方案，都需要在Cosmos DB的索引策略中配置对应排序路径的范围索引，否则ORDER BY操作无法正常执行
• 如果对应Label的Characteristic项可能不存在，使用LEFT JOIN可以避免这类文档被过滤掉，同时配合IS_NULL函数设置默认排序值

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