CI/CD部署时Synapse链接服务未更新，仍保留Dev连接

核心排查与修复步骤 #

1. 确认Dev环境的参数化配置 #

• 检查Dev Synapse流水线中，连接字符串是否已设置为参数化变量，而非硬编码值。需在流水线连接属性中使用${{ parameters.xxx }}这类占位符，不能直接写死Dev环境的连接字符串。
• 验证CI/CD部署YAML中是否正确定义参数，并在Prod部署阶段传入对应值。示例配置：

  parameters:
    - name: prodDbConnectionString
      type: string
      default: ""
  steps:
    - task: AzureSynapseWorkspaceDeployment@2
      inputs:
        azureSubscription: 'Prod-Subscription'
        ResourceGroupName: 'Prod-RG'
        TargetWorkspaceName: 'Prod-Synapse-WS'
        TemplateFile: '$(Pipeline.Workspace)/artifacts/TemplateForWorkspace.json'
        TemplateParametersFile: '$(Pipeline.Workspace)/artifacts/TemplateParametersForWorkspace.json'
        overrideParameters: '-DbConnectionString "${{ parameters.prodDbConnectionString }}"'
  

2. 检查参数覆盖机制是否生效 #

• 确认Prod部署任务中，overrideParameters字段已明确指定要替换的连接字符串参数，不能依赖自动映射。
• 查看部署日志，搜索参数相关输出，确认Prod环境的连接字符串值是否被正确传入部署任务。若日志中无对应参数值，说明参数传递环节存在问题。

3. 验证ARM模板的参数化正确性 #

• 检查Dev导出的ARM模板（TemplateForWorkspace.json）中，连接字符串对应的字段是否为参数化格式，例如："value": "[parameters('DbConnectionString')]"，而非具体的Dev环境连接字符串。
• 确认模板参数文件（TemplateParametersForWorkspace.json）中包含该参数的默认值（通常为Dev环境值），且部署时会被Prod参数覆盖。

4. 排查权限与部署范围问题 #

• 确认部署服务主体对Prod Synapse工作区拥有Microsoft.Synapse/workspaces/write权限，避免因权限不足导致参数更新静默失败。
• 验证部署任务是否覆盖了包含连接字符串的流水线资源，若采用分模块部署，需确认未遗漏目标资源。

5. 处理缓存或异步生效问题 #

• Synapse部署后可能存在短暂缓存，等待5-10分钟后再检查Prod环境的连接字符串是否更新。
• 手动触发Prod流水线重新部署，排除首次部署时的异步加载异常。

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