Azure Data Factory计划触发器执行Lookup活动报错排查问询

问题描述 #

Azure Data Factory管道手动触发运行正常，但通过计划触发器运行时，执行SQL查询获取单条记录的Lookup活动环节报错。已确认拥有Contributor权限，手动触发无异常。

报错信息（翻译后） #

目标Lookup活动操作失败：ErrorCode=InvalidParameter,'Type=Microsoft.DataTransfer.Common.Shared.HybridDeliveryException,Message=属性''的值无效：'值不在预期范围内。'.,Source=,''Type=Microsoft.DataTransfer.SecurityValidation.Exceptions.HostValidationException,Message=值不在预期范围内。,Source=Microsoft.DataTransfer.SecurityValidation,'

排查步骤 #

• 检查触发器参数/变量传递：计划触发器可能携带手动触发时未使用的参数或变量，这些值可能为空或超出Lookup活动SQL查询的预期范围。比如动态SQL中引用的触发器参数未正确赋值，导致生成的SQL语句存在无效语法或参数值。
• 验证执行上下文差异：手动触发和计划触发的执行上下文可能不同，比如使用托管标识或服务主体时，计划触发的身份可能未正确配置对目标SQL数据源的访问权限（即使你有Contributor权限，管道运行身份可能是独立的）。检查Lookup活动使用的链接服务身份，确认其在计划触发时能正常访问目标表。
• 排查时间/时区相关问题：如果SQL查询中用到了触发器的时间变量（如@trigger().scheduledTime），时区转换错误可能导致生成的日期值超出字段允许范围，比如目标表的日期字段有约束，而时区转换后的值不符合要求。
• 检查Lookup活动配置：确认Lookup活动的「第一行仅」或「全部行」设置是否正确，以及返回结果的处理逻辑是否在计划触发时出现异常。比如当查询返回空结果时，后续依赖该结果的逻辑未做处理，但手动触发时恰好有数据。
• 对比运行日志差异：在ADF监控页面，查看计划触发运行的详细日志，展开Lookup活动的输入输出，对比手动触发时的参数内容，重点看实际执行的SQL语句，定位无效参数或语法问题。
• 检查数据源连接配置：链接服务的配置在计划触发时可能出现环境差异问题，比如使用了基于集成运行时（IR）的连接设置，计划触发的IR节点与手动触发时不同，导致连接参数无效。

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