Поделиться через


Хранимая процедура sp_update_alert (Transact-SQL)

Область применения: SQL Server

Обновляет параметры существующего предупреждения.

Соглашения о синтаксисе Transact-SQL

Синтаксис

sp_update_alert
    [ @name = ] N'name'
    [ , [ @new_name = ] N'new_name' ]
    [ , [ @enabled = ] enabled ]
    [ , [ @message_id = ] message_id ]
    [ , [ @severity = ] severity ]
    [ , [ @delay_between_responses = ] delay_between_responses ]
    [ , [ @notification_message = ] N'notification_message' ]
    [ , [ @include_event_description_in = ] include_event_description_in ]
    [ , [ @database_name = ] N'database_name' ]
    [ , [ @event_description_keyword = ] N'event_description_keyword' ]
    [ , [ @job_id = ] 'job_id' ]
    [ , [ @job_name = ] N'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 = ] N'performance_condition' ]
    [ , [ @category_name = ] N'category_name' ]
    [ , [ @wmi_namespace = ] N'wmi_namespace' ]
    [ , [ @wmi_query = ] N'wmi_query' ]
[ ; ]

Аргументы

[ @name = ] N'name'

Имя обновляемого предупреждения. @name — sysname без значения по умолчанию.

[ @new_name = ] N'new_name'

Новое имя предупреждения. Имя должно быть уникальным. @new_name — sysname с значением по умолчаниюNULL.

[ @enabled = ] включен

Указывает, включена ли оповещение (1) или не включена (0). @enabled крошечный, с значением по умолчаниюNULL. Сработать может только активированное предупреждение.

[ @message_id = ] message_id

Новое сообщение или номер ошибки, определяющие предупреждение. Как правило, message_id соответствует номеру ошибки в таблице sysmessages . @message_id имеет значение int с значением по умолчаниюNULL. Идентификатор сообщения можно использовать только в том случае, если для оповещения задан 0уровень серьезности.

[ @severity = ] серьезность

Новый уровень серьезности (начиная с 1 25) для определения оповещения. Любое сообщение SQL Server, отправленное в журнал приложений Windows с указанным уровнем серьезности, активирует оповещение. @severity имеет значение int с значением по умолчаниюNULL. Уровень серьезности можно использовать только в том случае, если для оповещения задан 0параметр идентификатора сообщения.

[ @delay_between_responses = ] delay_between_responses

Новый период ожидания (в секундах) между ответами на предупреждение. @delay_between_responses имеет значение int с значением по умолчаниюNULL.

[ @notification_message = ] N'notification_message'

Измененный текст дополнительного сообщения, отправленного оператору в рамках уведомления электронной почты, net send или pager. @notification_message имеет значение nvarchar(512) с значением по умолчаниюNULL.

[ @include_event_description_in = ] include_event_description_in

Указывает, следует ли включить описание ошибки SQL Server из журнала приложений Windows в сообщение уведомления. @include_event_description_in крошечный и может быть одним или несколькими из этих значений.

значение Описание
0 Нет
1 Эл. почта
2 Пейджер
4 net send
7 Все

[ @database_name = ] N'database_name'

Имя базы данных, в которой должна произойти ошибка, для которой срабатывает предупреждение. @database_name — sysname с значением по умолчаниюNULL. Имена, заключенные в квадратные скобки ([]) не допускаются.

[ @event_description_keyword = ] N'event_description_keyword'

Последовательность символов, которые должны находиться в описании ошибки SQL Server в журнале сообщений об ошибке. @event_description_keyword — nvarchar(100) с значением по умолчаниюNULL. Этот параметр полезен для фильтрации имен объектов (например, customer_table).

Примечание.

Символы сопоставления шаблонов выражений Transact-SQL LIKE нельзя использовать.

[ @job_id = ] 'job_id'

@job_id является уникальным идентификатором по умолчаниюNULL.

[ @job_name = ] N'job_name'

Идентификационный номер задания. @job_name — sysname с значением по умолчаниюNULL. Если указан job_id , job_name должны быть опущены.

[ @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 = ] N'performance_condition'

Значение, выраженное в формате <itemcomparatorvalue>. @performance_condition — nvarchar(512) и состоит из следующих элементов.

Элемент формата Description
Элемент Объект производительности, счетчик производительности или именованный экземпляр счетчика.
Компаратор Один из следующих операторов: >, <=
Value Числовое значение счетчика

[ @category_name = ] N'category_name'

Имя категории предупреждения. @category_name — sysname с значением по умолчаниюNULL.

[ @wmi_namespace = ] N'wmi_namespace'

Пространство имен WMI для запроса событий. @wmi_namespace — sysname с значением по умолчаниюNULL.

[ @wmi_query = ] N'wmi_query'

Запрос, указывающий событие WMI для предупреждения. @wmi_query — nvarchar(512) с значением по умолчаниюNULL.

Значения кода возврата

0 (успешно) или 1 (сбой).

Замечания

Только sysmessages запись в журнал приложений Windows может запустить оповещение.

sp_update_alert изменяет только те параметры генерации оповещений, для которых предоставляются значения параметров. Если параметр пропущен, сохраняется текущая настройка.

Разрешения

Чтобы запустить эту хранимую процедуру, пользователи должны быть членом предопределенных ролей сервера sysadmin .

Примеры

В следующем примере значение параметра активирования предупреждения Test Alert меняется на 0.

USE msdb;
GO

EXEC dbo.sp_update_alert
    @name = N'Test Alert',
    @enabled = 0;
GO