如何在Azure DevOps中向不同环境/服务器部署SSAS多维数据集

核心需求 #

• 已通过Microsoft.AnalysisServices.Deployment.exe在Azure DevOps将SSAS多维数据集部署至开发环境，因XMLA部署会覆盖角色成员而放弃该方式，当前用exe部署不会改动角色成员（有更优方案欢迎补充）
• 需部署至测试环境，测试环境的数据源服务器与开发环境不同，需要像SSIS的project.param、数据库项目的SQLCmd变量那样，用环境变量动态配置服务器信息

解决方案 #

1. 利用SSAS部署配置文件实现动态参数替换 #

SSAS项目编译后会生成一组部署配置文件，可结合Azure DevOps变量修改文件内的参数：

• 先在SSAS项目中右键项目 → 属性 → 部署，勾选“创建部署配置文件”，编译后输出目录会生成两个关键文件：
  • YourSSASProject.deploymenttargets：存储目标服务器、数据库名称等信息
  • YourSSASProject.configsettings：存储数据源连接字符串、处理选项等配置
• 在Azure DevOps的PowerShell部署脚本中，读取环境变量并替换配置文件的对应内容：
  示例脚本片段：

  # 读取Azure DevOps配置的环境变量
  $targetServer = "$(SSASTargetServer)"
  $dataSourceServer = "$(DataSourceServer)"
  $targetDB = "$(SSASTargetDB)"
  
  # 修改部署目标文件中的服务器和数据库名
  $deploymentTargetsPath = ".\YourSSASProject.deploymenttargets"
  (Get-Content $deploymentTargetsPath) -replace '<ServerName>.*?</ServerName>', "<ServerName>$targetServer</ServerName>" | Set-Content $deploymentTargetsPath
  (Get-Content $deploymentTargetsPath) -replace '<DatabaseName>.*?</DatabaseName>', "<DatabaseName>$targetDB</DatabaseName>" | Set-Content $deploymentTargetsPath
  
  # 修改数据源连接字符串中的服务器地址
  $configSettingsPath = ".\YourSSASProject.configsettings"
  (Get-Content $configSettingsPath) -replace 'Data Source=.*?;', "Data Source=$dataSourceServer;" | Set-Content $configSettingsPath
  

• 在Azure DevOps的变量组中，为开发、测试环境分别配置SSASTargetServer、DataSourceServer、SSASTargetDB变量，部署时选择对应环境的变量组即可

2. 直接向Microsoft.AnalysisServices.Deployment.exe传递命令行参数 #

无需修改配置文件，直接通过命令行参数指定目标服务器和数据源信息，结合Azure DevOps变量：
示例命令：

& "C:\Program Files (x86)\Microsoft SQL Server\160\Tools\Binn\ManagementStudio\Microsoft.AnalysisServices.Deployment.exe" `
".\YourSSASProject.asdatabase" `
/s:`".\YourSSASProject.deploymentoptions`" `
/d:`".\YourSSASProject.deploymenttargets`" `
/c:`".\YourSSASProject.configsettings`" `
/o:`".\DeploymentLog.txt`" `
/TargetServer:"$(SSASTargetServer)" `
/TargetDatabase:"$(SSASTargetDB)" `
/ConfigurationSettings:DataSource1.ConnectionString="Data Source=$(DataSourceServer);Initial Catalog=YourDB;Integrated Security=SSPI;"

注意：将DataSource1替换为你SSAS项目中实际的数据源名称，可在项目的数据源属性中查看

3. 保留角色成员的优化建议 #

你当前使用exe部署的方式确实不会覆盖角色成员，因为该工具默认仅部署模型结构（维度、度量值组、数据源等），不会修改已存在的角色成员。若需更精细控制：

• 在SSAS项目的部署选项中，将“角色”的部署行为设置为保留目标：右键项目→属性→部署→部署选项，找到“角色”并选择“保留目标”
• 若后续考虑使用XMLA部署，可制作增量XMLA脚本，仅部署模型结构变更，不包含角色成员修改；或使用SSAS的ALTER语句单独更新模型部分，避免覆盖角色

Azure DevOps流水线配置要点 #

• 构建阶段：编译SSAS项目，将*.asdatabase、*.deploymenttargets、*.configsettings等文件作为构建工件发布
• 发布阶段：
  1. 下载构建工件
  2. 选择对应环境的变量组
  3. 执行上述PowerShell脚本（修改配置文件或直接传递命令行参数）
  4. 调用Microsoft.AnalysisServices.Deployment.exe完成部署

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