Cosmos DB文档版本支持问题：UNION不可用如何处理？

嘿，我太懂你这个痛点了——Cosmos DB的SQL查询对UNION/UNION ALL的支持确实有不少限制，尤其是当你想跨不同结构的文档做标准化输出时，很容易踩坑。不过咱们完全可以不用依赖UNION，用条件逻辑+数组展开的方式写一个单一聚合查询，完美解决这个问题。

直接平铺输出标准化后的Tag列表 #

如果你的目标是把所有文档里的Tag统一输出成字符串列表（不管是version1的直接字符串，还是version2的name字段），可以用这个查询：

SELECT VALUE 
    CASE 
        WHEN c.version = 1 THEN t 
        WHEN c.version = 2 THEN t.name 
    END
FROM c
JOIN t IN c.tags
WHERE c.version IN (1, 2)

这个查询的逻辑很清晰：

• 用JOIN t IN c.tags把每个文档的Tags数组拆分成单独的条目，相当于把嵌套结构“拍平”
• 通过CASE语句根据文档的version字段动态选择输出内容：version1直接取Tag字符串，version2取Tag对象里的name属性
• SELECT VALUE会去掉外层的默认对象包装，直接返回纯字符串的结果集，完全符合你想要的标准化效果

按文档聚合标准化后的Tags数组 #

如果需要保留文档维度，每个文档对应一个标准化后的Tags数组，可以用嵌套子查询结合ARRAY函数：

SELECT 
    c.id,
    c.version,
    ARRAY(
        SELECT CASE 
            WHEN c.version = 1 THEN t 
            WHEN c.version = 2 THEN t.name 
        END
        FROM t IN c.tags
    ) AS normalized_tags
FROM c
WHERE c.version IN (1, 2)

这个查询会返回每个文档的ID、版本，以及对应的标准化Tags数组，比如version1的文档会返回["first","second"]，version2的文档会返回["third","forth"]，结构完全统一。

为什么这个方案更优？ #

Cosmos DB的UNION要求两个子查询返回的Schema完全一致（哪怕看起来都是字符串，底层类型解析也可能触发限制），而用CASE的方式是在同一个查询上下文里处理不同结构，既避免了UNION的限制，又保持了单一查询的简洁性。后续如果新增了version3的Tag结构，只需要扩展CASE的条件分支就行，扩展性拉满。

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