Synapse复制活动中Azure DevOps OData的$expand关键字失效问题

开发从Azure DevOps OData源拉取数据的Synapse管道时，基础查询在浏览器和Synapse中均可正常运行，但通过复制活动执行时，查询中的$expand=Area($select=AreaPath)部分被忽略，扩展字段未出现在架构或输出中。使用的查询如下：

https://analytics.dev.azure.com/YOURORG/PROJECT/_odata/v4.0-preview/WorkItems?
$select=WorkItemId,Title,WorkItemType,State,CreatedDate,ClosedDate,ParentWorkItemId&
$expand=Area($select=AreaPath)&
$filter=(ClosedDate ge 2025-01-01T00:00:00.619Z)&
$top=100

可能的解决方法 #

1. 使用Azure DevOps Analytics专用连接器 #

不要用通用OData连接器，Azure DevOps Analytics连接器是微软专门为Azure DevOps的OData端点开发的，对$expand这类嵌套查询的支持更完善。配置时直接选择该连接器，输入组织、项目信息，再填入查询参数即可。

2. 调整查询参数格式 #

Synapse复制活动对查询字符串的解析可能比浏览器严格，建议：

• 把查询参数整合成一行，去掉换行，直接使用&分隔参数（不需要转义成&）：

  $select=WorkItemId,Title,WorkItemType,State,CreatedDate,ClosedDate,ParentWorkItemId&$expand=Area($select=AreaPath)&$filter=(ClosedDate ge 2025-01-01T00:00:00.619Z)&$top=100
  

• 确保在复制活动的Query字段里完整填写所有查询参数，不要拆分到其他配置项中。

3. 手动指定架构与字段映射 #

Synapse自动推断架构时可能遗漏嵌套的扩展字段，可手动干预：

• 在输出数据集的架构定义中，添加AreaPath字段（若目标是扁平结构，可直接定义为字符串类型；若保留嵌套，可定义为包含AreaPath的复杂类型）。
• 进入复制活动的Mapping标签，手动添加映射规则，将源的Area/AreaPath路径映射到目标的对应字段，强制Synapse识别该扩展字段。

4. 验证权限与API版本 #

• 确认Synapse使用的身份（托管身份/服务主体）拥有Azure DevOps项目的Analytics Reader权限，权限不足可能导致返回数据被截断，丢失嵌套字段。
• 尝试将OData API版本从v4.0-preview切换为稳定版v4.0，预览版API可能存在兼容性问题。

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