sp_help_jobs_in_schedule (Transact-SQL)
傳回附加了特定排程之作業的相關資訊。
.gif "主題連結圖示")
語法
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