sp_help_notification (Transact-SQL)
Выводит список предупреждений для заданного оператора или список операторов для заданного предупреждения.
Применимо для следующих объектов: SQL Server (начиная с SQL Server 2008 до текущей версии). |
.gif "Значок ссылки на раздел")
Синтаксические обозначения в Transact-SQL
Синтаксис
sp_help_notification
[ @object_type = ] 'object_type' ,
[ @name = ] 'name' ,
[ @enum_type = ] 'enum_type' ,
[ @notification_method = ] notification_method
[ , [ @target_name = ] 'target_name' ]
Аргументы
[ @object_type =] 'object_type'
Возвращаемый тип информации. Аргумент object_typeимеет тип char(9) и не имеет значения по умолчанию. Аргумент object_type может принимать значение ALERTS, перечисляя предупреждения, назначенные указанному имени оператора*,* или OPERATORS, перечисляя операторов, ответственных за указанное имя предупреждения*.*[ @name =] 'name'
Имя оператора (если аргумент object_type имеет значение OPERATORS) или имя предупреждения (если аргумент object_type имеет значение ALERTS). Аргумент name имеет тип sysname и не имеет значения по умолчанию.[ @enum_type =] 'enum_type'
Возвращаемая информация object_type. Аргумент enum_type в большинстве случаев имеет значение ACTUAL. enum_type имеет тип char(10), не имеет значения по умолчанию и может принимать одно из следующих значений:Значение
Описание
ACTUAL
Перечисляет только object_types, связанные с name.
ALL
Перечисляет все object_types, включая те, которые не связаны с name.
TARGET
Перечисляет только object_types, совпадающие с предоставленным target_name, независимо от ассоциации с name.
[ @notification_method =] notification_method
Числовое значение, которое определяет метод уведомления возвращаемых столбцов. Аргумент notification_method имеет тип tinyint и может принимать одно из следующих значений.Значение
Описание
1
Электронная почта: возвращает только столбец use_email.
2
Пейджер: возвращает только столбец use_pager.
4
NetSend: возвращает только столбец use_netsend.
7
Все: возвращает все столбцы.
[ @target_name =] 'target_name'
Имя искомого предупреждения (если аргумент object_type имеет значение ALERTS) или имя искомого оператора (если аргумент object_type имеет значение OPERATORS). target_name требуется, только если аргумент enum_type имеет значение TARGET. Аргумент target_name имеет тип sysname и значение по умолчанию NULL.
Значения кодов возврата
0 (успешное завершение) или 1 (неуспешное завершение).
Результирующие наборы
Если аргумент object_type имеет значение ALERTS, то в результирующем наборе будут перечислены все предупреждения для данного оператора.
Имя столбца |
Тип данных |
Описание |
|---|---|---|
alert_id |
int |
Идентификатор предупреждения. |
alert_name |
sysname |
Имя предупреждения. |
use_email |
int |
Уведомление оператора происходит по электронной почте. 1 = да 0 = нет |
use_pager |
int |
Уведомление оператора происходит по пейджеру. 1 = да 0 = нет |
use_netsend |
int |
Уведомление оператора происходит с помощью сетевого всплывающего окна. 1 = да 0 = нет |
has_email |
int |
Количество уведомлений, отправленных для данного предупреждения по электронной почте. |
has_pager |
int |
Количество уведомлений, отправленных для данного предупреждения по пейджеру. |
has_netsend |
int |
Количество уведомлений net send, отправленных для данного предупреждения. |
Если аргумент object_type имеет значение OPERATORS, в результирующем наборе перечислены все операторы для данного предупреждения.
Имя столбца |
Тип данных |
Описание |
|---|---|---|
operator_id |
int |
Идентификационный номер оператора. |
operator_name |
sysname |
Имя оператора. |
use_email |
int |
Уведомление оператора происходит по электронной почте. 1 = да 0 = нет |
use_pager |
int |
Уведомление оператора происходит по пейджеру. 1 = да 0 = нет |
use_netsend |
int |
Для уведомления оператора используется всплывающее сетевое сообщение. 1 = да 0 = нет |
has_email |
int |
У оператора есть адрес электронной почты. 1 = да 0 = нет |
has_pager |
int |
У оператора есть адрес пейджера. 1 = да 0 = нет |
has_netsend |
int |
Оператор имеет настроенное уведомление net send. 1 = да 0 = нет. |
Замечания
Данную хранимую процедуру нужно выполнять в базе данных msdb.
Разрешения
Для выполнения данной хранимой процедуры пользователь должен быть членом предопределенной роли сервера sysadmin.
Примеры
А.Список предупреждений для указанного оператора
В следующем примере возвращаются все предупреждения, для которых оператор François Ajenstat получает уведомления любого вида.
USE msdb ;
GO
EXEC dbo.sp_help_notification
@object_type = N'ALERTS',
@name = N'François Ajenstat',
@enum_type = N'ACTUAL',
@notification_method = 7 ;
GO
Б.Список операторов для указанного предупреждения
В следующем примере возвращаются все операторы, которые получают уведомления любого вида для предупреждения Test Alert.
USE msdb ;
GO
EXEC sp_help_notification
@object_type = N'OPERATORS',
@name = N'Test Alert',
@enum_type = N'ACTUAL',
@notification_method = 7 ;
GO
См. также
Справочник
sp_add_notification (Transact-SQL)
sp_delete_notification (Transact-SQL)