sp_start_job (Transact-SQL)
指示 SQL Server 代理立即执行作业。
语法
sp_start_job
{ [@job_name =] 'job_name'
| [@job_id =] job_id }
[ , [@error_flag =] error_flag]
[ , [@server_name =] 'server_name']
[ , [@step_name =] 'step_name']
[ , [@output_flag =] output_flag]
参数
- [ @job_name= ] 'job_name'
要启动的作业的名称。必须指定 job_id 或 job_name,但不能两个都指定。job_name 的数据类型为 sysname,默认值为 NULL。
- [ @job_id= ] job_id
要启动的作业标识号。必须指定 job_id 或 job_id,但不能两个都指定。job_name 的数据类型为 uniqueidentifier,默认值为 NULL。
- [ @error_flag= ] error_flag
标识只是为了提供一些信息。不提供支持。不保证以后的兼容性。
- [ @server_name= ] 'server_name'
启动作业的目标服务器。server_name 的数据类型为 nvarchar(128),默认值为 NULL。server_name 必须是作业当前的目标服务器之一。
- [ @step_name= ] 'step_name'
开始执行作业的步骤名。只应用于本地作业。step_name 的数据类型为 sysname,默认值为 NULL。
- [ @output_flag= ] output_flag
标识只是为了提供一些信息。不提供支持。不保证以后的兼容性。
返回代码值
0(成功)或 1(失败)
结果集
无
备注
此存储过程位于 msdb 数据库中。
权限
默认情况下,只有 sysadmin 固定服务器角色的成员才可以执行此存储过程。其他用户必须被授予 msdb 数据库中下列 SQL Server 代理固定数据库角色的权限之一:
- SQLAgentUserRole
- SQLAgentReaderRole
- SQLAgentOperatorRole
有关这些角色的权限的详细信息,请参阅 SQL Server 代理固定数据库角色。
SQLAgentUserRole 和 SQLAgentReaderRole 的成员只可以启动他们所拥有的作业。SQLAgentOperatorRole 的成员可以启动所有本地作业,包括其他用户所拥有的本地作业。sysadmin 的成员可以启动所有本地作业和多服务器作业。
示例
以下示例启动名为 Weekly Sales Data Backup
的作业。
USE msdb ;
GO
EXEC dbo.sp_start_job N'Weekly Sales Data Backup' ;
GO
请参阅
参考
sp_delete_job (Transact-SQL)
sp_help_job (Transact-SQL)
sp_stop_job (Transact-SQL)
sp_update_job (Transact-SQL)
系统存储过程 (Transact-SQL)