共用方式為

  • 發行項

sp_start_job (Transact-SQL)

指示 SQL Server Agent 立即執行作業。

主題連結圖示Transact-SQL 語法慣例

語法

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_name，但不能同時指定兩者。job_id 是 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 Agent 固定資料庫角色。

  • SQLAgentUserRole

  • SQLAgentReaderRole

  • SQLAgentOperatorRole

如需有關這些角色權限的詳細資料，請參閱＜SQL Server Agent 固定資料庫角色＞。

SQLAgentUserRole 和 SQLAgentReaderRole 的成員只能啟動他們自己的作業。SQLAgentOperatorRole 的成員可以啟動所有本機作業，包括其他使用者擁有的那些作業在內。系統管理員 (sysadmin) 的成員可以啟動所有本機作業和多伺服器作業。

範例

下列範例會啟動名稱為 Weekly Sales Data Backup 的作業。

USE msdb ;
GO

EXEC dbo.sp_start_job N'Weekly Sales Data Backup' ;
GO