如何在ADF管道复制活动中参数化源实现多环境动态文件拷贝

核心逻辑是用全局环境参数做路径动态拼接，全程不硬编码环境专属路径，不需要给每个环境单独建SFTP连接配置，具体配置步骤根据你用的Azure服务不同略有区别：

前置配置 #

• 给对应运行资源（Data Factory、Logic Apps、Function/App Service均可）配置全局环境标识参数：dev环境实例将参数EnvironmentName赋值为dev，qa环境赋值为qa，prod环境赋值为prod，所有环境的参数名保持完全一致。
• 提前确认SFTP统一访问账号对三个环境的文件夹都有对应读写权限，避免切换环境时出现权限报错。

不同服务的动态路径配置 #

方案1：使用Azure Data Factory/Synapse Analytics做拷贝 #

1. 新建共用的SFTP链接服务，只配置SFTP地址、端口、统一用户名/认证信息，不配置固定文件路径。
2. 新建基于该链接服务的SFTP数据集，在文件路径配置栏选择「动态内容」，输入路径拼接表达式：

@concat('/你的SFTP根路径/', pipeline().globalParameters.EnvironmentName, '/你的业务文件存放子路径')

举个实际例子，如果三个环境的路径分别是/data/upload/dev/order、/data/upload/qa/order、/data/upload/prod/order，表达式就写@concat('/data/upload/', pipeline().globalParameters.EnvironmentName, '/order')
3. 拷贝活动直接引用这个通用数据集即可，运行时会自动根据当前环境的全局参数匹配对应文件夹。

方案2：使用Logic Apps做拷贝 #

在SFTP连接器的「列出文件夹文件」「获取文件内容」等操作的文件夹路径输入框中，直接引用当前Logic Apps的应用配置参数拼接路径，写法示例：

/data/upload/@{appSetting('EnvironmentName')}/order

方案3：使用Azure Function/App Service自写代码拷贝 #

直接读取应用配置中的环境变量，在代码中拼接路径即可，不同语言示例：

• C#写法：

var envName = Environment.GetEnvironmentVariable("EnvironmentName");
var sftpTargetPath = $"/data/upload/{envName}/order";

• Python写法：

import os
env_name = os.getenv("EnvironmentName")
sftp_target_path = f"/data/upload/{env_name}/order"

风险规避建议 #

如果担心配置失误导致跨环境拉取数据，可以在SFTP服务端配置路径级访问规则：如果三个环境的资源出口IP独立，直接限制对应IP只能访问对应环境的文件夹，从底层杜绝错拉数据的可能。
配置完成后先在每个环境做单文件测试，打印运行时实际拼接的SFTP路径，确认和预期一致后再跑全量拷贝任务。

内容的提问来源于stack exchange，提问作者Sanath V R