SQL Server Agent中SSIS步骤参数值存储表及更新脚本相关问询

SQL Server Agent中SSIS类型作业步骤的参数配置并非存储在单张独立表中，而是通过msdb数据库下的两张关联系统表共同存储，和SSIS步骤配置界面中设置的参数项一一对应：

• 基础元数据表：msdb.dbo.sysjobsteps
  该表存储所有类型作业步骤的基础信息，其中command字段会拼接存储SSIS步骤的完整执行命令、命令行参数串，是SQL Server Agent运行作业时优先读取的配置来源。
• SSIS步骤专属配置表：msdb.dbo.sysssisjobsteps
  该表专门存储结构化的SSIS步骤配置，其中parameter_xml字段以XML格式序列化存储配置界面中设置的包参数覆盖值、连接管理器属性覆盖值等结构化参数项，和可视化操作界面的配置项完全对应。

重要提醒：直接修改msdb系统表属于非官方支持的操作，执行前必须完整备份msdb数据库，且在变更窗口完成配置校验，操作不当可能导致作业步骤损坏、无法正常启动。微软官方推荐使用内置存储过程完成配置更新，避免直接操作系统表。

操作前的前置查询 #

可以通过以下脚本定位目标作业步骤的当前参数配置，避免更新时定位错误：

-- 定位指定作业下的SSIS步骤配置
SELECT
  j.name AS 作业名称,
  s.step_id AS 步骤ID,
  s.step_name AS 步骤名称,
  s.command AS 步骤执行命令串,
  ss.parameter_xml AS 结构化参数XML配置
FROM msdb.dbo.sysjobs j
INNER JOIN msdb.dbo.sysjobsteps s
  ON j.job_id = s.job_id
LEFT JOIN msdb.dbo.sysssisjobsteps ss
  ON s.job_id = ss.job_id
  AND s.step_id = ss.step_id
WHERE s.subsystem = 'SSIS' -- 筛选所有SSIS类型的作业步骤
  AND j.name = N'你要修改的目标作业名称';

安全更新方式（官方推荐） #

使用内置存储过程sp_update_jobstep完成参数更新，该过程会自动同步关联的系统表配置，不会出现配置不一致的问题：

-- 更新指定SSIS作业步骤的参数
DECLARE
  @target_job_name NVARCHAR(128) = N'你要修改的目标作业名称',
  @target_step_name NVARCHAR(128) = N'要修改的SSIS步骤名称',
  @updated_command NVARCHAR(MAX); -- 填入和界面格式一致的、更新参数后的完整执行命令串

-- 执行更新
EXEC msdb.dbo.sp_update_jobstep
  @job_name = @target_job_name,
  @step_name = @target_step_name,
  @command = @updated_command;

常见踩坑提示 #

• 如果仅修改msdb.dbo.sysssisjobsteps表中的parameter_xml字段，没有同步更新msdb.dbo.sysjobsteps表中的command字段内容，SQL Server Agent运行作业时会优先读取command字段的旧参数值，导致修改完全不生效。
• 完成参数更新后，建议手动启动一次目标作业做小范围测试，验证参数是否符合预期，不要直接在生产环境批量更新后跳过测试环节。

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