sp_help_notification (Transact-SQL)

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_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. Auflistung 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. Auflistung 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