更改作業(yè)的特性。
sp_update_job [@job_id =] job_id | [@job_name =] 'job_name'
[, [@new_name =] 'new_name']
[, [@enabled =] enabled]
[, [@description =] 'description']
[, [@start_step_id =] step_id]
[, [@category_name =] 'category']
[, [@owner_login_name =] 'login']
[, [@notify_level_eventlog =] eventlog_level]
[, [@notify_level_email =] email_level]
[, [@notify_level_netsend =] netsend_level]
[, [@notify_level_page =] page_level]
[, [@notify_email_operator_name =] 'email_name']
[, [@notify_netsend_operator_name =] 'netsend_operator']
[, [@notify_page_operator_name =] 'page_operator']
[, [@delete_level =] delete_level]
[, [@automatic_post =] automatic_post]
[@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è)都指定。
[@new_name =] 'new_name'
是作業(yè)的新名稱。new_name 的數(shù)據(jù)類型為 sysname,其默認(rèn)值為 NULL。
[@enabled =] enabled
指定啟用 (1) 或不啟用 (0) 作業(yè)。enabled 的數(shù)據(jù)類型為 tinyint,其默認(rèn)值為 NULL。
[@description =] 'description'
是作業(yè)描述。description 的數(shù)據(jù)類型為 nvarchar(512),其默認(rèn)值為 NULL。
[@start_step_id =] step_id
是作業(yè)執(zhí)行的第一個(gè)步驟的標(biāo)識(shí)號(hào)。step_id 的數(shù)據(jù)類型為 int,其默認(rèn)值為 NULL。
[@category_name =] 'category'
是作業(yè)分類。category 的數(shù)據(jù)類型為 sysname,其默認(rèn)值為 NULL。
[@owner_login_name =] 'login'
是擁有該作業(yè)的登錄的名稱。login 的數(shù)據(jù)類型為 sysname,其默認(rèn)值為 NULL。只有 sysadmin 固定服務(wù)器角色的成員才能更改作業(yè)所有權(quán)。
[@notify_level_eventlog =] eventlog_level
指定何時(shí)在 Microsoft® Windows NT® 應(yīng)用程序日志中為該作業(yè)添加一項(xiàng)。eventlog_level 的數(shù)據(jù)類型為 int,其默認(rèn)值為 NULL,且可以是下列值之一。
值 | 描述(操作) |
---|---|
0 | 從不 |
1 | 成功后 |
2 | 失敗后 |
3 | 始終 |
[@notify_level_email =] email_level
指定作業(yè)完成后何種情況下應(yīng)發(fā)送電子郵件。email_level 的數(shù)據(jù)類型為 int,其默認(rèn)值為 NULL。email_level 使用與 eventlog_level 相同的值。
[@notify_level_netsend =] netsend_level
指定作業(yè)完成后何種情況下應(yīng)發(fā)送網(wǎng)絡(luò)消息。netsend_level 的數(shù)據(jù)類型為 int,其默認(rèn)值為 NULL。netsend_level 使用與 eventlog_level 相同的值。
[@notify_level_page =] page_level
指定作業(yè)完成后何種情況下應(yīng)發(fā)送呼叫。page_level 的數(shù)據(jù)類型為 int,其默認(rèn)值為 NULL。page_level 使用與 eventlog_level 相同的值。
[@notify_email_operator_name =] 'email_name'
是當(dāng)達(dá)到 email_level 時(shí)向其發(fā)送電子郵件的接收人的電子郵件名。email_name 的數(shù)據(jù)類型為 sysname,其默認(rèn)值為 NULL。
[@notify_netsend_operator_name =] 'netsend_operator'
是向其發(fā)送網(wǎng)絡(luò)消息的操作員的名稱。netsend_operator 的數(shù)據(jù)類型為 sysname,其默認(rèn)值為 NULL。
[@notify_page_operator_name =] 'page_operator'
是向其發(fā)送呼叫的操作員的名稱。page_operator 的數(shù)據(jù)類型為 sysname,其默認(rèn)值為 NULL。
[@delete_level =] delete_level
指定在何種情況下刪除作業(yè)。delete_value 的數(shù)據(jù)類型為 int,其默認(rèn)值為 NULL。delete_level 使用與 eventlog_level 相同的值。
[@automatic_post =] automatic_post
保留。
0(成功)或 1(失?。?/P>
sp_update_job 必須從 msdb 數(shù)據(jù)庫中運(yùn)行。
sp_update_job 只更改提供了參數(shù)的設(shè)置。如果省略某一參數(shù),則保留其當(dāng)前設(shè)置。
執(zhí)行權(quán)限默認(rèn)授予 public 角色。
下例更改作業(yè) Archive Tables 的名稱和描述,并禁用該作業(yè)。
USE msdb
EXEC sp_update_job @job_name = 'Archive Tables',
@new_name = 'Archive Tables - Disabled',
@description = 'Job disabled until end of project',
@enabled = 0
相關(guān)文章