更改用于自動(dòng)執(zhí)行操作的作業(yè)中某一步驟的設(shè)置。
sp_update_jobstep [@job_id =] job_id, | [@job_name =] 'job_name',
[@step_id =] step_id
[,[@step_name =] 'step_name']
[, [@subsystem =] 'subsystem']
[, [@command =] 'command']
[, [@additional_parameters =] 'parameters']
[, [@cmdexec_success_code =] success_code]
[, [@on_success_action =] success_action]
[, [@on_success_step_id =] success_step_id]
[, [@on_fail_action =] fail_action]
[, [@on_fail_step_id =] fail_step_id]
[, [@server =] 'server']
[, [@database_name =] 'database']
[, [@database_user_name =] 'user']
[, [@retry_attempts =] retry_attempts]
[, [@retry_interval =] retry_interval]
[, [@os_run_priority =] run_priority]
[, [@output_file_name =] 'file_name']
[, [@flags =] flags]
[@job_id =] job_id
是該步驟所屬于的作業(yè)的標(biāo)識(shí)號(hào)。job_id 的數(shù)據(jù)類型為 uniqueidentifier,其默認(rèn)值為 NULL。
[@job_name =] 'job_name'
是該步驟所屬于的作業(yè)的名稱。job_name 的數(shù)據(jù)類型為 sysname,其默認(rèn)值為 NULL。
說明 必須或者指定 job_id 或者指定 job_name,但不能兩個(gè)都指定。
[@step_id =] step_id
是要修改的作業(yè)步驟的標(biāo)識(shí)號(hào)。該標(biāo)識(shí)號(hào)不能更改。step_id 的數(shù)據(jù)類型為 int,無默認(rèn)值。
[@step_name =] 'step_name'
是步驟的新名稱。step_name 的數(shù)據(jù)類型為 sysname,其默認(rèn)值為 NULL。
[@subsystem =] 'subsystem'
是 SQL Server 代理用于執(zhí)行 command 的子系統(tǒng)。subsystem 的數(shù)據(jù)類型為 nvarchar(40),其默認(rèn)值為 NULL。
[@command =] 'command'
是通過 subsystem 執(zhí)行的命令。command 的數(shù)據(jù)類型為 nvarchar(3200),其默認(rèn)值為 NULL。
[@additional_parameters =] 'parameters'
保留。
[@cmdexec_success_code =] success_code
是 CmdExec 子系統(tǒng)命令的返回值,用以指示 command 執(zhí)行成功。success_code 的數(shù)據(jù)類型為 int,其默認(rèn)值為 NULL。
[@on_success_action =] success_action
是該步驟成功后所要執(zhí)行的操作。success_action 的數(shù)據(jù)類型為 tinyint,其默認(rèn)值為 NULL,且可以取下列值之一。
值 | 描述(操作) |
---|---|
1 | 成功后退出 |
2 | 失敗后退出 |
3 | 轉(zhuǎn)到下一步 |
4 | 轉(zhuǎn)到步驟 success_step_id |
[@on_success_step_id =] success_step_id
是當(dāng)該步驟成功且 success_action 為 4 時(shí),所要執(zhí)行的此作業(yè)中步驟的標(biāo)識(shí)號(hào)。success_step_id 的數(shù)據(jù)類型為 int,其默認(rèn)值為 NULL。
[@on_fail_action =] fail_action
是步驟失敗后所要執(zhí)行的操作。fail_action 的數(shù)據(jù)類型為 tinyint,其默認(rèn)值為 NULL,且可取下列值之一。
值 | 描述(操作) |
---|---|
1 | 成功后退出。 |
2 | 失敗后退出。 |
3 | 轉(zhuǎn)到下一步。 |
4 | 轉(zhuǎn)到步驟 fail_step_id。 |
[@on_fail_step_id =] fail_step_id
是當(dāng)該步驟失敗且 fail_action 為 4 時(shí),所要執(zhí)行的此作業(yè)中步驟的標(biāo)識(shí)號(hào)。fail_step_id 的數(shù)據(jù)類型為 int,其默認(rèn)值為 NULL。
[@server =] 'server'
保留。server 的數(shù)據(jù)類型為 nvarchar(30),默認(rèn)值為 NULL。
[@database_name =] 'database'
是 TSQL 步驟要在其中執(zhí)行的數(shù)據(jù)庫(kù)的名稱。database 的數(shù)據(jù)類型為 sysname,其默認(rèn)值為 NULL。
[@database_user_name =] 'user'
是執(zhí)行 TSQL 步驟時(shí)所使用的用戶賬號(hào)名稱。user 的數(shù)據(jù)類型為 sysname,其默認(rèn)值為 NULL。
[@retry_attempts =] retry_attempts
是步驟失敗時(shí)要進(jìn)行的重試嘗試次數(shù)。retry_attempts 的數(shù)據(jù)類型為 int,其默認(rèn)值為 NULL。
[@retry_interval =] retry_interval
是重試嘗試之間的時(shí)間(以分鐘計(jì))。retry_interval 的數(shù)據(jù)類型為 int,其默認(rèn)值為 NULL。
[@os_run_priority =] run_priority
保留。
[@output_file_name =] 'file_name'
是保存該步驟輸出的文件的名稱。file_name 的數(shù)據(jù)類型為 nvarchar(200),其默認(rèn)值為 NULL。此參數(shù)僅對(duì) TSQL 或 CmdExec 子系統(tǒng)內(nèi)運(yùn)行的命令有效。
[@flags =] flag
控制行為的選項(xiàng)。flags 的數(shù)據(jù)類型為 int,可以是下列值之一。
值 | 描述 |
---|---|
2 | 追加到輸出文件。 |
4 | 重寫輸出文件。 |
0(默認(rèn)值) | 未設(shè)置選項(xiàng)。 |
0(成功)或 1(失?。?/P>
sp_update_jobstep 必須從 msdb 數(shù)據(jù)庫(kù)中運(yùn)行。
更新作業(yè)步驟將增加作業(yè)的版本號(hào)。
執(zhí)行權(quán)限默認(rèn)授予 public 角色。
下例將作業(yè) Archive Tables 的第 4 步的名稱更改為 Sales Detail。
USE msdb
EXEC sp_update_jobstep @job_name = 'Archive Tables', @step_id = 4,
@step_name = 'Sales Detail'
相關(guān)文章