sp_help_jobs_in_schedule （Transact-SQL）

適用於：SQL Server

傳回特定排程所附加之作業的相關資訊。

Transact-SQL 語法慣例

語法

  
sp_help_jobs_in_schedule   
     [ @schedule_name = ] 'schedule_name' ,  
     [ @schedule_id = ] schedule_id   

引數

[ @schedule_id = ] schedule_id 要列出資訊的排程識別碼。 schedule_id為 int ，沒有預設值。 您可以指定schedule_id 或 schedule_name 。

[ @schedule_name = ] 'schedule_name' 要列出資訊的排程名稱。 schedule_name為 sysname ，沒有預設值。 您可以指定schedule_id 或 schedule_name 。

傳回碼值

0 （成功） 或 1 （失敗）

結果集

傳回下列結果集：

資料行名稱	資料類型	描述
job_id	uniqueidentifier	作業的唯一識別碼。
originating_server	nvarchar(30)	作業的來源伺服器名稱。
name	sysname	作業的名稱。
「已啟用」	tinyint	指出是否啟用作業執行。
description	nvarchar(512)	作業的描述。
start_step_id	int	作業中應該開始執行之步驟的識別碼。
category	sysname	作業類別目錄。
擁有者	sysname	作業擁有者。
notify_level_eventlog	int	位元遮罩，指出在何種情況下，通知事件應該記錄至 Microsoft Windows 應用程式記錄檔。 可以是下列值之一： 0 = 永不 1 = 作業成功時 2 = 作業失敗時 3 = 每當作業完成時 （不論作業結果為何）
notify_level_email	int	位元遮罩，指出當作業完成時，應該傳送通知電子郵件。 可能的值與 notify_level_eventlog 相同。
notify_level_netsend	int	位元遮罩，指出在哪些情況下，當作業完成時，應該傳送網路訊息。 可能的值與 notify_level_eventlog 相同。
notify_level_page	int	位元遮罩，指出當作業完成時，應該傳送頁面。 可能的值與 notify_level_eventlog 相同。
notify_email_operator	sysname	要通知之操作員的電子郵件名稱。
notify_netsend_operator	sysname	傳送網路訊息時所使用的電腦或使用者名稱。
notify_page_operator	sysname	傳送頁面時所使用的電腦或使用者名稱。
delete_level	int	位元遮罩，指出作業完成時應刪除作業的情況。 可能的值與 notify_level_eventlog 相同。
date_created	datetime	建立作業的日期。
date_modified	datetime	上次修改作業的日期。
version_number	int	作業的版本 (每次修改作業時，都會自動更新)。
last_run_date	int	上次開始執行的作業日期。
last_run_time	int	作業上次開始執行的時間。
last_run_outcome	int	上次執行作業的結果： 0 = 失敗 1 = 成功 3 = 已取消 5 = 未知
next_run_date	int	作業排程為下一步執行的日期。
next_run_time	int	作業排定下次執行的時間。
next_run_schedule_id	int	下一個執行排程的識別碼。
current_execution_status	int	目前的執行狀態。
current_execution_step	sysname	作業中的目前執行步驟。
current_retry_attempt	int	如果作業正在執行且步驟已重試，這是目前的重試嘗試。
has_step	int	作業擁有的作業步驟數目。
has_schedule	int	作業擁有的作業排程數目。
has_target	int	作業擁有的目標伺服器數目。
type	int	作業的類型： 1 = 本機作業。 2 = 多伺服器作業。 0 = 作業沒有目標伺服器。

備註

此程式會列出附加至指定排程之作業的相關資訊。

權限

依預設，只有 系統管理員 (sysadmin) 固定伺服器角色的成員，才能夠執行這個預存程序。 其他使用者必須獲授與 msdb 資料庫的下列其中一個 SQL Server Agent 固定資料庫角色：

• SQLAgentUserRole

• SQLAgentReaderRole

• SQLAgentOperatorRole

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

SQLAgentUserRole 的成員 只能檢視他們所擁有的作業狀態。

範例

下列範例會列出附加至排程的 NightlyJobs 作業。

USE msdb ;  
GO  
  
EXEC sp_help_jobs_in_schedule  
    @schedule_name = N'NightlyJobs' ;  
GO  

另請參閱

SQL Server Agent 預存程式 （Transact-SQL）
sp_add_schedule (Transact-SQL)
sp_attach_schedule (Transact-SQL)
sp_delete_schedule （Transact-SQL）
sp_detach_schedule (Transact-SQL)