使用Bicep为Azure Data Factory添加全局参数失败，参数列表为空

核心问题 #

启用Git配置的Azure Data Factory，全局参数的存储和读取逻辑与非Git模式存在差异：

• 开启Git后，ADF会优先从关联的Git仓库读取全局参数（参数存储在仓库的GlobalParameters文件夹下的JSON文件中）
• 你使用的API版本2018-06-01不支持在Git模式下将部署的全局参数同步到Git仓库，部署的参数仅保存在ADF服务端，不会同步到仓库，因此在Git模式的ADF界面中无法看到。

修复步骤 #

1. 升级Bicep资源的API版本 #

将资源的API版本从2018-06-01升级到2019-06-01或更高稳定版本，新版API支持在Git模式下自动将全局参数同步到关联的Git仓库。修改后的Bicep代码示例：

resource dataFactory 'Microsoft.DataFactory/factories@2019-06-01' = {
  name: name
  identity: {
    type: 'SystemAssigned'
  }
  properties: {
    globalParameters: {
      environment: {
        type: 'String'
        value: 'dev'
      }
    }
    // 若ADF已配置Git，需保留或添加Git配置信息（首次部署需补充）
    repoConfiguration: {
      type: 'FactoryVSTSConfiguration' // 或 FactoryGitHubConfiguration，根据实际Git类型选择
      accountName: '<你的Git账户名>'
      repositoryName: '<你的仓库名>'
      collaborationBranch: '<协作分支，如main>'
      rootFolder: '<根文件夹，如/>'
    }
  }
  location: location
}

2. 验证Git仓库同步状态 #

重新部署后，检查关联的Git仓库，确认GlobalParameters文件夹下生成了对应参数的JSON文件（例如environment.json），此时ADF界面的全局参数列表会自动加载仓库中的内容。

3. 无法升级API版本的临时处理 #

若必须使用旧版API，需手动将全局参数的JSON文件提交到Git仓库的GlobalParameters路径下，示例JSON内容：

{
  "type": "String",
  "value": "dev"
}

提交完成后刷新ADF界面，即可看到全局参数。

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