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

請參閱

參考

sp_delete_job (Transact-SQL)

sp_help_job (Transact-SQL)

sp_stop_job (Transact-SQL)

sp_update_job (Transact-SQL)

系統預存程序 (Transact-SQL)