sp_update_alert (Transact-SQL)

  • Articolo

Si applica a:SQL Server

Aggiorna le impostazioni di un avviso esistente.

Convenzioni relative alla sintassi Transact-SQL

Sintassi

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

Argomenti

[ @name = ] N'name'

Nome dell'avviso da aggiornare. @name è sysname, senza impostazione predefinita.

[ @new_name = ] N'new_name'

Nuovo nome per l'avviso. Il nome deve essere univoco. @new_name è sysname, con un valore predefinito .NULL

[ @enabled = ] abilitato

Specifica se l'avviso è abilitato (1) o non abilitato (0). @enabled è tinyint, con un valore predefinito .NULL Per consentire la generazione di un avviso, è necessario che l'avviso sia abilitato.

[ @message_id = ] message_id

Nuovo messaggio o numero di errore per la definizione dell'avviso. In genere, message_id corrisponde a un numero di errore nella tabella sysmessages . @message_id è int, con il valore predefinito NULL. Un ID messaggio può essere usato solo se l'impostazione del livello di gravità per l'avviso è 0.

[ @severity = ] gravità

Nuovo livello di gravità (da 1 a 25) per la definizione dell'avviso. Qualsiasi messaggio di SQL Server inviato al registro applicazioni di Windows con la gravità specificata attiva l'avviso. @severity è int, con il valore predefinito .NULL Un livello di gravità può essere usato solo se l'impostazione dell'ID messaggio per l'avviso è 0.

[ @delay_between_responses = ] delay_between_responses

Nuovo intervallo di attesa, in secondi, che intercorre tra le risposte all'avviso. @delay_between_responses è int, con il valore predefinito NULL.

[ @notification_message = ] N'notification_message'

Testo modificato di un messaggio aggiuntivo inviato all'operatore come parte della notifica tramite posta elettronica, net send o cercapersone. @notification_message è nvarchar(512), con il valore predefinito NULL.

[ @include_event_description_in = ] include_event_description_in

Specifica se la descrizione dell'errore di SQL Server dal registro applicazioni di Windows deve essere inclusa nel messaggio di notifica. @include_event_description_in è tinyint e può essere uno o più di questi valori.

Valore Descrizione
0 Nessuna
1 E-mail
2 Cellulare 2
4 net send
7 Tutte le date

[ @database_name = ] N'database_name'

Nome del database nel quale deve verificarsi l'errore affinché l'avviso venga generato. @database_name è sysname, con un valore predefinito .NULL I nomi racchiusi tra parentesi quadre ([]) non sono consentiti.

[ @event_description_keyword = ] N'event_description_keyword'

Sequenza di caratteri che devono essere trovati nella descrizione dell'errore di SQL Server nel log dei messaggi di errore. @event_description_keyword è nvarchar(100), con un valore predefinito .NULL Questo parametro è utile per filtrare i nomi degli oggetti , ad esempio customer_table.

Nota

Non è possibile usare caratteri di criteri di ricerca di espressioni Transact-SQL LIKE .

[ @job_id = ] 'job_id'

@job_id è uniqueidentifier, con un valore predefinito .NULL

[ @job_name = ] N'job_name'

Numero di identificazione del processo. @job_name è sysname, con il valore predefinito NULL. Se si specifica job_id , è necessario omettere job_name .

[ @occurrence_count = ] occurrence_count

Reimposta il numero di occorrenze dell'avviso. @occurrence_count è int, con un valore predefinito , NULLe può essere impostato solo su 0.

[ @count_reset_date = ] count_reset_date

Reimposta la data dell'ultimo azzeramento del numero di occorrenze. @count_reset_date è int, con il valore predefinito .NULL

[ @count_reset_time = ] count_reset_time

Reimposta l'ora dell'ultimo azzeramento del numero di occorrenze. @count_reset_time è int, con un valore predefinito .NULL

[ @last_occurrence_date = ] last_occurrence_date

Reimposta la data dell'ultima occorrenza dell'avviso. @last_occurrence_date è int, con un valore predefinito , NULLe può essere impostato solo su 0.

[ @last_occurrence_time = ] last_occurrence_time

Reimposta l'ora dell'ultima occorrenza dell'avviso. @last_occurrence_time è int, con un valore predefinito e NULLpuò essere impostato solo su 0.

[ @last_response_date = ] last_response_date

Reimposta la data dell'ultima risposta all'avviso inviata dal servizio SQLServerAgent. @last_response_date è int, con un valore predefinito , NULLe può essere impostato solo su 0.

[ @last_response_time = ] last_response_time

Reimposta l'ora dell'ultima risposta all'avviso inviata dal servizio SQLServerAgent. @last_response_time è int, con un valore predefinito , NULLe può essere impostato solo su 0.

[ @raise_snmp_trap = ] raise_snmp_trap

Identificato solo a scopo informativo. Non supportato. Non è garantita la compatibilità con le versioni future.

[ @performance_condition = ] N'performance_condition'

Valore espresso nel formato <itemcomparatorvalue>. @performance_condition è nvarchar(512)e è costituito dagli elementi seguenti.

Componente del formato Descrizione
Articolo Oggetto prestazioni, contatore delle prestazioni o istanza denominata del contatore
Comparatore Uno di questi operatori: >, <, =
valore Valore numerico del contatore

[ @category_name = ] N'category_name'

Nome della categoria di avvisi. @category_name è sysname, con un valore predefinito .NULL

[ @wmi_namespace = ] N'wmi_namespace'

Spazio dei nomi WMI in cui eseguire query per gli eventi. @wmi_namespace è sysname, con il valore predefinito NULL.

[ @wmi_query = ] N'wmi_query'

Query che consente di specificare l'evento WMI per l'avviso. @wmi_query è nvarchar(512), con un valore predefinito .NULL

Valori del codice restituito

0 (esito positivo) o 1 (errore).

Osservazioni:

Solo sysmessages scritto nel registro applicazioni di Windows può generare un avviso.

sp_update_alert modifica solo le impostazioni di avviso per le quali vengono specificati i valori dei parametri. Se si omette un parametro, viene mantenuta l'impostazione corrente.

Autorizzazioni

Per eseguire questa stored procedure, gli utenti devono essere membri del ruolo predefinito del server sysadmin .

Esempi

Nell'esempio seguente l'impostazione di abilitazione di Test Alert viene sostituita con 0.

USE msdb;
GO

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

Contenuto correlato