Azure Data Factory转换日期字符串格式致API请求失败

问题根源 #

ADF哪怕把参数定义成字符串类型，只要内容是时间戳格式，就会自动尝试解析成日期类型，转成它默认的格式，导致和API要求的格式不匹配。静态拼接时没有参数解析环节，所以能正常运行。

实用解决办法 #

1. 用string()强制锁死参数格式 #

拼接URL的时候，给每个时间戳参数套一层string()函数，彻底阻止ADF自动解析：

@concat('/api/data?from=', string(pipeline().parameters.TimestampFrom), '&to=', string(pipeline().parameters.TimestampTo))

2. 在数据集里用动态内容严格构造URL #

别直接在相对URL输入框里拼参数，点开输入框旁边的fx图标进入动态内容模式，写完整的拼接表达式，确保每个时间戳都被string()包裹：

concat('/static-path?timestampFrom=', string(parameters().TimestampFrom), '&timestampTo=', string(parameters().TimestampTo))

3. 提前在管道里拼好完整URL再传 #

如果上面的方法还不行，就在管道里先把整个相对URL拼好存成变量，再传给数据集：

• 加个「Set Variable」活动，变量类型选字符串
• 变量值写拼接表达式：

@concat('/api/endpoint?from=', string(pipeline().parameters.TimestampFrom), '&to=', string(pipeline().parameters.TimestampTo))

• 数据集的相对URL直接引用这个变量：

@variables('FullRelativeUrl')

4. 先验证参数原始值 #

可以在管道里加个「Set Variable」或者「Web」活动，把参数值打出来看看有没有被改：

@concat('Debug: TimestampFrom=', pipeline().parameters.TimestampFrom, ' | TimestampTo=', pipeline().parameters.TimestampTo)

跑一遍管道看输出，确认参数格式没问题，再去查API请求的日志。

验证步骤 #

拼好动态URL后，用数据集的「测试连接」功能试一下，或者跑管道后去监控里看API请求的实际URL，确认时间戳格式和API要求的完全一致就行。

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