将一个步骤（操作）添加到作业中。

语法

sp_add_jobstep [ @job_id = ] job_id | [ @job_name = ] 'job_name'

    [ , [ @step_id = ] step_id ]

    { , [ @step_name = ] 'step_name' }

    [ , [ @subsystem = ] 'subsystem' ]

    [ , [ @command = ] 'command' ]

    [ , [ @additional_parameters = ] 'parameters' ]

    [ , [ @cmdexec_success_code = ] code ]

    [ , [ @on_success_action = ] success_action ]

    [ , [ @on_success_step_id = ] success_step_id ]

    [ , [ @on_fail_action = ] fail_action ]

    [ , [ @on_fail_step_id = ] fail_step_id ]

    [ , [ @server = ] 'server' ]

    [ , [ @database_name = ] 'database' ]

    [ , [ @database_user_name = ] 'user' ]

    [ , [ @retry_attempts = ] retry_attempts ]

    [ , [ @retry_interval = ] retry_interval ]

    [ , [ @os_run_priority = ] run_priority ]

    [ , [ @output_file_name = ] 'file_name' ]

    [ , [ @flags = ] flags ]

参数

[@job_id =] job_id

将步骤添加于其中的作业的标识号。job_id 的数据类型为 uniqueidentifier，默认设置为 NULL。

[@job_name =] 'job_name'

将步骤添加于其中的作业的名称。job_name 的数据类型为 sysname，默认设置为 NULL。

说明  必须指定 job_id 或 job_name，但不能两个都指定。

[@step_id =] step_id]

作业步骤的序列标识号。步骤标识号从 1 开始，并以 1 为增量，中间无间隙。如果在现有序列中插入步骤，则序列号可以自动调整。如果没有指定 step_id，则提供一个值。step_id 的数据类型为 int，默认设置为 NULL。

[@step_name =] 'step_name'

是步骤的名称。step_name 的数据类型为 sysname，没有默认设置。

[@subsystem =] 'subsystem'

是 SQL Server 代理服务用于执行 command 的子系统。subsystem 的数据类型为 nvarchar(40)，可以是下列值之一。

[@command =] 'command'

 SQLServerAgent 服务通过 subsystem 执行的命令。command 的数据类型为 nvarchar(3200)，默认设置为 NULL。command 可包括下面一个或多个区分大小写的令牌，这些令牌在运行时被替换。

[@additional_parameters =] 'parameters'

保留。parameters 的数据类型为 ntext，默认设置为 NULL。

[@cmdexec_success_code =] code

CmdExec 子系统命令返回的值，该值表明 command 成功执行。code 的数据类型为 int，默认设置为 0。

[@on_success_action =] success_action

步骤成功时所执行的操作。success_action 的数据类型为 tinyint，可以是下列值之一。

[@on_success_step_id =] success_step_id

步骤成功并且 success_action 为 4 时所执行的该作业中步骤的 ID。success_step_id 的数据类型为 int，默认设置为0。

[@on_fail_action =] fail_action

步骤失败时所执行的操作。fail_action 的数据类型为 tinyint，可以是下列值之一。

[@on_fail_step_id =] fail_step_id

步骤失败并且 fail_action 为 4 时所要执行的该作业中步骤的 ID。fail_step_id 的数据类型为 int，默认设置为 0。

[@server =] 'server'

保留。server 的数据类型为 nvarchar(30)，默认值为 NULL。

[@database_name =] 'database'

执行 TSQL 步骤的数据库名称。database 的数据类型为 sysname，默认设置为 NULL，在该情况下使用 master 数据库。

[@database_user_name =] 'user'

是执行 TSQL 步骤时所使用的用户账号名称。user 为 sysname 类型，其默认值为 NULL。user 为 NULL 时，步骤运行在作业所有者的用户 database 上下文中。

[@retry_attempts =] retry_attempts

该步骤失败时所使用的重新尝试次数。retry_attempts 的数据类型为 int，默认设置为 0，表示不允许重新尝试。

[@retry_interval =] retry_interval

重新尝试之间的时间量（以分钟为单位）。retry_interval 的数据类型为 int，默认设置为 0，表示重试间隔为 0 分钟。

[@os_run_priority =] run_priority

保留。

[@output_file_name =] 'file_name'

保存该步骤的输出的文件名称。file_name 的数据类型为 nvarchar(200)，默认设置为 NULL。file_name 可以包含 command 下的一个或多个令牌。该参数只有同 TSQL 或 CmdExec 子系统上运行的命令一起使用时才有效。

[@flags =] flags

控制行为的选项。flags 的数据类型为 int，可以是下列值之一。

返回代码值

0（成功）或 1（失败）

结果集

无

注释

SQL Server 企业管理器提供易于使用的图形方法来管理作业，建议使用该方法创建和管理作业基本结构。

权限

执行权限默认授予 public 角色。

示例

下面的示例创建一个作业步骤，该作业步骤更改名为 sales 的数据库的只读访问权限。此外，此示例指定进行 5 次重新尝试，重试间隔为 5 分钟。

说明  此示例假设 Weekly Sales Data Backup 作业已经存在。

USE msdb
EXEC sp_add_jobstep @job_name = 'Weekly Sales Data Backup',
   @step_name = 'Set database to read only',
   @subsystem = 'TSQL',
   @command = 'exec sp_dboption ''sales'', ''read only'', ''true''', 
   @retry_attempts = 5,
   @retry_interval = 5