sp_help_alert (Transact-SQL)

  • Artikel

Gilt für:SQL Server

Gibt Informationen zu den für einen Server definierten Warnungen zurück.

Transact-SQL-Syntaxkonventionen

Syntax

sp_help_alert [ [ @alert_name = ] N'alert_name' ]
    [ , [ @order_by = ] N'order_by' ]
    [ , [ @alert_id = ] alert_id ]
    [ , [ @category_name = ] N'category_name' ]
    [ , [ @legacy_format = ] legacy_format ]
[ ; ]

Argumente

[ @alert_name = ] N'alert_name'

Der Name der Warnung. @alert_name ist nvarchar(128). Wenn @alert_name nicht angegeben ist, werden Informationen zu allen Warnungen zurückgegeben.

[ @order_by = ] N'order_by'

Die Sortierreihenfolge, die zum Erzeugen der Ergebnisse verwendet werden soll. @order_by ist "sysname" mit einem Standardwert des @alert_name.

[ @alert_id = ] alert_id

Die ID der Warnung, zu der Informationen gemeldet werden sollen. @alert_id ist int, mit einem Standardwert von NULL.

[ @category_name = ] N'category'

Die Kategorie für die Warnung. @category ist "sysname" mit der Standardeinstellung "NULL.

[ @legacy_format = ] legacy_format

Gibt an, ob ein legacy-Resultset erzeugt werden soll. @legacy_format ist bit, mit einem Standardwert von 0. Wenn @legacy_format ist 1, sp_help_alert wird das von SQL Server 2000 (8.x) zurückgegebene sp_help_alert Resultset zurückgegeben.

Rückgabecodewerte

0 (erfolgreich) oder 1 Fehler.

Resultset

Wenn @legacy_format ist 0, sp_help_alert erzeugt das folgende Resultset.

Spaltenname Datentyp BESCHREIBUNG
id int Vom System zugewiesener eindeutiger, ganzzahliger Bezeichner.
name sysname Warnungsname (z. B. Demo: Vollständiges msdb Protokoll).
event_source nvarchar(100) Quelle des Ereignisses. Es wird immer für Microsoft SQL Server, Version 7.0, verwendet MSSQLServer .
event_category_id int Nur für Informationszwecke identifiziert. Wird nicht unterstützt. Zukünftige Kompatibilität wird nicht sichergestellt.
event_id int Nur für Informationszwecke identifiziert. Wird nicht unterstützt. Zukünftige Kompatibilität wird nicht sichergestellt.
message_id int Fehlernummer der Meldung, die die Warnung definiert. (Entspricht in der Regel einer Fehlernummer in der sysmessages Tabelle). Wenn der Schweregrad verwendet wird, um die Warnung zu definieren, message_id ist 0 oder NULL.
severity int Schweregrad (von 9 bis 25, , 110, 120, 130oder 140), der die Warnung definiert.
enabled tinyint Status, ob die Warnung derzeit aktiviert ist (1) oder nicht (0). Eine nicht zulässige Warnung wird nicht gesendet.
delay_between_responses int Wartezeit in Sekunden zwischen Antworten auf die Warnung.
last_occurrence_date int Datum, an dem die Warnung zuletzt aufgetreten ist.
last_occurrence_time int Uhrzeit, zu der die Warnung zuletzt aufgetreten ist.
last_response_date int Datum, an dem die Warnung zuletzt vom SQL Server-Agent-Dienst geantwortet wurde.
last_response_time int Zeitpunkt, zu dem die Warnung zuletzt vom SQL Server-Agent-Dienst geantwortet wurde.
notification_message nvarchar(512) Optionale zusätzliche Meldung, die als Teil einer Benachrichtigung per E-Mail oder Pager an den Operator gesendet wird.
include_event_description tinyint Gibt an, ob die Beschreibung des SQL Server-Fehlers in das Microsoft Windows-Anwendungsprotokoll als Teil der Benachrichtigungsmeldung eingeschlossen werden soll.
database_name sysname Datenbank, in der der Fehler auftreten muss, damit die Warnung ausgelöst wird. Wenn der Datenbankname lautet NULL, wird die Warnung unabhängig davon ausgelöst, wo der Fehler aufgetreten ist.
event_description_keyword nvarchar(100) Beschreibung des SQL Server-Fehlers im Windows-Anwendungsprotokoll, das wie die angegebene Zeichenabfolge sein muss.
occurrence_count int Gibt an, wie oft die Warnung aufgetreten ist.
count_reset_date int Datum, an dem das occurrence_count letzte Zurücksetzen erfolgte.
count_reset_time int Zeitpunkt der occurrence_count letzten Zurücksetzung.
job_id uniqueidentifier ID des Auftrags, der als Antwort auf eine Warnung ausgeführt werden soll.
job_name sysname Name des Auftrags, der als Antwort auf eine Warnung ausgeführt werden soll.
has_notification int Ungleich 0, wenn einer oder mehrere Operatoren für diese Warnung benachrichtigt werden. Der Wert ist ein oder mehrere der folgenden Werte (ORzusammen):

1=hat E-Mail-Benachrichtigung
2=hat Pagerbenachrichtigung
4= hat net send eine Benachrichtigung.
flags int Nur für Informationszwecke identifiziert. Wird nicht unterstützt. Zukünftige Kompatibilität wird nicht sichergestellt.
performance_condition nvarchar(512) Wenn type dies der Fall ist 2, zeigt diese Spalte die Definition der Leistungsbedingung an. Andernfalls ist NULLdie Spalte .
category_name sysname Nur für Informationszwecke identifiziert. Wird nicht unterstützt. Zukünftige Kompatibilität wird nicht sichergestellt. Wird immer "[Nicht kategorisiert]" für SQL Server 7.0 sein.
wmi_namespace sysname Wenn type dies der Fall ist 3, zeigt diese Spalte den Namespace für das WMI-Ereignis an.
wmi_query nvarchar(512) Ist type dies der 3Fall, zeigt diese Spalte die Abfrage für das WMI-Ereignis an.
type int Typ des Ereignisses:

1 = SQL Server-Ereigniswarnung
2 = SQL Server-Leistungswarnung
3 = WMI-Ereigniswarnung

Wenn @legacy_format ist 1, sp_help_alert erzeugt das folgende Resultset.

Spaltenname Datentyp BESCHREIBUNG
id int Vom System zugewiesener eindeutiger, ganzzahliger Bezeichner.
name sysname Warnungsname (z. B. Demo: Vollständiges msdb Protokoll).
event_source nvarchar(100) Quelle des Ereignisses. Dies gilt MSSQLServer immer für SQL Server, Version 7.0.
event_category_id int Nur für Informationszwecke identifiziert. Wird nicht unterstützt. Zukünftige Kompatibilität wird nicht sichergestellt.
event_id int Nur für Informationszwecke identifiziert. Wird nicht unterstützt. Zukünftige Kompatibilität wird nicht sichergestellt.
message_id int Fehlernummer der Meldung, die die Warnung definiert. (Entspricht in der Regel einer Fehlernummer in der sysmessages Tabelle). Wenn der Schweregrad verwendet wird, um die Warnung zu definieren, message_id ist 0 oder NULL.
severity int Schweregrad (von 9 bis 25, , 110, 120, 130oder 140), der die Warnung definiert.
enabled tinyint Status, ob die Warnung derzeit aktiviert ist (1) oder nicht (0). Eine nicht zulässige Warnung wird nicht gesendet.
delay_between_responses int Wartezeit in Sekunden zwischen Antworten auf die Warnung.
last_occurrence_date int Datum, an dem die Warnung zuletzt aufgetreten ist.
last_occurrence_time int Uhrzeit, zu der die Warnung zuletzt aufgetreten ist.
last_response_date int Datum, an dem die Warnung zuletzt vom SQL Server-Agent-Dienst geantwortet wurde.
last_response_time int Zeitpunkt, zu dem die Warnung zuletzt vom SQL Server-Agent-Dienst geantwortet wurde.
notification_message nvarchar(512) Optionale zusätzliche Meldung, die als Teil einer Benachrichtigung per E-Mail oder Pager an den Operator gesendet wird.
include_event_description tinyint Gibt an, ob die Beschreibung des SQL Server-Fehlers aus dem Windows-Anwendungsprotokoll als Teil der Benachrichtigung enthalten sein soll.
database_name sysname Datenbank, in der der Fehler auftreten muss, damit die Warnung ausgelöst wird. Wenn der Datenbankname lautet NULL, wird die Warnung unabhängig davon ausgelöst, wo der Fehler aufgetreten ist.
event_description_keyword nvarchar(100) Beschreibung des SQL Server-Fehlers im Windows-Anwendungsprotokoll, das wie die angegebene Zeichenabfolge sein muss.
occurrence_count int Gibt an, wie oft die Warnung aufgetreten ist.
count_reset_date int Datum, an dem das occurrence_count letzte Zurücksetzen erfolgte.
count_reset_time int Zeitpunkt der occurrence_count letzten Zurücksetzung.
job_id uniqueidentifier Auftragsidentifikationsnummer.
job_name sysname Ein bedarfsgesteuerter Auftrag, der als Antwort auf eine Warnung ausgeführt werden soll.
has_notification int Ungleich 0, wenn einer oder mehrere Operatoren für diese Warnung benachrichtigt werden. Einer oder mehrere der folgenden Werte sind möglich (mit OR verknüpft):

1=hat E-Mail-Benachrichtigung
2=hat Pagerbenachrichtigung
4=hat net send Benachrichtigung.
flags int Nur für Informationszwecke identifiziert. Wird nicht unterstützt. Zukünftige Kompatibilität ist nicht garantiert..
performance_condition nvarchar(512) Wenn type dies der Fall ist 2, zeigt diese Spalte die Definition der Leistungsbedingung an. Ist type dies der 3Fall, zeigt diese Spalte die Abfrage für das WMI-Ereignis an. Andernfalls lautet NULLdie Spalte .
category_name sysname Nur für Informationszwecke identifiziert. Wird nicht unterstützt. Zukünftige Kompatibilität wird nicht sichergestellt. Wird immer für SQL Server 7.0 verwendet [Uncategorized] .
type int Warnungstyp:

1 = SQL Server-Ereigniswarnung
2 = SQL Server-Leistungswarnung
3 = WMI-Ereigniswarnung

Hinweise

sp_help_alert muss aus der msdb Datenbank ausgeführt werden.

Berechtigungen

Standardmäßig können nur Mitglieder der festen Serverrolle sysadmin diese gespeicherte Prozedur ausführen. Anderen Benutzern muss die feste Datenbankrolle "SQLAgentOperatorRole " in der msdb Datenbank gewährt werden.

Ausführliche Informationen zu SQLAgentOperatorRole finden Sie unter SQL Server-Agent festen Datenbankrollen.

Beispiele

Im folgenden Beispiel werden Informationen zur Warnung Demo: Sev. 25 Errors abgerufen.

USE msdb;
GO

EXEC sp_help_alert @alert_name = 'Demo: Sev. 25 Errors';
GO

Zugehöriger Inhalt