sp_help_jobs_in_schedule (Transact-SQL)

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

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	作業的名稱。
enabled	tinyint	指出是否啟用作業，以便執行。
description	nvarchar(512)	作業的描述。
start_step_id	int	應該作為執行起點的作業步驟識別碼。
category	sysname	作業類別目錄。
owner	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)