Dela via


sp_update_alert (Transact-SQL)

gäller för:SQL Server

Uppdaterar inställningarna för en befintlig avisering.

Transact-SQL syntaxkonventioner

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

Argumentpunkter

[ @name = ] N'namn'

Namnet på aviseringen som ska uppdateras. @name är sysname, utan standard.

[ @new_name = ] N'new_name'

Ett nytt namn på aviseringen. Namnet måste vara unikt. @new_name är sysname med standardvärdet NULL.

[ @enabled = ] aktiverad

Anger om aviseringen är aktiverad (1) eller inte aktiverad (0). @enabled är tinyint, med standardvärdet NULL. En avisering måste aktiveras för att utlösas.

[ @message_id = ] message_id

Ett nytt meddelande eller felnummer för aviseringsdefinitionen. Vanligtvis motsvarar message_id ett felnummer i tabellen sysmessages . @message_id är int, med standardvärdet NULL. Ett meddelande-ID kan bara användas om inställningen för allvarlighetsgrad för aviseringen är 0.

[ @severity = ] allvarlighetsgrad

En ny allvarlighetsgrad (från 1 och med 25) för aviseringsdefinitionen. Alla SQL Server-meddelanden som skickas till Windows-programloggen med angiven allvarlighetsgrad aktiverar aviseringen. @severity är int, med standardvärdet NULL. En allvarlighetsgrad kan endast användas om meddelande-ID-inställningen för aviseringen är 0.

[ @delay_between_responses = ] delay_between_responses

Den nya väntetiden, i sekunder, mellan svar på aviseringen. @delay_between_responses är int, med standardvärdet NULL.

[ @notification_message = ] N'notification_message'

Den ändrade texten i ett ytterligare meddelande som skickas till operatorn som en del av meddelandet om e-post, net send eller pager. @notification_message är nvarchar(512), med standardvärdet NULL.

[ @include_event_description_in = ] include_event_description_in

Anger om beskrivningen av SQL Server-felet från Windows-programloggen ska ingå i meddelandemeddelandet. @include_event_description_in är tinyint och kan vara ett eller flera av dessa värden.

Värde Beskrivning
0 Ingen
1 E-post
2 Personsökare
4 net send
7 Allt

[ @database_name = ] N'database_name'

Namnet på databasen där felet måste inträffa för att aviseringen ska utlösas. @database_name är sysname, med standardvärdet NULL. Namn som omges av hakparenteser ([]) tillåts inte.

[ @event_description_keyword = ] N'event_description_keyword'

En sekvens med tecken som måste hittas i beskrivningen av SQL Server-felet i felmeddelandeloggen. @event_description_keyword är nvarchar(100), med standardvärdet NULL. Den här parametern är användbar för att filtrera objektnamn (till exempel customer_table).

Anmärkning

LIKETransact-SQL uttrycksmönstermatchande tecken kan inte användas.

[ @job_id = ] "job_id"

@job_id är unikidentifierare, med standardvärdet NULL.

[ @job_name = ] N'job_name'

Jobbidentifieringsnumret. @job_name är sysname, med standardvärdet NULL. Om job_id anges måste job_name utelämnas.

[ @occurrence_count = ] occurrence_count

Återställer antalet gånger som aviseringen har inträffat. @occurrence_count är int, med standardvärdet NULL, och kan bara anges till 0.

[ @count_reset_date = ] count_reset_date

Återställer det datum då antalet förekomster senast återställdes. @count_reset_date är int, med standardvärdet NULL.

[ @count_reset_time = ] count_reset_time

Återställer tiden då antalet förekomster senast återställdes. @count_reset_time är int, med standardvärdet NULL.

[ @last_occurrence_date = ] last_occurrence_date

Återställer det datum då aviseringen senast inträffade. @last_occurrence_date är int, med standardvärdet NULL, och kan endast anges till 0.

[ @last_occurrence_time = ] last_occurrence_time

Återställer den tid då aviseringen senast inträffade. @last_occurrence_time är int, med standardvärdet NULL, och kan endast anges till 0.

[ @last_response_date = ] last_response_date

Återställer det datum då aviseringen senast besvarades av SQLServerAgent-tjänsten. @last_response_date är int, med standardvärdet NULL, och kan endast anges till 0.

[ @last_response_time = ] last_response_time

Återställer den tid då aviseringen senast besvarades av SQLServerAgent-tjänsten. @last_response_time är int, med standardvärdet NULL, och kan endast anges till 0.

[ @raise_snmp_trap = ] raise_snmp_trap

Identifieras endast i informationssyfte. Stöds inte. Framtida kompatibilitet garanteras inte.

[ @performance_condition = ] N'performance_condition'

Ett värde uttryckt i formatet <itemcomparatorvalue>. @performance_condition är nvarchar(512) och består av följande element.

Formatera element Beskrivning
Objekt Ett prestandaobjekt, en prestandaräknare eller en namngiven instans av räknaren
Komparator En av följande operatorer: >, <, =
Värde Numeriskt värde för räknaren

[ @category_name = ] N'category_name'

Namnet på aviseringskategorin. @category_name är sysname med standardvärdet NULL.

[ @wmi_namespace = ] N'wmi_namespace'

WMI-namnområdet för att fråga efter händelser. @wmi_namespace är sysname med standardvärdet NULL.

[ @wmi_query = ] N'wmi_query'

Frågan som anger WMI-händelsen för aviseringen. @wmi_query är nvarchar(512), med standardvärdet NULL.

Returnera kodvärden

0 (lyckades) eller 1 (fel).

Anmärkningar

Endast sysmessages skrivet till Windows-programloggen kan utlösa en avisering.

sp_update_alert ändrar endast de aviseringsinställningar för vilka parametervärden anges. Om en parameter utelämnas behålls den aktuella inställningen.

Behörigheter

Om du vill köra den här lagrade proceduren måste användarna vara medlemmar i den fasta sysadmin-serverrollen .

Exempel

I följande exempel ändras den aktiverade inställningen Test Alert till 0.

USE msdb;
GO

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