如何使用LINQ查询EF Core Cosmos DB提供程序中的字典属性

问题原因 #

EF Core无法将字典索引器（e.Labels["thing"]）的LINQ表达式翻译为Cosmos DB可识别的查询语法，因为Cosmos DB将Dictionary<string, string>类型的属性存储为嵌套JSON对象，而非EF Core默认能解析的字典操作逻辑。

可行解决方案 #

1. 使用EF.Property访问嵌套属性 #

通过EF.Property方法直接指定嵌套属性路径，EF Core会将其翻译为Cosmos DB支持的查询：

context.Entities.Where(e => EF.Property<string>(e, "Labels.thing") == "one").ToList()

这种方式利用Cosmos DB的JSON嵌套结构，直接定位到Labels对象下的thing属性进行匹配。

2. 替换Dictionary为强类型嵌套类（适用于固定键场景） #

如果Labels的键是固定的，可以将Dictionary<string, string>替换为强类型嵌套类，并配置为EF Core的拥有实体：

public class Entity
{
    // 其他属性
    public Labels Labels { get; set; }
}

public class Labels
{
    public string Thing { get; set; }
    // 其他固定键属性
}

之后即可使用类型安全的查询：

context.Entities.Where(e => e.Labels.Thing == "one").ToList()

3. 使用Cosmos DB原生SQL查询 #

通过FromSqlRaw直接编写Cosmos DB原生SQL语句，适合动态键的场景：

context.Entities.FromSqlRaw("SELECT * FROM c WHERE c.Labels.thing = 'one'").ToList()

注意：这种方式会失去部分类型安全性，需确保SQL语句的正确性。

不推荐方案 #

虽然异常提示支持切换到客户端评估（添加AsEnumerable()后再过滤），但该方式会将容器中所有数据拉取到客户端后再筛选，对于大数据集性能极差，仅适合极小数据量场景。

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