通过

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 时，才能使用消息 ID。

  • [ @severity =] severity
    警报定义的新严重级别（从 1 到 25）。 如果发送到 Windows 应用程序日志的任何 Microsoft SQL Server 消息具有指定的严重级别，则会激活警报。 severity 的数据类型为 int，默认值为 NULL。 仅当警报的消息 ID 设置为 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

请参阅

参考

sp_add_alert (Transact-SQL)

sp_help_alert (Transact-SQL)

系统存储过程 (Transact-SQL)