如何自动化将Dynamics 365 Synapse配置从DEV部署到TEST及SIT环境？

一、前置准备 #

• 确认DEV、TEST、SIT三个环境的Dataverse均已启用Azure Synapse Link功能，操作账号需拥有对应环境的System Administrator/Environment Maker权限，以及目标Azure Synapse工作区的Contributor权限
• 提前在TEST和SIT环境中搭建好匹配的Azure Synapse工作区（或确认现有工作区可复用），并完成网络连通配置（如VNet peering、防火墙规则）

二、自动化部署核心步骤 #

1. 导出DEV环境的配置与视图 #

• 导出Synapse Link配置：
  可以通过Power Platform Admin Center进入DEV环境的Dataverse设置，找到已配置的Azure Synapse Link，直接导出配置为JSON文件；也用PowerShell批量导出：

  Export-PowerAppDataverseSynapseLink -EnvironmentName "DEV环境ID" -SynapseLinkName "你的链接名称" -OutputFilePath ".\synapse-link-config.json"
  

• 导出Synapse工作区视图：
  在Azure Synapse Studio中，右键目标视图选择Script as→CREATE To→File导出单视图SQL脚本；或者用Azure CLI批量导出所有视图脚本：

  az synapse sql script create --workspace-name "DEV-Synapse-WS" --name "ExportAllViews" --file-path "./views-export.sql" --query "properties.content" -o tsv > "./all-views.sql"
  

2. 搭建自动化流水线（以Azure DevOps为例） #

创建多阶段流水线，覆盖DEV验证、TEST部署、SIT部署三个环节：

• DEV验证阶段：
  • 用PowerShell任务执行配置导出命令，校验导出的JSON文件格式完整
  • 用Azure CLI任务执行az synapse sql script validate命令，检查视图SQL脚本的语法正确性
• TEST部署阶段：
  • 用PowerShell任务导入Synapse Link配置到TEST环境（注意替换目标工作区名称）：

    $config = Get-Content ".\synapse-link-config.json" | ConvertFrom-Json
    $config.SynapseWorkspaceName = "TEST-Synapse-WS"
    $config | ConvertTo-Json | Set-Content ".\synapse-link-config-test.json"
    Import-PowerAppDataverseSynapseLink -EnvironmentName "TEST环境ID" -InputFilePath ".\synapse-link-config-test.json"
    

  • 用Azure CLI任务在TEST的Synapse工作区执行视图创建脚本：

    az synapse sql script execute --workspace-name "TEST-Synapse-WS" --file-path "./all-views.sql"
    

  • 添加验证任务：检查TEST环境中Synapse Link状态为Running，并执行视图查询验证数据同步正常
• SIT部署阶段：
  重复TEST阶段的部署步骤，替换为SIT环境的ID和对应Synapse工作区名称即可

3. 关键注意事项 #

• 若TEST/SIT环境的Synapse工作区资源组、名称与DEV不同，需在导入配置前通过脚本批量替换JSON中的对应字段
• 流水线使用的服务主体需提前配置好Power Platform和Azure的跨环境权限，避免手动授权中断流程
• 部署完成后需触发一次全量同步，验证Dataverse数据到Synapse的同步完整性，以及视图查询结果与DEV一致
• 将导出的配置文件和SQL脚本存入Git仓库，实现版本追溯与变更管理

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