Udostępnij za pomocą


sp_update_alert (Transact-SQL)

Dotyczy:SQL Server

Aktualizuje ustawienia istniejącego alertu.

Transact-SQL konwencje składni

Składnia

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 (w programowaniu)

[ @name = ] N'name'

Nazwa alertu, który ma zostać zaktualizowany. @name jest nazwą systemu bez wartości domyślnej.

[ @new_name = ] N'new_name'

Nowa nazwa alertu. Nazwa musi być unikatowa. @new_name to nazwa systemu z wartością domyślną NULL.

[ @enabled = ] włączone

Określa, czy alert jest włączony (1) czy nie jest włączony (0). @enabled jest tinyint, z wartością domyślną NULL. Należy włączyć wyzwalanie alertu.

[ @message_id = ] message_id

Nowy komunikat lub numer błędu definicji alertu. Zazwyczaj message_id odpowiada numerowi błędu w tabeli sysmessages . @message_id jest int z wartością domyślną NULL. Identyfikator komunikatu może być używany tylko wtedy, gdy ustawienie poziomu ważności alertu to 0.

[ @severity = ] ważność

Nowy poziom ważności (od 1 do 25) dla definicji alertu. Każdy komunikat programu SQL Server wysłany do dziennika aplikacji systemu Windows z określoną ważnością aktywuje alert. @severity jest int z wartością domyślną NULL. Poziom ważności może być używany tylko wtedy, gdy ustawienie identyfikatora komunikatu dla alertu to 0.

[ @delay_between_responses = ] delay_between_responses

Nowy okres oczekiwania w sekundach między odpowiedziami na alert. @delay_between_responses jest int z wartością domyślną NULL.

[ @notification_message = ] N'notification_message'

Poprawiony tekst dodatkowej wiadomości wysłanej do operatora w ramach wiadomości e-mail, wysyłania netto lub powiadomienia pagera. @notification_message to nvarchar(512), z wartością domyślną NULL.

[ @include_event_description_in = ] include_event_description_in

Określa, czy opis błędu programu SQL Server z dziennika aplikacji systemu Windows powinien być uwzględniony w komunikacie powiadomienia. @include_event_description_in jest tinyint i może być co najmniej jedną z tych wartości.

Wartość Opis
0 Żaden
1 Poczta e-mail
2 Pejdżer
4 net send
7 Wszystko

[ @database_name = ] N'database_name'

Nazwa bazy danych, w której musi wystąpić błąd, aby alert został wyzwolony. @database_name jest sysname z wartością domyślną NULL. Nazwy ujęte w nawiasy kwadratowe ([]) nie są dozwolone.

[ @event_description_keyword = ] N'event_description_keyword'

Sekwencja znaków, które należy znaleźć w opisie błędu programu SQL Server w dzienniku komunikatów o błędzie. @event_description_keyword to nvarchar(100), z wartością domyślną NULL. Ten parametr jest przydatny do filtrowania nazw obiektów (na przykład customer_table).

Uwaga / Notatka

LIKETransact-SQL nie można używać znaków pasujących do wzorca wyrażeń.

[ @job_id = ] 'job_id'

@job_id jest unikatowyidentifierz wartością domyślną NULL.

[ @job_name = ] N'job_name'

Numer identyfikacyjny zadania. @job_name jest nazwa systemuz wartością domyślną NULL. W przypadku określenia job_id należy pominąć job_name .

[ @occurrence_count = ] occurrence_count

Resetuje liczbę przypadków wystąpienia alertu. @occurrence_count jest int, z wartością domyślną NULL, i można ustawić tylko wartość 0.

[ @count_reset_date = ] count_reset_date

Resetuje datę ostatniego zresetowania liczby wystąpień. @count_reset_date jest int z wartością domyślną NULL.

[ @count_reset_time = ] count_reset_time

Resetuje czas ostatniego zresetowania liczby wystąpień. @count_reset_time jest int z wartością domyślną NULL.

[ @last_occurrence_date = ] last_occurrence_date

Resetuje datę ostatniego wystąpienia alertu. @last_occurrence_date jest int, z wartością domyślną NULL, i można ustawić tylko wartość 0.

[ @last_occurrence_time = ] last_occurrence_time

Resetuje czas ostatniego wystąpienia alertu. @last_occurrence_time jest int, z wartością domyślną NULLi można ustawić tylko wartość 0.

[ @last_response_date = ] last_response_date

Resetuje datę ostatniego reagowania alertu przez usługę SQLServerAgent. @last_response_date jest int z wartością domyślną NULLi można ustawić tylko wartość 0.

[ @last_response_time = ] last_response_time

Resetuje czas ostatniego reagowania alertu przez usługę SQLServerAgent. @last_response_time jest int, z wartością domyślną NULLi można ustawić tylko wartość 0.

[ @raise_snmp_trap = ] raise_snmp_trap

Zidentyfikowane tylko do celów informacyjnych. Niewspierane. Zgodność w przyszłości nie jest gwarantowana.

[ @performance_condition = ] N'performance_condition'

Wartość wyrażona w formacie <itemcomparatorvalue>. @performance_condition to nvarchar(512) i składa się z następujących elementów.

Format, element Opis
Produkt Obiekt wydajności, licznik wydajności lub nazwane wystąpienie licznika
Komparator Jeden z następujących operatorów: >, , <=
Wartość Wartość liczbowa licznika

[ @category_name = ] N'category_name'

Nazwa kategorii alertów. @category_name to nazwa systemu z wartością domyślną NULL.

[ @wmi_namespace = ] N'wmi_namespace'

Przestrzeń nazw usługi WMI do wykonywania zapytań o zdarzenia. @wmi_namespace to nazwa systemu z wartością domyślną NULL.

[ @wmi_query = ] N'wmi_query'

Zapytanie określające zdarzenie WMI dla alertu. @wmi_query to nvarchar(512), z wartością domyślną NULL.

Zwracanie wartości kodu

0 (powodzenie) lub 1 (niepowodzenie).

Uwagi

Alert może być wyzwalany tylko sysmessages w dzienniku aplikacji systemu Windows.

sp_update_alert zmienia tylko te ustawienia alertu, dla których podano wartości parametrów. Jeśli parametr zostanie pominięty, bieżące ustawienie zostanie zachowane.

Uprawnienia

Aby uruchomić tę procedurę składowaną, użytkownicy muszą być członkami stałej roli serwera sysadmin .

Przykłady

W poniższym przykładzie wprowadzono zmianę włączonego Test Alert ustawienia na 0.

USE msdb;
GO

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