• Статья

sp_help_notification (Transact-SQL)

Выводит список предупреждений для заданного оператора или список операторов для заданного предупреждения.

Значок ссылки на разделСоглашения о синтаксическом обозначении в 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.

Примеры

А. Список предупреждений для указанного оператора

В следующем примере возвращаются все предупреждения, для которых оператор Francois 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