如何在ADF部署时参数化ExecuteDataFlow活动中的IR名称？

以下是针对该问题的具体解决步骤：

1. 修正ExecuteDataFlow活动的参数化配置 #

在管道的ARM模板JSON中，确保ExecuteDataFlow活动的integrationRuntime.referenceName直接引用管道参数，示例代码如下：

"activities": [
    {
        "name": "Execute_DataFlow",
        "type": "ExecuteDataFlow",
        "typeProperties": {
            "dataFlow": {
                "referenceName": "Target_DataFlow",
                "type": "DataFlowReference"
            },
            "integrationRuntime": {
                "referenceName": "@pipeline().parameters.IR_Name",
                "type": "IntegrationRuntimeReference"
            }
        }
    }
]

同时要在模板的parameters节点中定义该参数：

"parameters": {
    "IR_Name": {
        "type": "string",
        "metadata": {
            "description": "集成运行时名称，分环境配置"
        }
    }
}

2. 配置环境专属的参数文件 #

在各环境的ARM参数文件（如params-dev.json、params-prod.json）中指定对应IR名称：

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentParameters.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "IR_Name": {
            "value": "Dev-Dedicated-IR" // 生产环境替换为"Prod-Dedicated-IR"
        }
    }
}

3. 检查Data Flow自身的IR配置冲突 #

如果Data Flow本身在设计时指定了专用集成运行时，会覆盖ExecuteDataFlow活动中设置的IR。需做如下调整：

• 进入Data Flow的设置页面，将集成运行时改为自动解析
• 若需参数化Data Flow的IR，可在Data Flow的模板JSON中修改：

"properties": {
    "type": "MappingDataFlow",
    "typeProperties": {
        "integrationRuntime": {
            "referenceName": "@pipeline().parameters.IR_Name",
            "type": "IntegrationRuntimeReference"
        }
    }
}

4. 部署验证要点 #

• 部署前使用ADF的模板验证功能，检查参数引用是否合法
• 部署完成后，进入目标环境的管道设计页，查看ExecuteDataFlow活动的IR配置是否已替换为对应环境的名称
• 确认目标环境中存在该IR名称，避免因资源不存在导致部署失败

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