sp_help_notification (Transact-SQL)

Artikel
06/18/2013

Gibt eine Liste der Warnungen für einen bestimmten Operator oder eine Liste der Operatoren für eine bestimmte Warnung zurück.

Themenlink (Symbol) Transact-SQL-Syntaxkonventionen

Syntax

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

Argumente

[ @object_type =] 'object_type'
Der Typ der Informationen, die zurückgegeben werden sollen. object_typeist vom Datentyp char(9) und hat keinen Standardwert. Mögliche Werte für object_type sind ALERTS, womit die dem angegebenen Operator zugewiesenen Warnungen aufgelistet werden*,* oder OPERATORS, womit die für die angegebene Warnung verantwortlichen Operatoren aufgelistet werden*.*
[ @name =] 'name'
Ein Operatorname (wenn object_type gleich OPERATORS ist) oder ein Warnungsname (wenn object_type gleich ALERTS ist). name ist vom Datentyp sysname und hat keinen Standardwert.

[ @enum_type =] 'enum_type'
Die object_type-Informationen, die zurückgegeben werden sollen. enum_type lautet in den meisten Fällen ACTUAL. enum_typeist vom Datentyp char(10), hat keinen Standardwert und kann folgende Werte aufweisen:

Wert	Beschreibung
ACTUAL	Listet nur die Werte für object_types auf, die name zugeordnet sind.
ALL	Listet alle Werte für object_types auf, einschließlich der Werte, die nicht name zugeordnet sind.
TARGET	Listet nur die Werte für object_types auf, die mit dem angegebenen Wert für target_name übereinstimmen, unabhängig von der Zuordnung zuname.

[ @notification_method =] notification_method
Ein numerischer Wert, der die Spalten der Benachrichtigungsmethode bestimmt, die zurückgegeben werden sollen. notification_method ist vom Datentyp tinyint. Die folgenden Werte sind möglich:

Wert	Beschreibung
1	E-Mail: Nur die use_email-Spalte wird zurückgegeben.
2	Pager: Nur die use_pager-Spalte wird zurückgegeben.
4	NetSend: Nur die use_netsend-Spalte wird zurückgegeben.
7	Alle: Alle Spalten werden zurückgegeben.

[ @target_name =] 'target_name'
Ein Warnungsname, nach dem gesucht werden soll (wenn object_type gleich ALERTS ist), oder ein Operatorname, nach dem gesucht werden soll (wenn object_type gleich OPERATORS ist). target_name wird nur benötigt, wenn enum_type gleich TARGET ist. target_name ist vom Datentyp sysname. Der Standardwert ist NULL.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Resultsets

Wenn object_type gleich ALERTS ist, werden im Resultset alle Warnungen für einen bestimmten Operator aufgelistet.

Spaltenname	Datentyp	Beschreibung
alert_id	int	ID der Warnung.
alert_name	sysname	Name der Warnung.
use_email	int	E-Mail wird zur Benachrichtigung des Operators verwendet: 1 = Ja 0 = Nein
use_pager	int	Pager wird zur Benachrichtigung des Operators verwendet: 1 = Ja 0 = Nein
use_netsend	int	Eine Netzwerk-Popupnachricht wird zur Benachrichtigung des Operators verwendet: 1 = Ja 0 = Nein
has_email	int	Anzahl von E-Mail-Benachrichtigungen, die für diese Warnung gesendet wurden.
has_pager	int	Anzahl von Pagerbenachrichtigungen, die für diese Warnung gesendet wurden.
has_netsend	int	Anzahl von net send-Benachrichtigungen, die für diese Warnung gesendet wurden.

Wenn object_type gleich OPERATORS ist, werden im Resultset alle Operatoren für eine bestimmte Warnung aufgelistet.

Spaltenname	Datentyp	Beschreibung
operator_id	int	ID des Operators.
operator_name	sysname	Name des Operators
use_email	int	E-Mail wird zum Senden der Benachrichtigung des Operators verwendet: 1 = Ja 0 = Nein
use_pager	int	Pager wird zum Senden der Benachrichtigung des Operators verwendet: 1 = Ja 0 = Nein
use_netsend	int	Eine Netzwerk-Popupnachricht wird zur Benachrichtigung des Operators verwendet: 1 = Ja 0 = Nein
has_email	int	Operator besitzt eine E-Mail-Adresse: 1 = Ja 0 = Nein
has_pager	int	Operator besitzt eine Pageradresse: 1 = Ja 0 = Nein
has_netsend	int	Für den Operator wurde eine net send-Benachrichtigung konfiguriert. 1 = Ja 0 = Nein

Hinweise

Diese gespeicherte Prozedur muss von der msdb-Datenbank aus ausgeführt werden.

Berechtigungen

Ein Benutzer muss Mitglied der festen Serverrolle sysadmin sein, um diese gespeicherte Prozedur ausführen zu können.

Beispiele

A.Auflisten von Warnungen für einen bestimmten Operator

Im folgenden Beispiel werden alle Warnungen zurückgegeben, für die der Operator François Ajenstat eine Benachrichtigung beliebigen Typs erhält.

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.Auflisten von Operatoren für eine bestimmte Warnung

Im folgenden Beispiel werden alle Operatoren zurückgegeben, die eine Benachrichtigung beliebigen Typs für die Test Alert-Warnung erhalten.

USE msdb ;
GO

EXEC sp_help_notification
    @object_type = N'OPERATORS',
    @name = N'Test Alert',
    @enum_type = N'ACTUAL',
    @notification_method = 7 ;
GO