sp_update_alert (Transact-SQL)
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 |
|
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