如何调整Cosmos DB查询，仅返回文档中匹配条件的locales项

你遇到的问题很典型——想要拿到完整的文档，但只保留locales数组里符合特定条件的元素，之前用join后固定取索引0的思路确实行不通，毕竟匹配项不一定在数组的第一个位置。

在Cosmos DB的SQL语法里，我们可以结合ARRAY_FILTER和EXISTS轻松实现这个需求：

方法一：手动指定字段（适合字段固定的场景） #

这种方式会明确返回文档的所有字段，同时把locales替换为过滤后的结果：

SELECT 
    c.id,
    c._id,
    c.artno,
    c.vendor,
    c.updatedAt,
    ARRAY_FILTER(c.locales, l => l.country = 'SE' AND l.language = 'sv' AND l.categories[0] = 'Dam') AS locales,
    c.relatedArtno,
    c._rid,
    c._self,
    c._etag,
    c._attachments,
    c._ts
FROM c
WHERE EXISTS(
    SELECT VALUE l
    FROM l IN c.locales
    WHERE l.country = 'SE' AND l.language = 'sv' AND l.categories[0] = 'Dam'
)

逻辑拆解： #

1. ARRAY_FILTER：遍历c.locales数组，只留下满足country='SE'、language='sv'且categories[0]='Dam'的元素，直接替换原有的locales字段。
2. EXISTS子句：先筛出那些至少包含一个符合条件locales项的文档，避免返回完全没有匹配结果的无效文档。

方法二：动态保留所有字段（适合字段较多/易变的场景） #

如果文档字段太多，不想手动一一罗列，可以用对象展开语法保留所有字段，同时覆盖locales：

SELECT 
    {
        ...c,
        locales: ARRAY_FILTER(c.locales, l => l.country = 'SE' AND l.language = 'sv' AND l.categories[0] = 'Dam')
    } AS fullDocument
FROM c
WHERE EXISTS(
    SELECT VALUE l
    FROM l IN c.locales
    WHERE l.country = 'SE' AND l.language = 'sv' AND l.categories[0] = 'Dam'
)

这个查询会返回一个包含fullDocument字段的结果，里面就是修改了locales数组的完整文档。

验证示例 #

拿你提供的示例文档来说，如果把条件里的categories[0]='Dam'改成categories[0]='Herr'（示例里瑞典语条目对应的第一个分类是Herr），查询会返回该文档，且locales数组仅保留那一条瑞典语的条目，其他字段完整保留。

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