- 相關軟件
>sp_help_job 創(chuàng)建者：webmaster 更新時間：2006-02-16 15:51返回有關 SQLServerAgent 服務用來在 Microsoft® SQL Server™ 中執(zhí)行自動活動的那些作業(yè)的信息。
語法
sp_help_job [ [ @job_id = ] job_id ]
[ , [ @job_name = ] 'job_name' ]
[ , [ @job_aspect = ] 'job_aspect' ]
[ , [ @job_type = ] 'job_type' ]
[ , [ @owner_login_name = ] 'login_name' ]
[ , [ @subsystem = ] 'subsystem' ]
[ , [ @category_name = ] 'category' ]
[ , [ @enabled = ] enabled ]
[ , [ @execution_status = ] status ]
[ , [ @date_comparator = ] 'date_comparison' ]
[ , [ @date_created = ] date_created ]
[ , [ @date_last_modified = ] date_modified ]
[ , [ @description = ] 'description_pattern' ]參數(shù)
[@job_id =] job_id
是作業(yè)標識號。job_id 的數(shù)據(jù)類型為 uniqueidentifier，默認值為 NULL。
[@job_name =] 'job_name'
是作業(yè)的名稱。job_name 為 sysname 類型，其默認值為 NULL。
說明 必須指定 job_id 或 job_name，但不能兩個都指定。
[@job_aspect =] 'job_aspect'
是要顯示的作業(yè)特性。job_aspect 的數(shù)據(jù)類型為 varchar(9)，默認值為 NULL，并且可以是下列值之一。
值 描述 ALL 作業(yè)特征信息 JOB 作業(yè)信息 SCHEDULES 調(diào)度信息 STEPS 作業(yè)步驟信息 TARGETS 目標信息 [@job_type =] 'job_type'
是報表中要包括的作業(yè)類型。job_type 的數(shù)據(jù)類型為 varchar(12)，默認值為 NULL。job_type 可以是 LOCAL 或 MULTI-SERVER。
[@owner_login_name =] 'login_name'
是作業(yè)所有者的登錄名。login_name 的數(shù)據(jù)類型為 sysname，默認值為 NULL。
[@subsystem =] 'subsystem'
是對子系統(tǒng)的描述。subsystem 的數(shù)據(jù)類型為 nvarchar(60)，默認設置為 NULL。
[@category_name =] 'category'
是分類名。category 的數(shù)據(jù)類型為 sysname，默認值為 NULL。
[@enabled =] enabled
是一個數(shù)字，表示是顯示啟用作業(yè)的信息，還是顯示禁用作業(yè)的信息。enabled 的數(shù)據(jù)類型為 tinyint，默認值為 NULL。1 表示啟用的作業(yè)，0 表示禁用的作業(yè)。
[@execution_status =] status
是作業(yè)的執(zhí)行狀態(tài)。status 的數(shù)據(jù)類型為 int，默認值為 NULL，而且可以是下列值之一。
值 描述 0 只返回那些空閑的或掛起的作業(yè)。 1 正在執(zhí)行。 2 正在等待線程。 3 在兩次重試之間。 4 空閑。 5 掛起。 7 正在執(zhí)行完成操作。 [@date_comparator =] 'date_comparison'
是在 date_created 和 date_modified 的比較中所使用的比較運算符。date_comparison 的數(shù)據(jù)類型為 char(1)，并且可以是 =、< 或 >。
[@date_created =] date_created
是創(chuàng)建作業(yè)的日期。date_created 的數(shù)據(jù)類型為 datetime，默認值為 NULL。
[@date_last_modified =] date_modified
是最后修改作業(yè)的日期。date_modified 的數(shù)據(jù)類型為 datetime，默認值為 NULL。
[@description =] 'description_pattern'
是作業(yè)的描述。description_pattern 的數(shù)據(jù)類型為 nvarchar(512)，默認值為 NULL。description_pattern 可以包含 SQL Server 通配符，以實現(xiàn)模式匹配。
返回代碼值
0（成功）或 1（失?。?/P>
結果集
如果沒有指定參數(shù)，那么 sp_help_job 返回下面的結果集。
列名 數(shù)據(jù)類型 描述 job_id uniqueidentifier 作業(yè)的唯一 ID。 originating_server nvarchar(30) 作業(yè)來自的服務器名稱。 name sysname 作業(yè)的名稱。 enabled tinyint 表示是否啟用待執(zhí)行的作業(yè)。 description nvarchar(512) 對作業(yè)的描述。 start_step_id int 執(zhí)行作業(yè)的起始步驟 ID。 category sysname 作業(yè)分類。 owner sysname 作業(yè)所有者。 notify_level_eventlog int 位掩碼，它表示在何種情況下通知事件應記錄到 Microsoft Windows NT® 應用程序日志中?？梢允窍铝兄抵唬?br /> 0 = 從不
1 = 當作業(yè)成功時
2 = 當作業(yè)失敗時
3 = 當作業(yè)完成時（無論作業(yè)結果如何）notify_level_email int 位掩碼，它指明當作業(yè)完成時，在什么情況下應該發(fā)送一個提示電子郵件?？赡苤蹬c notify_level_eventlog 的可能值相同。 notify_level_netsend int 位掩碼，它指明當作業(yè)完成時，在什么情況下應該發(fā)送一個網(wǎng)絡消息?？赡苤蹬c notify_level_eventlog 的可能值相同。 notify_level_page int 位掩碼，它指明當作業(yè)完成時，在什么情況下應該發(fā)送一個呼叫。可能值與 notify_level_eventlog 的可能值相同。 notify_email_operator sysname 要通知的操作員的電子郵件名稱。 notify_netsend_operator sysname 當發(fā)送網(wǎng)絡消息時，所使用的計算機或用戶的名稱。 notify_page_operator sysname 當發(fā)送尋呼時，所使用的計算機或用戶的名稱。 delete_level int 位掩碼，它指明當作業(yè)完成時，在什么情況下應該刪除作業(yè)?？赡苤蹬c notify_level_eventlog 的可能值相同。 date_created datetime 作業(yè)的創(chuàng)建日期。 date_modified datetime 上次修改作業(yè)的日期。 version_number int 作業(yè)的版本（每次修改作業(yè)時都自動對其進行更新）。 last_run_date int 作業(yè)上一次開始執(zhí)行的日期。 last_run_time int 作業(yè)上一次開始執(zhí)行的時間。 last_run_outcome int 作業(yè)上一次運行時所得到的結果： 0 = 失敗
1 = 成功
3 = 取消
5 = 未知next_run_date int 調(diào)度作業(yè)下一次運行的日期。 next_run_time int 調(diào)度作業(yè)下一次運行的時間。 next_run_schedule_id int 下一個運行的調(diào)度的標識號。 current_execution_status int 當前的執(zhí)行狀態(tài)。 current_execution_step sysname 作業(yè)中當前的執(zhí)行步驟。 current_retry_attempt int 如果作業(yè)正在運行，并且已經(jīng)重試過該步驟，那么這就是當前的重試嘗試。 has_step int 作業(yè)具有的作業(yè)步驟的個數(shù)。 has_schedule int 作業(yè)具有的作業(yè)調(diào)度的個數(shù)。 has_target int 作業(yè)具有的目標服務器的個數(shù)。 Type int 1 = 本地作業(yè)。
2 = 多服務器作業(yè)。
0 = 作業(yè)沒有目標服務器。如果指定了 job_id 或 job_name，那么 sp_help_job 針對作業(yè)步驟、作業(yè)調(diào)度及作業(yè)目標服務器返回下面這些額外的結果集。
下面是針對作業(yè)步驟的結果集。
列名 數(shù)據(jù)類型 描述 step_id int 步驟的唯一（是針對該作業(yè)的）標識符。 step_name sysname 步驟的名稱。 Subsystem nvarchar(40) 子系統(tǒng)，在該子系統(tǒng)中執(zhí)行步驟命令。 Command nvarchar(3200) 執(zhí)行的命令。 Flags nvarchar(4000) 控制步驟行為的值的位掩碼。 cmdexec_success_code int 對于CmdExec 步驟，這是成功命令的進程退出代碼。 on_success_action nvarchar(4000) 步驟成功時的操作： 1 = 成功后退出。
2 = 失敗后退出。
3 = 轉(zhuǎn)到下一步。
4 = 轉(zhuǎn)至步驟。on_success_step_id int 如果 on_success_action 為 4，即指明下一步執(zhí)行步驟 4。 on_fail_action nvarchar(4000) 步驟失敗時所采取的操作。值與 on_success_action 的值相同。 on_fail_step_id int 如果 on_fail_action 為 4，即指明下一步執(zhí)行步驟 4。 Server sysname 保留。 database_name sysname 對于 Transact=SQL 步驟，這是將要在其中執(zhí)行命令的數(shù)據(jù)庫。 database_user_name sysname 對于 Transact=SQL 步驟，這是數(shù)據(jù)庫用戶上下文，命令將在這個數(shù)據(jù)庫用戶上下文中執(zhí)行。 retry_attempts int 在將步驟認定為已經(jīng)失敗之前，應該對命令進行重試的最大次數(shù)（如果命令沒有成功）。 retry_interval int 兩次重試嘗試之間的間隔（以分鐘為單位）。 os_run_priority varchar(4000) 保留。 output_file_name varchar(200) 應該將命令的輸出寫入到其中的文件（只針對 Transact=SQL 及 CmdExec 步驟）。 last_run_outcome int 步驟上一次運行的結果： 0 = 失敗
1 = 成功
3 = 取消
5 = 未知last_run_duration int 步驟上一次運行的持續(xù)時間（以秒為單位）。 last_run_retries int 步驟上一次運行時，命令進行重試的次數(shù)。 last_run_date int 步驟上一次開始執(zhí)行的日期。 last_run_time int 步驟上一次開始執(zhí)行的時間。 下面是針對作業(yè)調(diào)度的結果集。
列名 數(shù)據(jù)類型 描述 schedule_id int 調(diào)度的標識符（對所有作業(yè)是唯一的）。 schedule_name sysname 調(diào)度的名稱（只對這個作業(yè)是唯一的）。 Enabled int 指明調(diào)度是活動的 (1) 還是不活動的 (0)。 freq_type int 指明何時執(zhí)行作業(yè)的值： 1 = 一次
4 = 每日一次
8 = 每周一次
16 = 每月一次
32 = 每月一次，與 freq_interval 相關
64 = 在 SQLServerAgent 服務啟動時運行。freq_interval int 執(zhí)行作業(yè)的日子。該值依賴于 freq_type 的值。有關更多信息，請參見 sp_add_jobschedule。 freq_subday_type int freq_subday_interval 的單位。有關更多信息，請參見 sp_add_jobschedule。 freq_subday_interval int 在作業(yè)的每次執(zhí)行之間所發(fā)生的 freq_subday_type 的周期個數(shù)。有關更多信息，請參見 sp_add_jobschedule。 freq_relative_interval int 在每個月中，freq_interval 的已調(diào)度作業(yè)的發(fā)生情況。有關更多信息，請參見 sp_add_jobschedule。 freq_recurrence_factor int 作業(yè)的已調(diào)度執(zhí)行日期之間的間隔月數(shù)。 active_start_date int 開始執(zhí)行作業(yè)的日期。 active_end_date int 結束執(zhí)行作業(yè)的日期。 active_start_time int 在 active_start_date 那一天，開始執(zhí)行作業(yè)的時間。 active_end_time int 在 active_end_date 那一天，結束執(zhí)行作業(yè)的時間。 date_created datetime 創(chuàng)建調(diào)度的日期。 schedule_description nvarchar(4000) 對調(diào)度的英語描述（如果需要的話）。 next_run_date int 調(diào)度下一次引發(fā)作業(yè)運行的日期。 next_run_time int 調(diào)度下一次引發(fā)作業(yè)運行的時間。 下面是針對目標服務器的結果集。
列名 數(shù)據(jù)類型 描述 server_id int 目標服務器的標識符。 server_name nvarchar(30) 目標服務器的計算機名稱。 enlist_date datetime 將目標服務器登記到主服務器 (MSX) 的日期。 last_poll_date datetime 目標服務器上一次輪詢 MSX 的日期。 last_run_date int 在這個目標服務器上，作業(yè)上一次開始執(zhí)行的日期。 last_run_time int 在這個目標服務器上，作業(yè)上一次開始執(zhí)行的時間。 last_run_duration int 作業(yè)上一次在這個目標服務器上運行的持續(xù)時間。 last_run_outcome tinyint 作業(yè)上一次在這個服務器上運行的結果： 0 = 失敗
1 = 成功
3 = 取消
5 = 未知last_outcome_message nvarchar(1024) 作業(yè)上一次在這個目標服務器上運行時的結果消息。 權限
執(zhí)行權限默認授予 msdb 數(shù)據(jù)庫中的 public 角色。可以執(zhí)行該過程的用戶和 sysadmin 固定角色成員的用戶都可以對下列內(nèi)容進行創(chuàng)建、刪除或更新操作：作業(yè)、作業(yè)步驟、作業(yè)分類、作業(yè)調(diào)度、作業(yè)服務器、任務或作業(yè)歷史信息。
非 sysadmin 固定角色成員的用戶可使用 sp_help_job 只查看自己的作業(yè)。
當由 sysadmin 固定服務器角色成員的用戶喚醒調(diào)用 sp_help_job 時，將在運行 SQL Server 服務的安全上下文中執(zhí)行 sp_help_job。當用戶不是 sysadmin 組的成員時，sp_help_job 將模擬 SQL Server 代理的代理帳戶，該帳戶是使用 xp_sqlagent_proxy_account 指定的。如果代理帳戶不可用，則 sp_help_job 將失敗。僅對于 Microsoft® Windows NT® 4.0 和 Windows 2000 才如此。在 Windows 9.x 上無模擬，并且始終在啟動 Windows 9.x 的用戶的安全上下文中執(zhí)行 sp_help_job。
示例
A. 列出所有作業(yè)的信息
下面的示例執(zhí)行不帶參數(shù)的 sp_help_job 過程，從而為當前在 msdb 數(shù)據(jù)庫中定義的所有作業(yè)返回信息。
USE msdb
EXEC sp_help_jobB. 列出特定作業(yè)的信息
下面的示例列出了名為 Archive Tables 的多服務器作業(yè)的所有作業(yè)特征信息，該作業(yè)在其中啟用，并且自創(chuàng)建以來已經(jīng)被更改。
USE msdb
相關文章
EXEC sp_help_job NULL, 'Archive Tables', 'ALL', 'MULTI-SERVER', 'janetl',
NULL, NULL, 1, 1, '<', '12/01/97', '6/25/98', NULL
本頁查看次數(shù):