• 發行項

sp_update_alert (Transact-SQL)

更新現有警示的設定。

主題連結圖示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'] 
     [ , [ @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 應用程式記錄檔且含有指定嚴重性的 MicrosoftSQL 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'
    錯誤必須發生在其中，才會引發警示的資料庫名稱。database 是 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