Azure DevOps部署时Synapse/DF集成运行时自动切换问题求助

问题核心原因 #

部署时SelfHostedIntegrationRuntime被自动替换为AutoResolveIntegrationRuntime，本质是部署流程中IR引用的配置被覆盖或未正确映射，常见触发场景：

• 发布管道未完成目标环境自托管IR的名称映射
• ARM模板中链接服务的IR引用未参数化或参数赋值错误
• 目标环境不存在同名自托管IR，系统自动 fallback 到默认的AutoResolve

具体修复步骤 #

1. 标准化ARM模板的参数化配置 #

把链接服务的connectVia.referenceName改为参数化引用，避免硬编码：

"connectVia": {
    "referenceName": "[parameters('SelfHostedIRName')]",
    "type": "IntegrationRuntimeReference"
}

同时在对应环境的参数文件（如parameters-prod.json）中明确指定IR名称：

{
    "parameters": {
        "SelfHostedIRName": {
            "value": "SelfHostedIntegrationRuntime"
        }
    }
}

2. 配置Azure DevOps发布管道的变量映射 #

在Azure DevOps的ARM模板部署任务中，确保参数与目标环境IR名称正确绑定：

• 进入任务配置页，找到「参数」或「变量覆盖」区域
• 添加参数映射：-SelfHostedIRName "SelfHostedIntegrationRuntime"（根据你的参数名调整）
• 也可使用变量组，为不同环境预设对应的IR名称变量，部署时自动传入

3. 验证目标环境的自托管IR状态 #

登录目标环境的Synapse/数据工厂后台，确认：

• 存在名称完全匹配的SelfHostedIntegrationRuntime（注意大小写敏感）
• 该IR处于运行中状态，无离线或故障标记

4. 强制禁用自动 fallback（可选） #

若上述步骤无效，可在链接服务的ARM模板中添加配置，强制系统严格使用指定IR：

"properties": {
    "connectVia": {
        "referenceName": "[parameters('SelfHostedIRName')]",
        "type": "IntegrationRuntimeReference"
    },
    "isLegacyAuthoring": false,
    // 其他链接服务配置项...
}

验证部署结果 #

重新触发Azure DevOps发布流程，部署完成后进入目标环境的链接服务详情页，检查「连接方式」是否已固定为SelfHostedIntegrationRuntime。

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