sp_update_alert (T-SQL)

  • Artikel

Berlaku untuk:SQL Server

Memperbarui pengaturan pemberitahuan yang sudah ada.

Konvensi sintaks transact-SQL

Sintaks

sp_update_alert
    [ @name = ] N'name'
    [ , [ @new_name = ] N'new_name' ]
    [ , [ @enabled = ] enabled ]
    [ , [ @message_id = ] message_id ]
    [ , [ @severity = ] severity ]
    [ , [ @delay_between_responses = ] delay_between_responses ]
    [ , [ @notification_message = ] N'notification_message' ]
    [ , [ @include_event_description_in = ] include_event_description_in ]
    [ , [ @database_name = ] N'database_name' ]
    [ , [ @event_description_keyword = ] N'event_description_keyword' ]
    [ , [ @job_id = ] 'job_id' ]
    [ , [ @job_name = ] N'job_name' ]
    [ , [ @occurrence_count = ] occurrence_count ]
    [ , [ @count_reset_date = ] count_reset_date ]
    [ , [ @count_reset_time = ] count_reset_time ]
    [ , [ @last_occurrence_date = ] last_occurrence_date ]
    [ , [ @last_occurrence_time = ] last_occurrence_time ]
    [ , [ @last_response_date = ] last_response_date ]
    [ , [ @last_response_time = ] last_response_time ]
    [ , [ @raise_snmp_trap = ] raise_snmp_trap ]
    [ , [ @performance_condition = ] N'performance_condition' ]
    [ , [ @category_name = ] N'category_name' ]
    [ , [ @wmi_namespace = ] N'wmi_namespace' ]
    [ , [ @wmi_query = ] N'wmi_query' ]
[ ; ]

Argumen

[ @name = ] N'name'

Nama pemberitahuan yang akan diperbarui. @name adalah sysname, tanpa default.

[ @new_name = ] N'new_name'

Nama baru untuk pemberitahuan. Nama harus unik. @new_name adalah sysname, dengan default NULL.

[ @enabled = ] diaktifkan

Menentukan apakah pemberitahuan diaktifkan (1) atau tidak diaktifkan (0). @enabled kecil, dengan default NULL. Pemberitahuan harus diaktifkan untuk diaktifkan.

[ @message_id = ] message_id

Pesan baru atau nomor kesalahan untuk definisi pemberitahuan. Biasanya, message_id sesuai dengan nomor kesalahan dalam tabel sysmessages . @message_id int, dengan default NULL. ID pesan hanya dapat digunakan jika pengaturan tingkat keparahan untuk pemberitahuan adalah 0.

[ @severity = ] tingkat keparahan

Tingkat keparahan baru (dari 1 melalui 25) untuk definisi pemberitahuan. Setiap pesan SQL Server yang dikirim ke log aplikasi Windows dengan tingkat keparahan yang ditentukan mengaktifkan pemberitahuan. @severity int, dengan default NULL. Tingkat keparahan hanya dapat digunakan jika pengaturan ID pesan untuk pemberitahuan adalah 0.

[ @delay_between_responses = ] delay_between_responses

Periode tunggu baru, dalam detik, antara respons terhadap pemberitahuan. @delay_between_responses int, dengan default NULL.

[ @notification_message = ] N'notification_message'

Teks yang direvisi dari pesan tambahan yang dikirim ke operator sebagai bagian dari pemberitahuan email, kirim bersih, atau pager. @notification_message adalah nvarchar(512), dengan default NULL.

[ @include_event_description_in = ] include_event_description_in

Menentukan apakah deskripsi kesalahan SQL Server dari log aplikasi Windows harus disertakan dalam pesan pemberitahuan. @include_event_description_in kecil, dan bisa menjadi satu atau beberapa nilai ini.

Nilai Deskripsi
0 Tidak
1 Email
2 Penyeranta
4 net send
7 Semua

[ @database_name = ] N'database_name'

Nama database tempat kesalahan harus terjadi agar pemberitahuan diaktifkan. @database_name adalah sysname, dengan default NULL. Nama yang diapit dalam tanda kurung siku ([]) tidak diizinkan.

[ @event_description_keyword = ] N'event_description_keyword'

Urutan karakter yang harus ditemukan dalam deskripsi kesalahan SQL Server di log pesan kesalahan. @event_description_keyword adalah nvarchar(100), dengan default NULL. Parameter ini berguna untuk memfilter nama objek (misalnya, customer_table).

Catatan

Karakter pencocokan pola ekspresi Transact-SQL LIKE tidak dapat digunakan.

[ @job_id = ] 'job_id'

@job_id adalah uniqueidentifier, dengan default NULL.

[ @job_name = ] N'job_name'

Nomor identifikasi pekerjaan. @job_name adalah sysname, dengan default NULL. Jika job_id ditentukan, job_name harus dihilangkan.

[ @occurrence_count = ] occurrence_count

Mengatur ulang berapa kali pemberitahuan telah terjadi. @occurrence_count int, dengan default NULL, dan hanya dapat diatur ke 0.

[ @count_reset_date = ] count_reset_date

Mengatur ulang tanggal jumlah kemunculan terakhir kali diatur ulang. @count_reset_date int, dengan default NULL.

[ @count_reset_time = ] count_reset_time

Mengatur ulang waktu jumlah kemunculan terakhir kali diatur ulang. @count_reset_time int, dengan default NULL.

[ @last_occurrence_date = ] last_occurrence_date

Mengatur ulang tanggal pemberitahuan terakhir terjadi. @last_occurrence_date int, dengan default NULL, dan hanya dapat diatur ke 0.

[ @last_occurrence_time = ] last_occurrence_time

Mengatur ulang waktu pemberitahuan terakhir kali terjadi. @last_occurrence_time int, dengan default NULLdan hanya dapat diatur ke 0.

[ @last_response_date = ] last_response_date

Mengatur ulang tanggal pemberitahuan terakhir kali direspons oleh layanan SQLServerAgent. @last_response_date int, dengan default NULL, dan hanya dapat diatur ke 0.

[ @last_response_time = ] last_response_time

Mengatur ulang waktu pemberitahuan terakhir kali direspons oleh layanan SQLServerAgent. @last_response_time int, dengan default NULL, dan hanya dapat diatur ke 0.

[ @raise_snmp_trap = ] raise_snmp_trap

Diidentifikasi hanya untuk tujuan informasi. Tidak didukung. Kompatibilitas di masa mendatang tidak dijamin.

[ @performance_condition = ] N'performance_condition'

Nilai yang dinyatakan dalam format <itemcomparatorvalue>. @performance_condition adalah nvarchar(512), dan terdiri dari elemen-elemen berikut.

Elemen format Deskripsi
Benda Objek performa, penghitung kinerja, atau instans penghitung bernama
Komparator Salah satu operator ini: >, , <=
Nilai Nilai numerik penghitung

[ @category_name = ] N'category_name'

Nama kategori pemberitahuan. @category_name adalah sysname, dengan default NULL.

[ @wmi_namespace = ] N'wmi_namespace'

Namespace layanan WMI yang akan dikueri untuk peristiwa. @wmi_namespace adalah sysname, dengan default NULL.

[ @wmi_query = ] N'wmi_query'

Kueri yang menentukan peristiwa WMI untuk pemberitahuan. @wmi_query adalah nvarchar(512), dengan default NULL.

Mengembalikan nilai kode

0 (berhasil) atau 1 (kegagalan).

Keterangan

Hanya sysmessages ditulis ke log aplikasi Windows yang dapat mengaktifkan pemberitahuan.

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

Izin

Untuk menjalankan prosedur tersimpan ini, pengguna harus menjadi anggota peran server tetap sysadmin .

Contoh

Contoh berikut mengubah pengaturan yang diaktifkan menjadi Test Alert0.

USE msdb;
GO

EXEC dbo.sp_update_alert
    @name = N'Test Alert',
    @enabled = 0;
GO

Konten terkait