Sdílet prostřednictvím


sp_update_alert (Transact-SQL)

platí pro:SQL Server

Aktualizuje nastavení existující výstrahy.

Transact-SQL konvence syntaxe

Syntaxe

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' ]
[ ; ]

Argumenty

[ @name = ] N'název'

Název výstrahy, která se má aktualizovat. @name je sysname bez výchozího nastavení.

[ @new_name = ] N'new_name'

Nový název výstrahy. Název musí být jedinečný. @new_name je sysname, s výchozím nastavením NULL.

[ @enabled = ] povoleno

Určuje, jestli je výstraha povolená (1) nebo není povolená (0). @enabled je tinyint, s výchozím nastavením NULL. Aby se aktivovalo upozornění, musí být povolené.

[ @message_id = ] message_id

Nová zpráva nebo číslo chyby pro definici výstrahy Obvykle message_id odpovídá chybě číslo v tabulce sysmessages . @message_id je int, s výchozím nastavením NULL. ID zprávy lze použít pouze v případě, že je 0nastavení úrovně závažnosti výstrahy .

[ @severity = ] závažnost

Nová úroveň závažnosti (od 1 do 25) pro definici výstrahy. Jakákoli zpráva SQL Serveru odeslaná do protokolu aplikace systému Windows se zadanou závažností aktivuje výstrahu. @severity je int, s výchozím nastavením NULL. Úroveň závažnosti lze použít pouze v případě, že nastavení ID zprávy pro výstrahu je 0.

[ @delay_between_responses = ] delay_between_responses

Nové čekací období v sekundách mezi odpověďmi na výstrahu. @delay_between_responses je int, s výchozím nastavením NULL.

[ @notification_message = ] N'notification_message'

Revidovaný text další zprávy odeslané operátorovi jako součást e-mailu, net send nebo pager notification. @notification_message je nvarchar(512) s výchozím nastavením NULL.

[ @include_event_description_in = ] include_event_description_in

Určuje, zda má být v oznamovací zprávě zahrnut popis chyby SQL Serveru z protokolu aplikací systému Windows. @include_event_description_in je malý a může to být jedna nebo více těchto hodnot.

Hodnota Popis
0 Žádné
1 E-mail
2 Pípatko
4 net send
7 Všechno

[ @database_name = ] N'database_name'

Název databáze, ve které musí dojít k chybě, aby se výstraha aktivovalo. @database_name je sysname , s výchozím NULL. Názvy, které jsou uzavřeny v hranatých závorkách ([]), nejsou povolené.

[ @event_description_keyword = ] N'event_description_keyword'

Posloupnost znaků, které musí být nalezeny v popisu chyby SQL Serveru v protokolu chybových zpráv. @event_description_keyword je nvarchar(100), s výchozí hodnotou NULL. Tento parametr je užitečný pro filtrování názvů objektů (například customer_table).

Poznámka:

LIKETransact-SQL znaky porovnávání vzorů výrazů se nedají použít.

[ @job_id = ] 'job_id'

@job_id je uniqueidentifier s výchozím NULL.

[ @job_name = ] N'job_name'

Identifikační číslo úlohy. @job_name je sysname , s výchozím NULL. Pokud je zadán job_id , je nutné job_name vynechat.

[ @occurrence_count = ] occurrence_count

Obnoví počet výskytů výstrahy. @occurrence_count je int, s výchozí hodnotou NULLa lze ji nastavit pouze na 0hodnotu .

[ @count_reset_date = ] count_reset_date

Obnoví datum posledního resetování počtu výskytů. @count_reset_date je int s výchozím nastavením NULL.

[ @count_reset_time = ] count_reset_time

Obnoví čas posledního resetování počtu výskytů. @count_reset_time je int, s výchozí hodnotou NULL.

[ @last_occurrence_date = ] last_occurrence_date

Obnoví datum, kdy k upozornění došlo naposledy. @last_occurrence_date je int, s výchozím nastavením NULLa lze ji nastavit pouze na 0.

[ @last_occurrence_time = ] last_occurrence_time

Obnoví čas, kdy k upozornění došlo naposledy. @last_occurrence_time je int, s výchozím nastavením NULLa lze ji nastavit pouze na 0.

[ @last_response_date = ] last_response_date

Obnoví datum poslední odpovědi upozornění službou SQLServerAgent. @last_response_date je int, s výchozí hodnotou NULLa lze ji nastavit pouze na 0.

[ @last_response_time = ] last_response_time

Obnoví čas poslední odpovědi upozornění službou SQLServerAgent. @last_response_time je int, s výchozí hodnotou NULLa lze ji nastavit pouze na 0hodnotu .

[ @raise_snmp_trap = ] raise_snmp_trap

Určeno pouze pro informační účely. Není podporováno. Budoucí kompatibilita není zaručena.

[ @performance_condition = ] N'performance_condition'

Hodnota vyjádřená ve formátu <itemcomparatorvalue>. @performance_condition je nvarchar(512) a skládá se z následujících prvků.

Format – element Popis
Položka Objekt výkonu, čítač výkonu nebo pojmenovaná instance čítače
Komparátor Jeden z těchto operátorů: >, <, =
Hodnota Číselná hodnota čítače

[ @category_name = ] N'category_name'

Název kategorie upozornění. @category_name je sysname, s výchozím nastavením NULL.

[ @wmi_namespace = ] N'wmi_namespace'

Obor názvů rozhraní WMI, který se má dotazovat na události. @wmi_namespace je sysname s výchozím nastavením NULL.

[ @wmi_query = ] N'wmi_query'

Dotaz, který určuje událost rozhraní WMI pro výstrahu. @wmi_query je nvarchar(512) s výchozím nastavením NULL.

Hodnoty návratového kódu

0 (úspěch) nebo 1 (selhání).

Poznámky

Výstrahu může aktivovat pouze sysmessages zápis do protokolu aplikací pro Windows.

sp_update_alert změní pouze nastavení výstrahy, pro které jsou zadány hodnoty parametrů. Pokud parametr vynecháte, zachová se aktuální nastavení.

Povolení

Chcete-li spustit tuto uloženou proceduru, musí být uživatelé členem pevné role serveru správce systému .

Příklady

Následující příklad změní povolené nastavení Test Alert na 0.

USE msdb;
GO

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