sp_help_notification (Transact-SQL)

Artikel
12/15/2008

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

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_type ist ein Wert vom Datentyp char(9) und weist keinen Standardwert auf. 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 den Wert OPERATORS aufweist) oder ein Warnungsname (wenn object_type den Wert ALERTS aufweist). name ist vom Datentyp sysname und weist keinen Standardwert auf.

[ @enum_type =] 'enum_type'
Die object_type-Informationen, die zurückgegeben werden. enum_type hat in den meisten Fällen den Wert ACTUAL. enum_type ist ein Wert vom Datentyp char(10) und weist keinen Standardwert auf. Die folgenden Werte sind möglich.

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 bestimmt, welche Benachrichtigungsmethodenspalten zurückgegeben werden. notification_method ist ein Wert 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 zu suchender Warnungsname (wenn object_type den Wert ALERTS aufweist) oder ein zu suchender Operatorname (wenn object_type den Wert OPERATORS aufweist). target_name ist nur erforderlich, wenn enum_type den Wert TARGET aufweist. target_name ist ein Wert 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 der 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 der 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

Siehe auch

Verweis

sp_add_notification (Transact-SQL)
sp_delete_notification (Transact-SQL)
sp_update_notification (Transact-SQL)
Gespeicherte Systemprozeduren (Transact-SQL)

Hilfe und Informationen

Informationsquellen für SQL Server 2005

Freigeben über