Azure Data Factory部署时全局参数被全量覆盖，需仅更新指定参数

问题场景 #

通过ARM模板部署Azure Data Factory（ADF）时，若勾选Include global parameters in ARM template选项，目标环境的所有全局参数会被源环境的参数全量覆盖。例如源和目标环境均包含releasedate、releasetag、summary三个全局参数，即便仅需更新releasedate，当前部署流程也会将另外两个参数同步为源环境的值，无法保留目标环境原有设置。

解决方案 #

方法1：取消全局参数勾选，通过部署参数指定更新项 #

• 导出ARM模板时，取消勾选Include global parameters in ARM template选项，此时模板中不会包含全局参数定义。
• 编辑部署参数文件（arm-template-parameters.json），添加globalParameters节点，仅定义需要更新的releasedate参数：

  {
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentParameters.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
      "globalParameters": {
        "value": {
          "releasedate": {
            "type": "String",
            "value": "2024-06-01"
          }
        }
      }
    }
  }
  

• 执行部署时，目标环境中未在参数文件中定义的releasetag、summary参数将保持原有值，仅releasedate会被更新。

方法2：使用PowerShell/CLI单独更新目标参数 #

直接通过Azure PowerShell或CLI命令针对单个全局参数进行更新，不会影响其他参数：

• PowerShell示例：

  Set-AzDataFactoryV2GlobalParameter -ResourceGroupName "your-resource-group" -DataFactoryName "your-adf-name" -Name "releasedate" -Value "2024-06-01" -Type String
  

• Azure CLI示例：

  az datafactory global-parameter update --resource-group your-resource-group --factory-name your-adf-name --name releasedate --value "2024-06-01" --type String
  

方法3：自定义ARM模板，移除无需更新的参数 #

• 导出包含全局参数的ARM模板后，编辑arm-template.json，找到globalParameters节点，仅保留需要更新的releasedate参数，删除releasetag和summary的定义：

  "globalParameters": {
    "releasedate": {
      "type": "String",
      "value": "[parameters('globalParameters').releasedate.value]"
    }
  }
  

• 部署该自定义模板时，仅会更新releasedate参数，目标环境的其他全局参数将维持现状。

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