• Статья

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'
    Последовательность символов, которая должна присутствовать в описании ошибки в журнале сообщений об ошибках. Символы-шаблоны оператора LIKE языка Transact-SQL могут использоваться. Аргумент 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