sp_help_alert (Transact-SQL)

Artikel
2025-01-02

Gilt für: SQL Server

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

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 "sysname" mit einem Standardwert von NULL. 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_name'

Die Kategorie für die Warnung. @category_name 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

Diese Tabelle zeigt nur die Ausgabe an, wenn @legacy_format ist 0, für SQL Server 2005 (9.x) und höhere Versionen.

Spaltenname	Datentyp	BESCHREIBUNG
`id`	int	Vom System zugewiesener eindeutiger, ganzzahliger Bezeichner.
`name`	sysname	Warnungsname (z. B `Demo: Full msdb log`. ).
`event_source`	nvarchar(100)	Quelle des Ereignisses.
`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`, `130`oder `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 (`OR`zusammen): `1` = hat E-Mail-Benachrichtigung `2` = hat Pager-Benachrichtigung `4` = hat net send notification.
`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 `NULL`die 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]` .
`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 `3`Fall, 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

Hinweise

sp_help_alert muss aus der msdb Datenbank ausgeführt werden.

Berechtigungen

Sie können Berechtigungen für dieses Verfahren erteilen EXECUTE , aber diese Berechtigungen können während eines SQL Server-Upgrades außer Kraft gesetzt werden.

Anderen Benutzern muss eine der folgenden SQL Server-Agent festen Datenbankrollen in der msdb Datenbank gewährt werden:

SQLAgentUserRole
SQLAgentReaderRole
SQLAgentOperatorRole

Weitere Informationen zu den Berechtigungen dieser Rollen finden Sie unter Feste Datenbankrollen des SQL Server-Agents.

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

Freigeben über