在ADF复制/查找活动中使用SOQL无法获取Salesforce记录

一、预览数据集报错的修复 #

预览时的错误提示明确要求必须指定SOQLQuery、objectApiName或reportId中的一个，不能留空。即使已编写SOQL查询，也可能是配置环节出现问题：

• 检查Salesforce数据集的连接配置，确认SOQLQuery字段是否准确填写了Select Id from Account，避免多余空格或格式错误。
• 若通过参数传递SOQL，需确保预览时参数已正确赋值，避免因参数为空触发校验错误。

二、管道返回所有字段的排查 #

管道运行成功但返回全量字段，大概率是SOQL未被正确识别，或权限问题导致查询被忽略：

1. 验证SOQL本身的有效性
   直接在Salesforce Workbench中执行Select Id from Account，确认是否仅返回Id字段。如果Workbench中结果正常，说明查询本身无问题，问题出在ADF配置。
2. 检查ADF复制活动的数据源模式
   确认复制活动的数据源是否选择了正确的Salesforce数据集，且数据集的查询模式为SOQL查询，而非“表名”或“报表ID”模式。若误选表名模式，ADF会自动拉取该对象的所有字段，忽略自定义SOQL。
3. 核查API用户权限
   • 确认连接Salesforce的API用户拥有Account对象的只读权限，且已开启“API Enabled”权限（在Salesforce设置-用户-权限集中查看）。
   • 检查字段级权限：若Id字段对该用户设置为不可见，Salesforce会自动返回所有可见字段，覆盖你的SOQL查询结果。

三、额外排查点 #

• 若使用参数化查询，确保复制活动中正确引用参数（如@pipeline().parameters.SOQLQuery），且运行时参数值传递无误。
• 清空ADF缓存，重新保存并发布管道，避免缓存导致配置不生效。

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