sp_start_job (Transact-SQL)

  • 项目

适用于：SQL ServerAzure SQL 托管实例

指示SQL Server 代理立即执行作业。

Transact-SQL 语法约定

语法

sp_start_job
    [ [ @job_name = ] N'job_name' ]
    [ , [ @job_id = ] 'job_id' ]
    [ , [ @error_flag = ] error_flag ]
    [ , [ @server_name = ] N'server_name' ]
    [ , [ @step_name = ] N'step_name' ]
    [ , [ @output_flag = ] output_flag ]
[ ; ]

参数

[ @job_name = ] N'job_name'

要启动的作业的名称。 @job_name为 sysname，默认值为 NULL.

必须指定@job_id或@job_name，但不能指定这两者。

[ @job_id = ] 'job_id'

要启动的作业标识号。 @job_id是 uniqueidentifier，默认值为 NULL.

必须指定@job_id或@job_name，但不能指定这两者。

[ @error_flag = ] error_flag

标识为仅供参考。 不支持。 不保证以后的兼容性。

[ @server_name = ] N'server_name'

启动作业的目标服务器。 @server_name为 sysname，默认值为 NULL. @server_name必须是作业当前面向的目标服务器之一。

[ @step_name = ] N'step_name'

开始执行作业的步骤名。 @step_name为 sysname，默认值为 NULL. 只应用于本地作业。

[ @output_flag = ] output_flag

标识为仅供参考。 不支持。 不保证以后的兼容性。

返回代码值

0（成功）或 1（失败）。

结果集

无。

注解

此存储过程位于 msdb 数据库中。

此存储过程与用于Azure SQL 数据库的 Azure 弹性作业服务的类似对象共享名称sp_start_job。 有关弹性作业版本的信息，请参阅jobs.sp_start_job（Azure 弹性作业）（Transact-SQL）。

此存储过程由 db_owner 角色拥有。 你可以为任何用户授予 EXECUTE 权限，但这些权限可能会在 SQL Server 升级期间被重写。

其他用户必须被授予数据库中以下SQL Server 代理固定数据库角色msdb之一：

  • 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

相关内容