共用方式為

sp_help_jobs_in_schedule （Transact-SQL）

  • 發行項

適用於：SQL Server

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

Transact-SQL 語法慣例

語法

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

引數

[ @schedule_id = ] schedule_id

要列出資訊的排程標識碼。 @schedule_id為 int，預設值為 NULL。

您可以指定@schedule_id或@schedule_name。

[ @schedule_name = ] N'schedule_name'

要列出資訊的排程名稱。 @schedule_name為 sysname，預設值為 NULL。

您可以指定@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 位掩碼，指出在何種情況下，通知事件應該記錄到 windows 應用程式記錄檔Microsoft。 可以是下列值之一：

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 = 作業沒有目標伺服器。

備註

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

權限

此預存程式是由 db_owner 角色所擁有。 您可以授與 EXECUTE 任何用戶的許可權，但這些許可權可能會在 SQL Server 升級期間覆寫。

其他用戶必須在資料庫中獲得下列其中一個 SQL Server Agent 固定資料庫角色 msdb ：

  • SQLAgentUserRole
  • SQLAgentReaderRole
  • SQLAgentOperatorRole

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

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

範例

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

USE msdb;
GO

EXEC sp_help_jobs_in_schedule
    @schedule_name = N'NightlyJobs';
GO

相關內容