如何在PowerBI中通过Synapse连接器查询Azure Cosmos DB NoSQL新增字段并返回NULL？

方案1：使用JSON_VALUE函数提取字段 #

直接通过JSON路径提取字段，当字段不存在时会自动返回NULL，完美适配需求，SQL脚本如下：

SELECT 
    JSON_VALUE(logs, '$.Field1') AS Field1,
    JSON_VALUE(logs, '$.Field2') AS Field2,
    JSON_VALUE(logs, '$.Field3') AS Field3
FROM logs

这里的logs是你的Cosmos DB容器名称，$.FieldX是JSON字段的路径，不管文档里有没有对应字段，都会返回字段值或NULL，不会触发列名无效的报错。

为什么IS_DEFINED不能用？ #

你通过Synapse连接器在PowerBI中执行SQL时，实际是由Synapse SQL引擎解析执行，而非Cosmos DB原生SQL引擎，所以Cosmos专属的IS_DEFINED函数不被Synapse SQL支持，才会报错“不是内置函数”。

备选方案：用CASE结合JSON_EXISTS判断（Synapse SQL 2022+支持） #

如果你的Synapse SQL版本是2022及以上，还可以用JSON_EXISTS判断字段是否存在，再返回对应值或NULL：

SELECT 
    JSON_VALUE(logs, '$.Field1') AS Field1,
    JSON_VALUE(logs, '$.Field2') AS Field2,
    CASE 
        WHEN JSON_EXISTS(logs, '$.Field3') THEN JSON_VALUE(logs, '$.Field3')
        ELSE NULL
    END AS Field3
FROM logs

这个方案逻辑更直观，但需要Synapse SQL版本支持JSON_EXISTS函数，相比之下方案1兼容性更强，更推荐。

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