Delen via


sp_update_alert (Transact-SQL)

Van toepassing op:SQL Server

Hiermee worden de instellingen van een bestaande waarschuwing bijgewerkt.

Transact-SQL syntaxis-conventies

Syntaxis

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

Argumenten

[ @name = ] N'naam'

De naam van de waarschuwing die moet worden bijgewerkt. @nameis sysname, zonder standaardinstelling.

[ @new_name = ] N'new_name'

Een nieuwe naam voor de waarschuwing. De naam moet uniek zijn. @new_name is sysname, met een standaardwaarde van NULL.

[ @enabled = ] ingeschakeld

Hiermee geeft u op of de waarschuwing is ingeschakeld (1) of niet is ingeschakeld (0). @enabled is klein, met een standaardwaarde van NULL. Er moet een waarschuwing zijn ingeschakeld om te worden geactiveerd.

[ @message_id = ] message_id

Een nieuw bericht of een nieuw foutbericht voor de waarschuwingsdefinitie. Normaal gesproken komt message_id overeen met een foutnummer in de tabel sysmessages . @message_id is int, met een standaardwaarde van NULL. Een bericht-id kan alleen worden gebruikt als de instelling voor ernstniveau voor de waarschuwing is 0.

[ @severity = ] ernst

Een nieuw ernstniveau (van tot en met 125) voor de waarschuwingsdefinitie. Elk SQL Server-bericht dat met de opgegeven ernst naar het Windows-toepassingslogboek wordt verzonden, activeert de waarschuwing. @severity is int, met een standaardwaarde van NULL. Een ernstniveau kan alleen worden gebruikt als de instelling voor de bericht-id voor de waarschuwing is 0.

[ @delay_between_responses = ] delay_between_responses

De nieuwe wachttijd, in seconden, tussen reacties op de waarschuwing. @delay_between_responses is int, met een standaardwaarde van NULL.

[ @notification_message = ] N'notification_message'

De herziene tekst van een extra bericht dat is verzonden naar de operator als onderdeel van de melding e-mail, net send of pager. @notification_message is nvarchar(512), met een standaardwaarde van NULL.

[ @include_event_description_in = ] include_event_description_in

Hiermee geeft u op of de beschrijving van de SQL Server-fout uit het Windows-toepassingslogboek moet worden opgenomen in het meldingsbericht. @include_event_description_inis klein en kan een of meer van deze waarden zijn.

Waarde Beschrijving
0 Geen
1 E-mail
2 Pager
4 net send
7 Alle

[ @database_name = ] N'database_name'

De naam van de database waarin de fout moet optreden om de waarschuwing te activeren. @database_name is sysname, met een standaardwaarde van NULL. Namen die tussen haakjes ([]) staan, zijn niet toegestaan.

[ @event_description_keyword = ] N'event_description_keyword'

Een reeks tekens die moeten worden gevonden in de beschrijving van de SQL Server-fout in het foutberichtlogboek. @event_description_keyword is nvarchar(100), met een standaardwaarde van NULL. Deze parameter is handig voor het filteren van objectnamen (bijvoorbeeld customer_table).

Opmerking

LIKETransact-SQL expressiepatroon-overeenkomende tekens kunnen niet worden gebruikt.

[ @job_id = ] 'job_id'

@job_id is uniqueidentifier-, met een standaardwaarde van NULL.

[ @job_name = ] N'job_name'

Het identificatienummer van de taak. @job_name is sysname, met een standaardwaarde van NULL. Als job_id is opgegeven, moet job_name worden weggelaten.

[ @occurrence_count = ] occurrence_count

Hiermee stelt u het aantal keren dat de waarschuwing is opgetreden, opnieuw in. @occurrence_count is int, met een standaardwaarde en NULLkan alleen worden ingesteld op 0.

[ @count_reset_date = ] count_reset_date

Hiermee stelt u de datum opnieuw in waarop het aantal exemplaren voor het laatst opnieuw is ingesteld. @count_reset_date is int, met een standaardwaarde van NULL.

[ @count_reset_time = ] count_reset_time

Hiermee stelt u de tijd opnieuw in waarop het aantal exemplaren voor het laatst opnieuw is ingesteld. @count_reset_time is int, met een standaardwaarde van NULL.

[ @last_occurrence_date = ] last_occurrence_date

Hiermee stelt u de datum opnieuw in waarop de waarschuwing het laatst is opgetreden. @last_occurrence_date is int, met een standaardwaarde en NULLkan alleen worden ingesteld op 0.

[ @last_occurrence_time = ] last_occurrence_time

Hiermee stelt u de tijd opnieuw in waarop de waarschuwing het laatst is opgetreden. @last_occurrence_time is int, met een standaardwaarde van NULLen kan alleen worden ingesteld op 0.

[ @last_response_date = ] last_response_date

Hiermee stelt u de datum opnieuw in waarop de waarschuwing voor het laatst is gereageerd door de SQLServerAgent-service. @last_response_date is int, met een standaardwaarde NULLen kan alleen worden ingesteld op 0.

[ @last_response_time = ] last_response_time

Hiermee stelt u de tijd opnieuw in waarop de waarschuwing voor het laatst is gereageerd door de SQLServerAgent-service. @last_response_time is int, met een standaardwaarde en NULLkan alleen worden ingesteld op 0.

[ @raise_snmp_trap = ] raise_snmp_trap

Alleen ter informatie geïdentificeerd. Wordt niet ondersteund. Toekomstige compatibiliteit is niet gegarandeerd.

[ @performance_condition = ] N'performance_condition'

Een waarde uitgedrukt in de notatie <itemcomparatorvalue>. @performance_condition is nvarchar(512) en bestaat uit de volgende elementen.

Element Opmaken Beschrijving
Artikel Een prestatieobject, prestatiemeteritems of benoemd exemplaar van de teller
Comparator Een van deze operators: >, <=
Waarde Numerieke waarde van de teller

[ @category_name = ] N'category_name'

De naam van de waarschuwingscategorie. @category_name is sysname, met een standaardwaarde van NULL.

[ @wmi_namespace = ] N'wmi_namespace'

De WMI-naamruimte om een query uit te voeren op gebeurtenissen. @wmi_namespace is sysname, met een standaardwaarde van NULL.

[ @wmi_query = ] N'wmi_query'

De query waarmee de WMI-gebeurtenis voor de waarschuwing wordt opgegeven. @wmi_query is nvarchar(512), met een standaardwaarde van NULL.

Codewaarden retourneren

0 (geslaagd) of 1 (mislukt).

Opmerkingen

Alleen sysmessages geschreven naar het Windows-toepassingslogboek kan een waarschuwing activeren.

sp_update_alert wijzigt alleen de waarschuwingsinstellingen waarvoor parameterwaarden worden opgegeven. Als een parameter wordt weggelaten, blijft de huidige instelling behouden.

Machtigingen

Als u deze opgeslagen procedure wilt uitvoeren, moeten gebruikers lid zijn van de vaste serverfunctie sysadmin .

Voorbeelden

In het volgende voorbeeld wordt de ingeschakelde instelling gewijzigd in Test Alert0.

USE msdb;
GO

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