- 相關(guān)軟件
>sp_help_jobhistory 創(chuàng)建者：webmaster 更新時(shí)間：2006-02-16 15:51為多服務(wù)器管理域中的服務(wù)器提供有關(guān)作業(yè)的信息。
語(yǔ)法
sp_help_jobhistory [ [ @job_id = ] job_id ]
[ , [ @job_name = ] 'job_name' ]
[ , [ @step_id = ] step_id ]
[ , [ @sql_message_id = ] sql_message_id ]
[ , [ @sql_severity = ] sql_severity ]
[ , [ @start_run_date = ] start_run_date ]
[ , [ @end_run_date = ] end_run_date ]
[ , [ @start_run_time = ] start_run_time ]
[ , [ @end_run_time = ] end_run_time ]
[ , [ @minimum_run_duration = ] minimum_run_duration ]
[ , [ @run_status = ] run_status ]
[ , [ @minimum_retries = ] minimum_retries ]
[ , [ @oldest_first = ] oldest_first ]
[ , [ @server = ] 'server' ]
[ , [ @mode = ] 'mode' ]參數(shù)
[@job_id =] job_id
作業(yè)標(biāo)識(shí)號(hào)。job_id 的數(shù)據(jù)類(lèi)型為 uniqueidentifier，默認(rèn)值為 NULL。
[@job_name =] 'job_name'
是作業(yè)名稱(chēng)。job_name 的數(shù)據(jù)類(lèi)型為 sysname，默認(rèn)值為 NULL。
[@step_id =] step_id
是步驟標(biāo)識(shí)號(hào)。step_id 的數(shù)據(jù)類(lèi)型為 int，默認(rèn)值為 NULL。
[@sql_message_id =] sql_message_id
執(zhí)行作業(yè)時(shí) Microsoft® SQL Server™ 返回的錯(cuò)誤信息的標(biāo)識(shí)號(hào)。sql_message_id 的數(shù)據(jù)類(lèi)型為 int，默認(rèn)值為 NULL。
[@sql_severity =] sql_severity
是當(dāng)執(zhí)行作業(yè)時(shí)由 SQL Server 返回的錯(cuò)誤信息的嚴(yán)重級(jí)別。sql_severity 的數(shù)據(jù)類(lèi)型為 int，默認(rèn)值為 NULL。
[@start_run_date =] start_run_date
是作業(yè)開(kāi)始執(zhí)行的日期。start_run_date 的數(shù)據(jù)類(lèi)型為 int，默認(rèn)值為 NULL。必須以 YYYYMMDD 形式輸入 start_run_date，其中 YYYY 表示四個(gè)字符的年份，MM 表示兩個(gè)字符的月份名稱(chēng)，DD 則表示兩個(gè)字符的日期名稱(chēng)。
[@end_run_date =] end_run_date
是完成作業(yè)的日期。end_run_date 的數(shù)據(jù)類(lèi)型為 int，默認(rèn)值為 NULL。必須以 YYYYMMDD 形式輸入 end_run_date，其中 YYYY 表示四個(gè)字符的年份，MM 表示兩個(gè)字符的月份名稱(chēng)，DD 則表示兩個(gè)字符的日期名稱(chēng)。
[@start_run_time =] start_run_time
是作業(yè)開(kāi)始執(zhí)行的時(shí)間。start_run_time 的數(shù)據(jù)類(lèi)型為 int，默認(rèn)值為 NULL。必須以 HHMMSS 形式輸入 start_run_time，其中 HH 表示兩個(gè)字符的天中小時(shí)，MM 表示兩個(gè)字符的天中分鐘，SS 則表示兩個(gè)字符的天中秒。
[@end_run_time =] end_run_time
是作業(yè)結(jié)束執(zhí)行的時(shí)間。end_run_time 的數(shù)據(jù)類(lèi)型為 int，默認(rèn)值為 NULL。必須以 HHMMSS 形式輸入 end_run_time，其中 HH 表示兩個(gè)字符的天中小時(shí)，MM 表示兩個(gè)字符的天中分鐘，SS 則表示兩個(gè)字符的天中秒。
[@minimum_run_duration =] minimum_run_duration
是完成作業(yè)所用的最小時(shí)間長(zhǎng)度。minimum_run_duration 的數(shù)據(jù)類(lèi)型為 int，默認(rèn)值為 NULL。必須以 HHMMSS 形式輸入 minimum_run_duration，其中 HH 表示一天中兩個(gè)字符的小時(shí)，MM 表示兩個(gè)字符的天中分鐘，SS 則表示兩個(gè)字符的天中秒。
[@run_status =] run_status
是作業(yè)的執(zhí)行狀態(tài)。run_status 的數(shù)據(jù)類(lèi)型為 int，默認(rèn)值為 NULL，而且可以是下列值之一。
值 描述 0 失敗 1 已成功 2 重試（只針對(duì)步驟） 3 已取消 4 進(jìn)行中的消息 5 未知 [@minimum_retries =] minimum_retries
是作業(yè)應(yīng)該重試運(yùn)行的最少次數(shù)。minimum_retries 的數(shù)據(jù)類(lèi)型為 int，默認(rèn)值為 NULL。
[@oldest_first =] oldest_first
表示是否使用最早的作業(yè)最先提交的方式來(lái)提交輸出結(jié)果。oldest_first 的數(shù)據(jù)類(lèi)型為 int，默認(rèn)值為 0，這表示首先提交最晚的作業(yè)。而 1 表示首先提交最早的作業(yè)。
[@server =] 'server'
是在其上執(zhí)行作業(yè)的服務(wù)器名稱(chēng)。server 的數(shù)據(jù)類(lèi)型為 nvarchar(30)，默認(rèn)值為 NULL。
[@mode =] 'mode'
表示 SQL Server 是打印結(jié)果集中的所有列 (FULL)，還是打印列的匯總。mode 的數(shù)據(jù)類(lèi)型為 varchar(7)，默認(rèn)值為 SUMMARY。
返回代碼值
0（成功）或 1（失敗）
結(jié)果集
實(shí)際的列列表依賴(lài)于 mode 的值。下面顯示了列的最綜合的集合，當(dāng) mode 為 FULL 時(shí)，就會(huì)返回這樣的集合。
列名 數(shù)據(jù)類(lèi)型 描述 instance_id int 歷史條目標(biāo)識(shí)號(hào)。 job_id uniqueidentifier 作業(yè)標(biāo)識(shí)號(hào)。 job_name sysname 作業(yè)名稱(chēng)。 step_id int 步驟標(biāo)識(shí)號(hào)（對(duì)于作業(yè)歷史為 0）。 step_name sysname 步驟名稱(chēng)（對(duì)于作業(yè)歷史為 NULL）。 sql_message_id int 對(duì)于 Transact-SQL 步驟，當(dāng)運(yùn)行命令時(shí)，最近遇到的 Transact-SQL 錯(cuò)誤號(hào)。 sql_severity int 對(duì)于Transact-SQL 步驟，當(dāng)運(yùn)行命令時(shí)，遇到的最高 Transact-SQL 錯(cuò)誤嚴(yán)重度。 message nvarchar(1024) 作業(yè)或步驟歷史消息。 run_status int 作業(yè)或步驟的結(jié)果。 run_date int 作業(yè)或步驟開(kāi)始執(zhí)行的日期。 run_time int 作業(yè)或步驟開(kāi)始執(zhí)行的時(shí)間。 run_duration int 以 HHMMSS 格式表示的作業(yè)或步驟的已執(zhí)行時(shí)間。 operator_emailed nvarchar(20) 接收有關(guān)該作業(yè)的電子郵件的操作員（對(duì)于步驟歷史為 NULL）。 operator_netsent nvarchar(20) 接收有關(guān)該作業(yè)的網(wǎng)絡(luò)消息的操作員（對(duì)于步驟歷史為 NULL）。 operator_paged nvarchar(20) 接收有關(guān)該作業(yè)的呼叫的操作員（對(duì)于步驟歷史為 NULL）。 retries_attempted int 步驟的重試次數(shù)（對(duì)于作業(yè)歷史始終為 0）。 server nvarchar(30) 步驟或作業(yè)在其上執(zhí)行的服務(wù)器。始終為 (local)。 注釋
sp_help_jobhistory 返回一個(gè)帶有指定的已調(diào)度作業(yè)的歷史記錄的報(bào)表。如果沒(méi)有指定參數(shù)，那么該報(bào)表包含所有已調(diào)度作業(yè)的歷史。
權(quán)限
sysadmin 固定服務(wù)器角色或 db_owner 固定數(shù)據(jù)庫(kù)角色在默認(rèn)情況下有執(zhí)行此過(guò)程的權(quán)限，他們可以將權(quán)限授予其他用戶(hù)。
示例
下面的示例顯示了失敗的作業(yè)以及失敗的作業(yè)步驟的所有列及所有作業(yè)信息，這些失敗的作業(yè)和失敗的作業(yè)步驟帶有 50100 錯(cuò)誤信息（一個(gè)用戶(hù)定義的錯(cuò)誤信息），嚴(yán)重度為 20，起始日期為 1998 年 6 月 1 日，在 LONDON2 服務(wù)器上。
USE msdb
相關(guān)文章
EXEC sp_help_jobhistory NULL, NULL, NULL, 50100, 20, 19980601, NULL,
NULL, NULL, NULL, 0, NULL, 1, 'LONDON2', 'FULL'
本頁(yè)查看次數(shù):