Artículo
09/29/2010

sp_help_notification (Transact-SQL)

Presenta una lista de alertas de un operador dado o una lista de operadores para una alerta dada.

Icono de vínculo a temas Convenciones de sintaxis de Transact-SQL

Sintaxis

sp_help_notification
     [ @object_type = ] 'object_type' ,
     [ @name = ] 'name' ,
     [ @enum_type = ] 'enum_type' , 
     [ @notification_method = ] notification_method 
     [ , [ @target_name = ] 'target_name' ]

Argumentos

[ @object_type =] 'object_type'
Tipo de información que se va a devolver. object_typees de tipo char(9) y no tiene ningún valor predeterminado. object_type puede ser ALERTS, que presenta las alertas asignadas al nombre del operador especificado, u OPERATORS, que presenta los operadores responsables del nombre de alerta especificado.
[ @name = ] 'name'
Un nombre de operador (si object_type es OPERATORS) o un nombre de alerta (si object_type es ALERTS). name es de tipo sysname y no tiene valor predeterminado.

[ @enum_type =] 'enum_type'
Información de object_typeque se devuelve. En la mayoría de los casos, enum_type es ACTUAL. enum_typees de tipo char(10), no tiene ningún valor predeterminado y puede tener uno de los valores siguientes.

Valor	Descripción
ACTUAL	Presenta solamente los object_types (tipos de objetos) asociados a name.
ALL	Presenta todos losobject_types, incluidos los que no están asociados a name.
TARGET	Presenta sólo los object_types que coinciden con el valor de target_name indicado, independientemente de la asociación aname.

[ @notification_method =] notification_method
Valor numérico que determina las columnas del método de notificación que se van a devolver. notification_method es de tipo tinyint y puede tener uno de los siguientes valores.

Valor	Descripción
1	Correo electrónico: devuelve solamente la columna use_email.
2	Localizador: devuelve solamente la columna use_pager.
4	NetSend: devuelve solamente la columna use_netsend.
7	Todas: devuelve todas las columnas.

[ @target_name =] 'target_name'
Nombre de la alerta que se va a buscar (si object_type es ALERTS) o nombre del operador que se va a buscar (si object_type es OPERATORS). target_name sólo es necesario si enum_type es TARGET. target_name es de tipo sysname y su valor predeterminado es NULL.

Valores de código de retorno

0 (correcto) o 1 (error)

Conjuntos de resultados

Si object_type es ALERTS, el conjunto de resultados presenta todas las alertas de un determinado operador.

Nombre de columna	Tipo de datos	Descripción
alert_id	int	Número de identificador de la alerta.
alert_name	sysname	Nombre de la alerta.
use_email	int	Se utiliza el correo electrónico para notificar al operador: 1 = Sí 0 = No
use_pager	int	Se utiliza un localizador para notificar al operador: 1 = Sí 0 = No
use_netsend	int	Se utiliza un mensaje de red para notificar al operador: 1 = Sí 0 = No
has_email	int	Número de notificaciones por correo electrónico enviadas para esta alerta.
has_pager	int	Número de notificaciones por localizador enviadas para esta alerta.
has_netsend	int	Número de notificaciones net send enviadas para esta alerta.

Si object_type es OPERATORS, el conjunto de resultados presenta todos los operadores de una alerta dada.

Nombre de columna	Tipo de datos	Descripción
operator_id	int	Número de identificación del operador.
operator_name	sysname	Nombre del operador.
use_email	int	Para enviar la notificación al operador se utiliza el correo electrónico: 1 = Sí 0 = No
use_pager	int	Para enviar la notificación al operador se utiliza un localizador: 1 = Sí 0 = No
use_netsend	int	Para enviar la notificación al operador se utiliza un mensaje de red: 1 = Sí 0 = No
has_email	int	El operador tiene una dirección de correo electrónico: 1 = Sí 0 = No
has_pager	int	El operador tiene una dirección de localizador: 1 = Sí 0 = No
has_netsend	int	El operador tiene configurada la notificación mediante net send. 1 = Sí 0 = No

Notas

Este procedimiento almacenado se tiene que ejecutar en la base de datos msdb.

Permisos

Para ejecutar este procedimiento almacenado, un usuario debe ser miembro de la función fija de servidor sysadmin.

Ejemplos

A. Presentar las alertas de un operador específico

En el ejemplo siguiente se devuelven todas las alertas para las que el operador François Ajenstat recibe algún tipo de notificación.

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

B. Presentar los operadores de una alerta específica

En el ejemplo siguiente se devuelven todos los operadores que reciben algún tipo de notificación de la alerta 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