sp_help_notification (Transact-SQL)

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 rubriqueConventions 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. L'argument object_typeest de type char(9), sans valeur par défaut. L'argument 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. L'argument enum_type est 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 les object_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 avec name.

  • [ @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

    Courrier é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

    Toutes : 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