更新SSIS包默认参数值后未生效的问题排查求助

问题背景 #

通过Azure YAML流水线部署SSIS包，不同环境需要不同参数默认值：

• DEV环境：本地Visual Studio直接修改参数值
• UAT环境：部署前把参数改成UAT对应值，部署后能正常运行
• PROD环境：部署后参数保留UAT的值，所以部署成功后执行SQL脚本更新默认参数为PROD所需值

示例场景 #

某包用脚本任务复制文件，文件路径作为ReadOnlyVariables传入：

• UAT环境路径是T:\Databases，部署后运行正常
• PROD环境路径是F:\Databases，需要把默认参数改成这个值

执行的更新SQL脚本 #

UPDATE ssisdb.[catalog].object_parameters
SET    design_default_value = REPLACE(CONVERT(NVARCHAR(4000), design_default_value), 'T:', 'F:')
WHERE  [object_name] = 'myPackage.dtsx'
       AND SQL_VARIANT_PROPERTY(design_default_value, 'BaseType') = N'nvarchar'
       AND CONVERT(NVARCHAR(4000), design_default_value) LIKE 'T:%'

异常现象 #

• 查询ssisdb.[catalog].object_parameters或通过包配置查看，参数默认值已经显示为F:\Databases，符合预期
• 但运行包时，还是会去T:\Databases路径找文件，和预期不符

疑问 #

1. 能不能直接更新ssisdb.[catalog].object_parameters表来修改SSIS包的默认参数值？
2. 我的操作是不是哪里错了？

补充说明 #

该包已经在使用环境变量：

• 只把盘符设为变量的话，需要修改包来拼接完整路径，不够直观
• 把完整路径设为环境变量的话，现有通用环境变量集合包含50+个共用变量（比如数据库名），但运行包时只能引用一个环境，没法单独加路径变量

问题原因及解决办法 #

1. 直接改系统表的局限 #

SSIS Catalog的object_parameters表存的是设计时默认值，但包运行时实际用的参数值优先级更高的来源有这些：

• 部署时指定的参数值（存在execution_parameter_values表）
• 执行包时手动传入的参数值
• 映射了环境变量的参数值（如果配置了环境引用）

你改了design_default_value之后，如果包在部署或执行时已经有了覆盖值，运行时会优先用这些值，不会用你更新的设计默认值。

2. 你的操作遗漏点 #

就算没有显式传参数，SSIS部署包的时候，会把部署前设置的UAT参数值固化到Catalog的执行上下文相关表中，后续运行包默认会复用这个值，不会读你更新的design_default_value。

3. 靠谱的修改方式 #

要修改默认参数值并让运行时生效，有三种可行方式：

• 重新部署包：在Visual Studio或者部署工具里把参数设为PROD的值再重新部署，确保部署时的参数值是PROD需要的
• 执行时指定参数值：在Azure YAML流水线的包执行步骤里，显式传入PROD的参数值，比如用dtexec命令的/SET参数：

  dtexec /ISServer "\SSISDB\YourFolder\YourProject\myPackage.dtsx" /Server "YourProdServer" /SET \Package.Variables[User::FilePath].Properties[Value];"F:\Databases"
  

• 调整环境变量策略：既然运行包只能引用一个环境，可以把路径变量加到现有通用环境变量集合里，或者新建一个包含路径变量的环境，流水线里根据环境切换引用的集合

4. 为什么查询显示更新成功但运行不生效？ #

object_parameters里的design_default_value只是设计层面的默认值，包部署后，运行时的默认参数值是部署时固化的值，存在其他系统表（比如internal.execution_parameter_values），你改的设计默认值不会自动同步到这些运行时相关的表中。

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