sp_help_notification (Transact-SQL)

Article
08/19/2013

Fournit une liste d'alertes pour un opérateur donné ou une liste d'opérateurs pour une alerte donnée.

Icône Lien de rubrique Conventions de la syntaxe de Transact-SQL

Syntaxe

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

Arguments

[ @object_type =] 'object_type'
Type d'informations à retourner. object_typeest de type char(9) et n'a pas de valeur par défaut. object_type peut prendre la valeur ALERTS, qui affiche la liste des alertes assignées au nom d'opérateur fourni*,* ou OPERATORS, qui affiche la liste des opérateurs responsables du nom d'alerte fourni*.*
[ @name =] 'name'
Nom d'opérateur (si object_type est OPERATORS) ou nom d'alerte (si object_type est ALERTS). name est de type sysname et n'a pas de valeur par défaut.

[ @enum_type =] 'enum_type'
Informations retournées sur object_type. enum_type prend la valeur ACTUAL dans la plupart des cas. enum_typeest de type char(10), sans valeur par défaut, et peut avoir l'une des valeurs suivantes.

Valeur	Description
ACTUAL	Répertorie uniquement les object_types associés à name.
ALL	Répertorie tous lesobject_types, y compris ceux qui ne sont pas associés à name.
TARGET	Répertorie uniquement les object_types qui correspondent au target_name fourni, quelle que soit l'association avecname.

[ @notification_method =] notification_method
Valeur numérique qui détermine les colonnes de méthode de notification à retourner. notification_method est de type tinyint et peut prendre l'une des valeurs suivantes.

Valeur	Description
1	Messagerie électronique : retourne uniquement la colonne use_email.
2	Radiomessagerie : retourne uniquement la colonne use_pager.
4	Envoi réseau : retourne uniquement la colonne use_netsend.
7	Tout : retourne toutes les colonnes.

[ @target_name =] 'target_name'
Nom d'alerte à rechercher (si object_type est ALERTS) ou nom d'opérateur à rechercher (si object_type est OPERATORS). target_name n'est nécessaire que si enum_type a la valeur TARGET. target_name est de type sysname, avec NULL comme valeur par défaut.

Valeur des codes de retour

0 (succès) ou 1 (échec)

Ensembles de résultats

Si object_type est ALERTS, l'ensemble de résultats répertorie toutes les alertes concernant un opérateur donné.

Nom de colonne	Type de données	Description
alert_id	int	Numéro d'identification de l'alerte.
alert_name	sysname	Nom de l'alerte.
use_email	int	Un message électronique est utilisé pour avertir l'opérateur. 1 = Oui 0 = Non
use_pager	int	La radiomessagerie est utilisée pour avertir l'opérateur. 1 = Oui 0 = Non
use_netsend	int	Le réseau est utilisé pour avertir l'opérateur : 1 = Oui 0 = Non
has_email	int	Nombre de notifications envoyées par messagerie électronique pour cette alerte.
has_pager	int	Nombre de notifications envoyées par radiomessagerie pour cette alerte.
has_netsend	int	Nombre de notifications net send envoyées pour cette alerte.

Si object_type a la valeur OPERATORS, l'ensemble de résultats répertorie tous les opérateurs concernés par une alerte donnée.

Nom de colonne	Type de données	Description
operator_id	int	Numéro d'identification de l'opérateur.
operator_name	sysname	Nom de l'opérateur.
use_email	int	Un message électronique est utilisé pour envoyer la notification à l'opérateur : 1 = Oui 0 = Non
use_pager	int	La radiomessagerie est utilisée pour envoyer la notification à l'opérateur : 1 = Oui 0 = Non
use_netsend	int	Le réseau est utilisé pour avertir l'opérateur : 1 = Oui 0 = Non
has_email	int	L'opérateur possède une adresse électronique : 1 = Oui 0 = Non
has_pager	int	L'opérateur possède une adresse de radiomessagerie : 1 = Oui 0 = Non
has_netsend	int	Une notification d'envoi réseau est configurée pour l'opérateur. 1 = Oui 0 = Non

Notes

Cette procédure stockée doit être exécutée à partir de la base de données msdb.

Autorisations

Pour exécuter cette procédure stockée, l'utilisateur doit être membre du rôle de serveur fixe sysadmin.

Exemples

A.Affichage d'une liste d'alertes pour un opérateur spécifique

L'exemple suivant retourne toutes les alertes dont l'opérateur François Ajenstat est notifié.

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.Affichage d'une liste d'opérateurs pour une alerte spécifique

L'exemple suivant retourne tous les opérateurs qui reçoivent une notification quelconque pour l'alerte 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