在Azure Data Factory中通过SOQL查询Salesforce数据报错求助

错误原因 #

你使用的SOQL语句包含了Salesforce Apex专属的表达式（如:DateTime.now().addDays(-7)...），但ADF的Salesforce连接器不支持这种Apex风格的绑定变量与函数调用，这是触发'SOQL_FIRST mode prepare failure'错误的核心原因。

解决方案 #

方案1：使用ADF动态内容生成日期范围

利用ADF内置的日期函数计算时间范围，替换SOQL中的Apex表达式，确保查询符合ADF的语法要求：

• 7天前UTC时间的格式化表达式：formatDateTime(addDays(utcnow(), -7), 'yyyy-MM-dd\'T\'HH:mm:ss\'Z\'')
• 当前UTC时间的格式化表达式：formatDateTime(utcnow(), 'yyyy-MM-dd\'T\'HH:mm:ss\'Z\'')

将SOQL修改为带ADF动态内容的形式，在复制活动的查询框中输入：

SELECT ID, NAME FROM MYTABLE
WHERE 
last_date != NULL
AND 
last_date >= '@{formatDateTime(addDays(utcnow(), -7), "yyyy-MM-dd\'T\'HH:mm:ss\'Z\'")}'
AND
last_date <= '@{formatDateTime(utcnow(), "yyyy-MM-dd\'T\'HH:mm:ss\'Z\'")}'

注：用@{}包裹ADF动态表达式，格式化为带Z的UTC时间戳，避免时区不匹配问题。

方案2：改用Salesforce原生SOQL日期函数

直接使用Salesforce SOQL支持的内置日期范围语法，无需依赖ADF动态计算，更简洁高效：

SELECT ID, NAME FROM MYTABLE
WHERE 
last_date != NULL
AND 
last_date >= LAST_N_DAYS:7
AND
last_date <= NOW()

注：LAST_N_DAYS:7表示过去7天的范围，NOW()为Salesforce服务器当前时间，时区以Salesforce组织配置为准；若last_date是Date类型而非DateTime，需替换为TODAY()而非NOW()。

额外检查点 #

• 确认last_date字段的类型（Date/DateTime），匹配对应的SOQL日期语法
• 验证ADF的Salesforce连接器权限，确保可访问MYTABLE对象及目标字段

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