- 相關軟件
>sp_help_jobstep 創(chuàng)建者：webmaster 更新時間：2006-02-16 15:51返回有關 SQLServerAgent 服務用來執(zhí)行自動活動的作業(yè)的步驟的信息。
語法
sp_help_jobstep [ @job_id = ] 'job_id' |
[ @job_name = ] 'job_name
[ , [ @step_id = ] step_id ]
[ , [ @step_name = ] 'step_name' ]
[ , [ @suffix = ] suffix ]參數
[@job_id =] 'job_id'
是為其返回作業(yè)信息的作業(yè)標識號。job_id 的數據類型為 uniqueidentifier，默認值為 NULL。
[@job_name =] 'job_name'
是作業(yè)名稱。job_name 的數據類型為 sysname，默認值為 NULL。
說明 必須指定 job_id 或 job_name，但不能兩個都指定。
[@step_id =] step_id
作業(yè)中步驟的標識號。如果沒有包括這項參數，則包含作業(yè)中所有的步驟。step_id 的數據類型為 int，默認值為 NULL。
[@step_name =] 'step_name'
是作業(yè)中步驟的名稱。step_name 的數據類型為 sysname，默認值為 NULL。
[@suffix =] suffix
是一個標志，表示是否將一個文本描述追加到輸出的 flags 列。suffix 的數據類型為 bit，默認值為 0。如果 suffix 是 1，則追加描述。
返回代碼值
0（成功）或 1（失?。?/P>
結果集
列名 數據類型 描述 step_id Int 步驟的唯一標識符。 step_name sysname 作業(yè)中步驟的名稱。 subsystem nvarchar(40) 子系統(tǒng)，在該子系統(tǒng)中執(zhí)行步驟命令。 command nvarchar(3200) 在步驟中執(zhí)行的命令。 flags Int 控制步驟行為的值的位掩碼。 cmdexec_success_code Int 對于CmdExec 步驟，這是成功命令的進程退出代碼。 on_success_action timyint 如果步驟成功，將要采取的操作： 1 = 退出正在報告成功的作業(yè)。
2 = 退出正在報告失敗的作業(yè)。
3 = 轉至下一步驟。
4 = 轉至步驟。on_success_step_id Int 如果 on_success_action 為 4，即指明下一步執(zhí)行步驟 4。 on_fail_action Tinyint 如果步驟失敗了，應怎么辦。值和 on_success_action 的值一樣。 on_fail_step_id Int 如果 on_fail_action 為 4，即指明下一步執(zhí)行步驟 4。 server sysname 保留。 database_name sysname 對于 Transact-SQL 步驟，這是將在其中執(zhí)行命令的數據庫。 database_user_name sysname 對于 Transact-SQL 步驟，這是數據庫用戶上下文，命令在這個用戶上下文中執(zhí)行。 retry_attempts Int 應該對命令進行重試的最大次數（如果命令沒有成功）。 retry_interval Int 重試嘗試的間隔（以分鐘為單位）。 os_run_priority Int 保留。 output_file_name nvarchar(200) 命令的輸出結果將要寫入其中的文件（只針對 Transact-SQL 及 CmdExec 步驟）。 last_run_outcome Int 步驟上一次運行的結果： 0 = 失敗
1 = 成功
2 = 重試
3 = 取消
5 = 未知last_run_duration Int 步驟上一次運行的持續(xù)時間（以秒為單位）。 last_run_retries Int 步驟上一次運行時，命令進行重試的次數。 last_run_date Int 步驟上一次開始執(zhí)行的日期。 last_run_time Int 步驟上一次開始執(zhí)行的時間。 權限
執(zhí)行權限默認授予 public 角色。任何可以執(zhí)行該過程的用戶都可以對下列內容進行創(chuàng)建、刪除或更新操作：作業(yè)、作業(yè)步驟、作業(yè)分類、作業(yè)調度、作業(yè)服務器、任務或作業(yè)歷史信息。
示例
A. 返回特定作業(yè)中所有步驟的信息
下面的示例返回名為 Backup Files 的作業(yè)的所有作業(yè)步驟。
USE msdb
EXEC sp_help_jobstep @job_name = 'Backup Files'B. 返回特定作業(yè)步驟的信息
下面的示例返回有關名為 Backup Files 的作業(yè)的第一個作業(yè)步驟的信息。
USE msdb
相關文章
EXEC sp_help_jobstep @job_name = 'Backup Files', @step_id = 1
本頁查看次數: