如何编写Azure Cosmos DB查询判断记录列表字段为给定数组的子集

核心需求 #

判断数据表中数组类型字段是否为给定目标数组的子集，筛选符合条件的所有记录。

推荐写法（优先使用） #

Cosmos DB 原生提供IS_SUBSET系统函数，直接支持子集判断逻辑，语法简洁执行效率更高：

-- 示例：筛选ids是[1,2,3,4,5]子集的记录
SELECT * FROM c
WHERE IS_SUBSET(c.ids, [1,2,3,4,5])

参数说明 #

• 第一个参数：数据库记录中的数组字段（对应示例的c.ids，字符串数组可直接兼容使用，无需修改语法）
• 第二个参数：你提供的目标对比数组

最佳实践 #

推荐使用参数化查询传递目标数组，避免硬编码，降低注入风险同时提升查询复用性：

SELECT * FROM c
WHERE IS_SUBSET(c.待判断数组字段, @targetArray)

执行查询时给@targetArray参数赋值为你的目标字符串列表即可。

兼容写法（旧版API适用） #

如果你的Cosmos DB API版本不支持IS_SUBSET，可以用ALL量词加ARRAY_CONTAINS实现同样逻辑：

SELECT * FROM c
WHERE ALL item IN c.待判断数组字段 SATISFIES ARRAY_CONTAINS(@targetArray, item) END

逻辑说明：遍历待判断数组的每一个元素，验证所有元素都存在于目标数组中，完全符合子集判断规则。

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