sp_update_alert (Transact-SQL)
更新現有警示的設定。
語法
sp_update_alert
[ @name =] 'name'
[ , [ @new_name =] 'new_name']
[ , [ @enabled =] enabled]
[ , [ @message_id =] message_id]
[ , [ @severity =] severity]
[ , [ @delay_between_responses =] delay_between_responses]
[ , [ @notification_message =] 'notification_message']
[ , [ @include_event_description_in =] include_event_description_in]
[ , [ @database_name =] 'database_name']
[ , [ @event_description_keyword =] 'event_description_keyword']
[ , [ @job_id =] job_id | [@job_name =] '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 =] 'performance_condition' ]
[ , [ @category_name =] 'category']
[ , [ @wmi_namespace = ] 'wmi_namespace' ]
[ , [ @wmi_query = ] 'wmi_query' ]
引數
- [ @name =] 'name'
要更新的警示名稱。name 是 sysname,沒有預設值。
- [ @new_name =] 'new_name'
警示的新名稱。這個名稱必須是唯一的。new_name 是 sysname,預設值是 NULL。
- [ @enabled =] enabled
指定啟用警示 (1) 或不啟用警示 (0)。enabled 是 tinyint,預設值是 NULL。您必須啟用警示,才能引發警示。
- [ @message_id =] message_id
警示定義的新訊息或錯誤號碼。message_id 通常對應於 sysmessages 資料表中的錯誤號碼。message_id 是 int,預設值是 NULL。只有在警示的嚴重性層級設定值是 0 時,才能使用訊息識別碼。
- [ @severity =] severity
警示定義的新嚴重性層級 (1 至 25)。任何傳送給 Windows 應用程式記錄檔且含有指定嚴重性的 Microsoft SQL Server 訊息都會啟動警示。severity 是 int,預設值是 NULL。只有在警示的訊息識別碼設定值是 0 時,才能使用嚴重性層級。
- [ @delay_between_responses =] delay_between_responses
這個警示各次回應之間的新等待期間 (以秒為單位)。delay_between_responses 是 int,預設值是 NULL。
- [ @notification_message =] 'notification_message'
附加在電子郵件、net send 或呼叫器通知之中,傳給操作員之附加訊息的修訂文字。notification_message 是 nvarchar(512),預設值是 NULL。
[ @include_event_description_in =] include_event_description_in
指定是否應該將 Windows 應用程式記錄檔的 SQL Server 錯誤描述併入通知訊息中。include_event_description_in 是 tinyint,預設值是 NULL,它可以是下列中的一或多個值。值 描述 0
無
1
電子郵件
2
呼叫器
4
net send
7
全部
- [ @database_name =] 'database_name'
錯誤必須發生在其中,才會引發警示的資料庫名稱。database_name 是 sysname,預設值是 NULL。
- [ @event_description_keyword = ] 'event_description_keyword'
必須在錯誤訊息記錄的錯誤描述中找到的字元序列。您可以使用 Transact-SQL LIKE 運算式模式來比對字元。event_description_keyword 是 nvarchar(100),預設值是 NULL。在篩選物件名稱時,這個參數很有用 (如 %customer_table%)。
- [ @job_id =] job_id
作業識別碼。job_id 是 uniqueidentifier,預設值是 NULL。如果指定 job_id,就必須省略 job_name。
- [ @job_name =] 'job_name'
當回應這個警示時,所執行的作業名稱。job_name 是 sysname,預設值是 NULL。如果指定 job_name,就必須省略 job_id。
- [ @occurrence_count = ] occurrence_count
重設警示的發生次數。occurrence_count 是 int,預設值是 NULL,它只能設為 0。
- [ @count_reset_date =] count_reset_date
重設前次重設出現計數的日期。count_reset_date 是 int,預設值是 NULL。
- [ @count_reset_time =] count_reset_time
重設前次重設出現計數的時間。count_reset_time 是 int,預設值是 NULL。
- [ @last_occurrence_date =] last_occurrence_date
重設警示上次發生的日期。last_occurrence_date 是 int,預設值是 NULL,它只能設為 0。
- [ @last_occurrence_time =] last_occurrence_time
重設警示上次發生的時間。last_occurrence_time 是 int,預設值是 NULL,它只能設為 0。
- [ @last_response_date =] last_response_date
重設 SQLServerAgent 服務上次回應警示的日期。last_response_date 是 int,預設值是 NULL,它只能設為 0。
- [ @last_response_time =] last_response_time
重設 SQLServerAgent 服務上次回應警示的時間。last_response_time 是 int,預設值是 NULL,它只能設為 0。
- [ @raise_snmp_trap = ] raise_snmp_trap
已保留。
[ @performance_condition = ] 'performance_condition'
這是用 'itemcomparatorvalue' 格式來表示的值。performance_condition 是 nvarchar(512),預設值是 NULL,由這些元素組成。格式元素 描述 Item
計數器的效能物件、效能計數器或具名執行個體
Comparator
它是下列運算子之一:>、<、=
Value
計數器的數值
- [ @category_name =] 'category'
警示類別目錄的名稱。category 是 sysname,預設值是 NULL。
- [ @wmi_namespace= ] 'wmi_namespace'
要查詢事件的 WMI 命名空間。wmi_namespace 是 sysname,預設值是 NULL。
- [ @wmi_query= ] 'wmi_query'
指定警示之 WMI 事件的查詢。wmi_query 是 nvarchar(512),預設值是 NULL。
傳回碼值
0 (成功) 或 1 (失敗)
備註
只有寫入 Microsoft Windows 應用程式記錄檔的 sysmessages 能夠引發警示。
sp_update_alert 只會變更提供了參數值的警示設定。如果省略某個參數,就會保留目前的設定。
權限
若要執行這個預存程序,使用者必須是系統管理員 (sysadmin) 固定伺服器角色的成員。
範例
下列範例會將 Test Alert
已啟用的設定值改成 0
。
USE msdb ;
GO
EXEC dbo.sp_update_alert
@name = N'Test Alert',
@enabled = 0 ;
GO
請參閱
參考
sp_add_alert (Transact-SQL)
sp_help_alert (Transact-SQL)
系統預存程序 (Transact-SQL)