Хранимая процедура 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) для определения предупреждения. Любое сообщение Microsoft SQL Server, переданное в журнал приложений Windows с заданным уровнем серьезности, будет активировать предупреждение. Аргумент 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
    Указывает, следует ли включить в текст сообщения уведомления описание ошибки SQL Server из журнала приложений Windows. Аргумент 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 (неуспешное завершение)

Замечания

Только ошибки типа sysmessages, записанные в журнал приложений Microsoft Windows, могут активировать предупреждения.

Хранимая процедура 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)