sp_update_alert (Transact-SQL)

  • Artikel

Gilt für:SQL Server

Aktualisiert die Einstellungen einer vorhandenen Warnung.

Transact-SQL-Syntaxkonventionen

Syntax

sp_update_alert
    [ @name = ] N'name'
    [ , [ @new_name = ] N'new_name' ]
    [ , [ @enabled = ] enabled ]
    [ , [ @message_id = ] message_id ]
    [ , [ @severity = ] severity ]
    [ , [ @delay_between_responses = ] delay_between_responses ]
    [ , [ @notification_message = ] N'notification_message' ]
    [ , [ @include_event_description_in = ] include_event_description_in ]
    [ , [ @database_name = ] N'database_name' ]
    [ , [ @event_description_keyword = ] N'event_description_keyword' ]
    [ , [ @job_id = ] 'job_id' ]
    [ , [ @job_name = ] N'job_name' ]
    [ , [ @occurrence_count = ] occurrence_count ]
    [ , [ @count_reset_date = ] count_reset_date ]
    [ , [ @count_reset_time = ] count_reset_time ]
    [ , [ @last_occurrence_date = ] last_occurrence_date ]
    [ , [ @last_occurrence_time = ] last_occurrence_time ]
    [ , [ @last_response_date = ] last_response_date ]
    [ , [ @last_response_time = ] last_response_time ]
    [ , [ @raise_snmp_trap = ] raise_snmp_trap ]
    [ , [ @performance_condition = ] N'performance_condition' ]
    [ , [ @category_name = ] N'category_name' ]
    [ , [ @wmi_namespace = ] N'wmi_namespace' ]
    [ , [ @wmi_query = ] N'wmi_query' ]
[ ; ]

Argumente

[ @name = ] N'name'

Der Name der Warnung, die aktualisiert werden soll. @name ist "sysname" ohne Standard.

[ @new_name = ] N'new_name'

Ein neuer Name für die Warnung. Der Name muss eindeutig sein. @new_name ist "sysname" mit der Standardeinstellung "NULL.

[ @enabled = ] aktiviert

Gibt an, ob die Warnung aktiviert (1) oder nicht aktiviert ist (0). @enabled ist winzig, mit einem Standardwert von NULL. Eine Warnung muss aktiviert sein, um ausgelöst werden zu können.

[ @message_id = ] message_id

Eine neue Meldungs- oder Fehlernummer für die Warnungsdefinition. In der Regel entspricht message_id einer Fehlernummer in der Sysmessages-Tabelle. @message_id ist int, mit einem Standardwert von NULL. Eine Nachrichten-ID kann nur verwendet werden, wenn die Einstellung der Schweregrad für die Warnung lautet 0.

[ @severity = ] Schweregrad

Eine neue Schweregrad (von bis 125) für die Warnungsdefinition. Jede SQL Server-Nachricht, die an das Windows-Anwendungsprotokoll gesendet wird, mit dem angegebenen Schweregrad aktiviert die Warnung. @severity ist int mit einem Standardwert von NULL. Eine Schweregrad kann nur verwendet werden, wenn die Nachrichten-ID-Einstellung für die Warnung lautet 0.

[ @delay_between_responses = ] delay_between_responses

Die neue Wartezeit zwischen Antworten auf die Warnung in Sekunden. @delay_between_responses ist int mit einem Standardwert von NULL.

[ @notification_message = ] N'notification_message'

Der überarbeitete Text einer zusätzlichen Nachricht, die als Teil der E-Mail-, Net Send- oder Pager-Benachrichtigung an den Betreiber gesendet wird. @notification_message ist nvarchar(512), mit einem Standardwert von NULL.

[ @include_event_description_in = ] include_event_description_in

Gibt an, ob die Beschreibung des SQL Server-Fehlers aus dem Windows-Anwendungsprotokoll in die Benachrichtigung eingeschlossen werden soll. @include_event_description_in ist winzig und kann einen oder mehrere dieser Werte sein.

Wert BESCHREIBUNG
0 Keine
1 E-Mail
2 Pager
4 net send
7 Alle

[ @database_name = ] N'database_name'

Der Name der Datenbank, in der der Fehler auftreten muss, damit die Warnung ausgelöst wird. @database_name ist "sysname" mit einem Standardwert von NULL. Namen, die in eckige Klammern ([]) eingeschlossen sind, sind nicht zulässig.

[ @event_description_keyword = ] N'event_description_Schlüsselwort (keyword)'

Eine Abfolge von Zeichen, die in der Beschreibung des SQL Server-Fehlers im Fehlermeldungsprotokoll gefunden werden müssen. @event_description_Schlüsselwort (keyword) ist "nvarchar(100)" mit einem Standardwert von NULL. Dieser Parameter ist nützlich zum Filtern von Objektnamen (z. B customer_table. ).

Hinweis

Transact-SQL-Ausdrucksmusterabgleichzeichen LIKE können nicht verwendet werden.

[ @job_id = ] 'job_id'

@job_id ist eindeutiger Bezeichner mit einem Standardwert von NULL.

[ @job_name = ] N'job_name'

Die Auftrags-ID @job_name ist "sysname" mit der Standardeinstellung "NULL. Wenn job_id angegeben ist, muss job_name weggelassen werden.

[ @occurrence_count = ] occurrence_count

Setzt die Häufigkeit zurück, mit der die Warnung aufgetreten ist. @occurrence_count ist int, mit einem Standardwert von NULL, und kann nur auf 0.

[ @count_reset_date = ] count_reset_date

Setzt das Datum zurück, an dem die Anzahl der Vorkommen zuletzt zurückgesetzt wurde. @count_reset_date ist int mit einem Standardwert von NULL.

[ @count_reset_time = ] count_reset_time

Setzt die Uhrzeit zurück, zu der die Anzahl der Vorkommen zuletzt zurückgesetzt wurde. @count_reset_time ist int, mit einem Standardwert von NULL.

[ @last_occurrence_date = ] last_occurrence_date

Setzt das Datum zurück, an dem die Warnung zuletzt aufgetreten ist. @last_occurrence_date ist int, mit einem Standardwert von NULL, und kann nur auf 0.

[ @last_occurrence_time = ] last_occurrence_time

Setzt die Uhrzeit zurück, zu der die Warnung zuletzt aufgetreten ist. @last_occurrence_time ist int, mit einem Standardwert von NULLund kann nur auf 0.

[ @last_response_date = ] last_response_date

Setzt das Datum zurück, an dem der SQLSERVERAGENT-Dienst zuletzt auf die Warnung reagiert hat. @last_response_date ist int, mit einem Standardwert von NULL, und kann nur auf 0.

[ @last_response_time = ] last_response_time

Setzt die Uhrzeit zurück, zu der der SQLSERVERAGENT-Dienst zuletzt auf die Warnung reagiert hat. @last_response_time ist int, mit einem Standardwert von NULL, und kann nur auf 0.

[ @raise_snmp_trap = ] raise_snmp_trap

Nur für Informationszwecke identifiziert. Wird nicht unterstützt. Zukünftige Kompatibilität wird nicht sichergestellt.

[ @performance_condition = ] N'performance_condition'

Ein wert, der im Format <itemcomparatorvalue>ausgedrückt wird. @performance_condition ist nvarchar(512) und besteht aus den folgenden Elementen.

Format-Element Beschreibung
Element Ein Leistungsobjekt, ein Leistungsindikator oder die benannte Instanz des Indikators
Komparator Einer der folgenden Operatoren: >, , <=
Wert Numerischer Wert des Indikators

[ @category_name = ] N'category_name'

Der Name der Warnungskategorie. @category_name ist "sysname" mit der Standardeinstellung "NULL.

[ @wmi_namespace = ] N'wmi_namespace'

Der WMI-Namespace zum Abfragen der Ereignisse. @wmi_namespace ist "sysname" mit der Standardeinstellung "NULL.

[ @wmi_query = ] N'wmi_query'

Die Abfrage, die das WMI-Ereignis für die Warnung angibt. @wmi_query ist "nvarchar(512)" mit einem Standardwert von NULL.

Rückgabecodewerte

0 (erfolgreich) oder 1 Fehler.

Hinweise

Nur sysmessages in das Windows-Anwendungsprotokoll geschriebene Kann eine Warnung auslösen.

sp_update_alert ändert nur die Warnungseinstellungen, für die Parameterwerte angegeben werden. Wird ein Parameter nicht angegeben, wird die aktuelle Einstellung beibehalten.

Berechtigungen

Um diese gespeicherte Prozedur auszuführen, müssen Benutzer Mitglied der festen Serverrolle "sysadmin " sein.

Beispiele

Im folgenden Beispiel wird die Aktivierungseinstellung von Test Alert in 0 geändert.

USE msdb;
GO

EXEC dbo.sp_update_alert
    @name = N'Test Alert',
    @enabled = 0;
GO

Zugehöriger Inhalt