如何用LINQ查询Cosmos DB：基于多属性对象列表匹配文档

方案1：使用LINQ的Contains结合匿名对象（支持Cosmos DB SQL翻译） #

Cosmos DB的LINQ提供程序支持将匿名对象的Contains翻译为SQL的IN子句，可直接基于目标对象列表构建查询，无需拆分属性。

示例代码：

// 定义要匹配的目标对象列表
var targetItems = new List<YourItem>
{
    new YourItem { PropA = "value1", PropB = 100 },
    new YourItem { PropA = "value2", PropB = 200 }
};

// 构建LINQ查询
var query = container.GetItemLinqQueryable<YourItem>()
    .Where(doc => targetItems.Contains(new { doc.PropA, doc.PropB }));

// 执行查询
var results = await query.ToFeedIterator().ReadNextAsync();

注意：需保证目标对象的属性与匿名对象的属性名称、类型完全一致，Cosmos会自动将该查询翻译为对应SQL，例如：
SELECT * FROM c WHERE ({PropA: c.PropA, PropB: c.PropB} IN ({PropA: "value1", PropB: 100}, {PropA: "value2", PropB: 200}))

方案2：预生成组合键，用单属性Contains查询 #

如果多属性的组合能生成唯一标识（比如拼接字符串或哈希值），可在文档写入时预先计算并存储这个组合键，查询时直接匹配键列表，性能更优。

示例代码：

// 文档模型新增组合键字段
public class YourItem
{
    public string Id { get; set; }
    public string PropA { get; set; }
    public int PropB { get; set; }
    public string CompositeKey { get; set; } // 例如 $"{PropA}_{PropB}" 或哈希值
}

// 生成目标组合键列表
var targetCompositeKeys = targetItems.Select(item => $"{item.PropA}_{item.PropB}").ToList();

// LINQ查询
var query = container.GetItemLinqQueryable<YourItem>()
    .Where(doc => targetCompositeKeys.Contains(doc.CompositeKey));

var results = await query.ToFeedIterator().ReadNextAsync();

该方案的优势是查询效率更高，尤其是属性数量较多时，Cosmos可利用CompositeKey的索引快速定位文档。

方案3：参数化SQL查询（复杂场景更灵活） #

若LINQ匿名对象Contains存在局限性（比如属性过多、类型复杂），可直接构建参数化SQL查询，将目标对象列表作为参数传入。

示例代码：

var parameter = new SqlParameter("@targets", targetItems);
var queryDefinition = new QueryDefinition(
    "SELECT * FROM c WHERE ({PropA: c.PropA, PropB: c.PropB} IN @targets)"
).WithParameter(parameter);

var results = await container.GetItemQueryIterator<YourItem>(queryDefinition).ReadNextAsync();

注意事项 #

• 务必为查询的属性组合创建复合索引，避免全表扫描导致性能下降。
• 若目标对象列表过大（超出Cosmos查询参数限制），需分批查询后合并结果。

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