sp_start_job (Transact-SQL)
指示 SQL Server Agent 立即執行作業。
語法
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)