如何用SQL高效查询Cosmos DB中含指定数组元素的文档？

针对你的需求——查询IDs数组包含目标requiredIds数组中任意元素的文档，这里有两种比拆OR更高效的实现方式：

方法一：使用EXISTS子查询（推荐） #

这种写法会在找到第一个匹配元素后立即停止检查，性能最优，且不会返回重复文档：

SELECT *
FROM c
WHERE EXISTS (
    SELECT VALUE 1
    FROM id IN c.IDs
    WHERE id IN ("123456789", "4828927593")
)

如果用参数化查询（推荐用于生产环境，避免硬编码和注入风险）：

SELECT *
FROM c
WHERE EXISTS (
    SELECT VALUE 1
    FROM id IN c.IDs
    WHERE id IN @requiredIds
)

方法二：使用JOIN结合ARRAY_CONTAINS #

这种写法通过展开目标requiredIds数组，逐一匹配文档的IDs数组，但需要注意去重：

SELECT DISTINCT c
FROM c
JOIN reqId IN @requiredIds
WHERE ARRAY_CONTAINS(c.IDs, reqId)

如果不添加DISTINCT，当文档的IDs数组同时匹配多个requiredIds元素时，会返回重复的文档记录。

为什么比拆OR高效？ #

当requiredIds元素数量较多时，拆成多个ARRAY_CONTAINS(c.IDs, 'xxx') OR ...会让查询语句冗长，且Cosmos DB的查询优化器处理这种多OR条件的效率远低于上述两种集合匹配写法，尤其是当文档的IDs数组较大时，集合匹配的逻辑能更高效地利用索引（如果IDs字段有索引的话）。

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