sp_update_job (SQL Bertransaksi)

Berlaku untuk: SQL Server (semua versi yang didukung)

Mengubah atribut pekerjaan.

Konvensi Sintaksis T-SQL

Sintaks

  
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 =] 'operator_name' ]  
     [, [@notify_netsend_operator_name =] 'netsend_operator' ]  
     [, [@notify_page_operator_name =] 'page_operator' ]  
     [, [@delete_level =] delete_level ]   
     [, [@automatic_post =] automatic_post ]  

Argumen

[ @job_id = ] job_id Nomor identifikasi pekerjaan yang akan diperbarui. job_id adalah pengidentifikasi unik.

[ @job_name = ] 'job_name' Nama pekerjaan. job_name adalah nvarchar(128).

CATATAN: Baik job_id atau job_name harus ditentukan tetapi keduanya tidak dapat ditentukan.

[ @new_name = ] 'new_name' Nama baru untuk pekerjaan tersebut. new_name adalah nvarchar(128).

[ @enabled = ] enabled Menentukan apakah pekerjaan diaktifkan (1) atau tidak diaktifkan (0). diaktifkan adalah tinyint.

[ @description = ] 'description' Deskripsi pekerjaan. deskripsi adalah nvarchar(512).

[ @start_step_id = ] step_id Nomor identifikasi langkah pertama yang dijalankan untuk pekerjaan tersebut. step_idint.

[ @category_name = ] 'category' Kategori pekerjaan. kategori adalah nvarchar(128).

[ @owner_login_name = ] 'login' Nama login yang memiliki pekerjaan. login adalah nvarchar(128) Hanya anggota peran server tetap sysadmin yang dapat mengubah kepemilikan pekerjaan.

[ @notify_level_eventlog = ] eventlog_levelMenentukan kapan harus menempatkan entri di log aplikasi Microsoft Windows untuk pekerjaan ini. eventlog_leveladalah int, dan bisa menjadi salah satu nilai ini.

Nilai	Deskripsi (tindakan)
0	Tidak pernah
1	Pada keberhasilan
2	Saat gagal
3	Selalu

[ @notify_level_email = ] email_level Menentukan kapan harus mengirim email setelah pekerjaan ini selesai. email_leveladalah int. email_level gunakan nilai yang sama dengan eventlog_level.

[ @notify_level_netsend = ] netsend_level Menentukan kapan harus mengirim pesan jaringan setelah pekerjaan ini selesai. netsend_leveladalah int. netsend_level gunakan nilai yang sama dengan eventlog_level.

[ @notify_level_page = ] page_level Menentukan kapan harus mengirim halaman setelah penyelesaian pekerjaan ini. page_leveladalah int. page_level gunakan nilai yang sama dengan eventlog_level.

[ @notify_email_operator_name = ] 'operator_name' Nama operator tempat email dikirim ketika email_level tercapai. email_name adalah nvarchar(128).

[ @notify_netsend_operator_name = ] 'netsend_operator' Nama operator yang dikirimi pesan jaringan. netsend_operator adalah nvarchar(128).

[ @notify_page_operator_name = ] 'page_operator' Nama operator yang dikirimi halaman. page_operator adalah nvarchar(128).

[ @delete_level = ] delete_level Menentukan kapan harus menghapus pekerjaan. delete_valueadalah int. delete_level gunakan nilai yang sama dengan eventlog_level.

[ @automatic_post = ] automatic_post Dipesan.

Mengembalikan Nilai Kode

0 (berhasil) atau 1 (kegagalan)

Keterangan

sp_update_job harus dijalankan dari database msdb .

sp_update_job hanya mengubah pengaturan yang nilai parameternya disediakan. Jika parameter dihilangkan, pengaturan saat ini dipertahankan.

Izin

Secara default, anggota peran server tetap sysadmin dapat menjalankan prosedur tersimpan ini. Pengguna lain harus diberikan salah satu peran database tetap SQL Server Agent berikut dalam database msdb:

• SQLAgentUserRole

• SQLAgentReaderRole

• SQLAgentOperatorRole

Untuk detail tentang izin peran ini, lihat SQL Server Agent Peran Database Tetap.

Hanya anggota sysadmin yang dapat menggunakan prosedur tersimpan ini untuk mengedit atribut pekerjaan yang dimiliki oleh pengguna lain.

Contoh

Contoh berikut mengubah nama, deskripsi, dan status pekerjaan NightlyBackupsyang diaktifkan.

USE msdb ;  
GO  
  
EXEC dbo.sp_update_job  
    @job_name = N'NightlyBackups',  
    @new_name = N'NightlyBackups -- Disabled',  
    @description = N'Nightly backups disabled during server migration.',  
    @enabled = 0 ;  
GO  

Lihat juga

sp_add_job (SQL Bertransaksi)
sp_delete_job (SQL Bertransaksi)
sp_help_job (SQL Bertransaksi)
Prosedur Tersimpan Sistem (SQL Transaksi)