sp_help_notification (Transact-SQL)

Article
05/23/2023

S’applique à :SQL Server

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

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 char(9), sans valeur par défaut. object_type peut être ALERTS, qui répertorie les alertes attribuées au nom de l’opérateur fourni*,* ou OPERATORS, qui répertorie les opérateurs responsables du nom d’alerte fourni**.*

[ @name = ] 'name' Un nom d’opérateur (si object_type est OPERATORS) ou un nom d’alerte (si object_type est ALERTS). name est sysname, sans valeur par défaut.

[ @enum_type = ] 'enum_type' Le object_typeinformations retournées. enum_type est RÉEL dans la plupart des cas. enum_typeest char(10), sans valeur par défaut, et peut être l’une de ces valeurs.

Valeur	Description
ACTUAL	Répertorie uniquement les object_types associées au nom.
ALL	Répertorie tous lesobject_types y compris ceux qui ne sont pas associés au nom.
TARGET	Répertorie uniquement les object_types correspondant au target_name fourni, quelle que soit l’association avecle nom.

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

Valeur	Description
1	Courrier électronique : retourne uniquement la colonne use_email .
2	Pagineur : retourne uniquement la colonne use_pager .
4	NetSend : 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 est nécessaire uniquement si enum_type est TARGET. target_name est sysname, avec la valeur NULL par défaut.

Valeur des codes de retour

0 (réussite) ou 1 (échec)

Jeux de résultats

Si object_type est ALERTS, le jeu de résultats répertorie toutes les alertes pour un opérateur donné.

Nom de la 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 d’envoi net envoyées pour cette alerte.

Si object_type est OPERATORS, le jeu de résultats répertorie tous les opérateurs d’une alerte donnée.

Nom de la 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	Une fenêtre contextuelle réseau est-elle utilisée pour notifier 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

Remarques

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

R. 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

Voir aussi

sp_add_notification (Transact-SQL)
sp_delete_notification (Transact-SQL)
sp_update_notification (Transact-SQL)
Procédures stockées système (Transact-SQL)