Azure Synapse Link for Dataverse选项标签示例代码执行报错

报错原因 #

• 第一次报错Incorrect syntax near the keyword 'Option'：Option是T-SQL的保留关键字，直接作为字段名引用时，会被SQL解析器识别为语法关键字而非用户字段，直接触发语法错误。
• 第二次报错Incorrect syntax near ']'：核心是两个写法错误共同导致：
  • JOIN条件中[OptionSetName] = statecode部分，把本该是字符串常量的选项集名称写成了无表归属的字段引用，漏了字符串常量必须的单引号；
  • 全量给所有表名、字段名加方括号时没有做标识校验，多表关联场景下未限定归属的字段名会让解析器无法正确匹配标识边界，触发括号附近的解析错误。

额外提醒：就算语法调试通过，原来的关联逻辑也缺少必要过滤条件，OptionsetMetadata是全局存储全环境所有实体选项集的元数据表，不加实体检索、语言过滤条件会出现标签错配、结果行数翻倍的问题。

正确实现方案 #

1. 给关联的两张表设置短别名，避免反复写全量路径，同时彻底解决字段归属歧义问题；
2. 仅对保留关键字Option加方括号转义，非保留字不需要额外套方括号，减少括号配对出错概率；
3. JOIN条件必须同时满足四个匹配规则：
   • 元数据表的EntityName匹配当前查询的实体逻辑名（固定字符串值，比如账户表是'account'）
   • 元数据表的OptionSetName匹配要关联的选项字段逻辑名（固定字符串值，比如状态字段是'statecode'，必须加单引号）
   • 元数据表的[Option]数值和业务表存储的选项字段数值相等
   • 指定标签语言编码，中文为2052，英文为1033，避免返回多语言重复数据

可直接运行的参考代码 #

SELECT
    acc.*, -- 可替换为你需要查询的业务表字段
    osm.LocalizedLabel AS statecode -- 直接返回选项对应的显示标签
FROM [databasename].[dbo].[account_partitioned] acc
LEFT JOIN [databasename].[dbo].[OptionsetMetadata] osm
    ON osm.EntityName = 'account'
    AND osm.OptionSetName = 'statecode'
    AND osm.[Option] = acc.statecode
    AND osm.LocalizedLabelLanguageCode = 2052

如果需要查询其他选项字段的标签，只需要复制LEFT JOIN逻辑块，修改对应的实体名、选项集名、关联字段、别名即可。

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