Azure Data Factory Lookup Activity多列匹配结果不符合预期问题求助

核心问题根因 #

该异常是配置错误导致的常见问题，核心触发原因如下：

• byName()第二个入参要求传入数据流中定义的输入流别名，而非关联的数据集名称，传入数据集名称会导致ADF无法正确识别列所属的流，匹配条件判定为恒真，因此所有左侧行都会匹配右侧流的第一行数据。
• 多列匹配条件未使用&&运算符拼接为单个表达式，零散写入的规则不会同时生效。

修复步骤 #

• 确认输入流别名：进入数据流编辑页，查看左侧主输入流的显示名（可自定义为primary），右侧查找流的显示名（可自定义为lookup）。
• 重写匹配条件：将4个列的匹配规则用&&拼接为单个表达式，示例如下：

toString(byName('Col1', 'primary')) == toString(byName('Col1', 'lookup')) 
&& toString(byName('Col2', 'primary')) == toString(byName('Col2', 'lookup'))
&& toString(byName('Col3', 'primary')) == toString(byName('Col3', 'lookup'))
&& toString(byName('Col4', 'primary')) == toString(byName('Col4', 'lookup'))

• 调整匹配行设置：如果需要返回所有匹配的右侧行，将Lookup的「匹配行」设置为「所有匹配项」；仅需要返回第一行匹配结果则保持默认「第一个匹配项」即可。
• 验证预览：先点击匹配条件旁的「验证表达式」按钮确认语法无错，再执行预览查看匹配结果。

可选排查优化项 #

• 空值/特殊字符匹配：存在空值、首尾空格的场景，可在toString()外包裹trim()去除空格，避免匹配失败：trim(toString(byName('Col1', 'primary')))
• 重复键处理：如果右侧查找流存在重复匹配键，默认会返回第一行匹配结果，不符合预期的话需要先对右侧流做去重处理再接入Lookup。

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