sp_update_alert (Transact-SQL)
Aggiorna le impostazioni di un avviso esistente.
.gif "Icona di collegamento a un argomento")
Convenzioni della sintassi Transact-SQL
Sintassi
sp_update_alert
[ @name =] 'name'
[ , [ @new_name =] 'new_name']
[ , [ @enabled =] enabled]
[ , [ @message_id =] message_id]
[ , [ @severity =] severity]
[ , [ @delay_between_responses =] delay_between_responses]
[ , [ @notification_message =] 'notification_message']
[ , [ @include_event_description_in =] include_event_description_in]
[ , [ @database_name =] 'database']
[ , [ @event_description_keyword =] 'event_description_keyword']
[ , [ @job_id =] job_id | [@job_name =] '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 =] 'performance_condition' ]
[ , [ @category_name =] 'category']
[ , [ @wmi_namespace = ] 'wmi_namespace' ]
[ , [ @wmi_query = ] 'wmi_query' ]
Argomenti
[ @name =] 'name'
Nome dell'avviso da aggiornare. name è di tipo sysname e non prevede alcun valore predefinito.[ @new_name =] 'new_name'
Nuovo nome per l'avviso. Il nome deve essere univoco. new_name è di tipo sysname e il valore predefinito è NULL.[ @enabled =] enabled
Specifica se l'avviso è abilitato (1) o disattivato (0). enabled è di tipo tinyint e il 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 è di tipo int e il valore predefinito è NULL. È possibile specificare un ID di messaggio solo se il livello di gravità dell'avviso è impostato su 0.[ @severity =] severity
Nuovo livello di gravità (da 1 a 25) per la definizione dell'avviso. L'avviso viene attivato da qualsiasi messaggio di Microsoft SQL Server inviato al registro applicazioni di Windows con il livello di gravità specificato. severity è di tipo int e il valore predefinito è NULL. È possibile specificare un livello di gravità solo se l'ID di messaggio dell'avviso è impostato su 0.[ @delay_between_responses =] delay_between_responses
Nuovo intervallo di attesa, in secondi, che intercorre tra le risposte all'avviso. delay_between_responses è di tipo int e il valore predefinito è NULL.[ @notification_message =] 'notification_message'
Testo modificato di un messaggio aggiuntivo inviato all'operatore nell'ambito della notifica per posta elettronica, net send o cercapersone. notification_message è di tipo nvarchar(512) e il valore predefinito è NULL.[ @include_event_description_in =] include_event_description_in
Specifica se includere o meno la descrizione dell'errore di SQL Server del registro applicazioni di Windows nel messaggio di notifica. include_event_description_in è di tipo tinyint e il valore predefinito è NULL. I valori possibili sono riportati di seguito.Valore
Descrizione
0
Nessuno
1
Posta elettronica
2
Cercapersone
4
net send
7
Tutto
[ @database_name =] 'database'
Nome del database nel quale deve verificarsi l'errore affinché l'avviso venga generato. database è di tipo sysname. Non sono consentiti nomi racchiusi tra parentesi quadre ([]). Il valore predefinito è NULL.[ @event_description_keyword =] 'event_description_keyword'
Sequenza di caratteri che è necessario individuare nella descrizione dell'errore inclusa nel log dei messaggi di errore. È possibile utilizzare i caratteri dei criteri di ricerca dell'espressione LIKE Transact-SQL. event_description_keyword è di tipo nvarchar(100) e il valore predefinito è NULL. Questo parametro risulta utile per l'applicazione di filtri ai nomi di oggetto, ad esempio %customer_table%.[ @job_id =] job_id
Numero di identificazione del processo. job_id è di tipo uniqueidentifier e il valore predefinito è NULL. Se si specifica job_id, è necessario omettere job_name.[ @job_name =] 'job_name'
Nome del processo che viene eseguito in risposta all'avviso. job_name è di tipo sysname e il valore predefinito è NULL. Se si specifica job_name, è necessario omettere job_id.[ @occurrence_count = ] occurrence_count
Reimposta il numero di occorrenze dell'avviso. occurrence_count è di tipo int e il valore predefinito è NULL. L'unico valore valido è 0.[ @count_reset_date =] count_reset_date
Reimposta la data dell'ultimo azzeramento del numero di occorrenze. count_reset_date è di tipo int e il valore predefinito è NULL.[ @count_reset_time =] count_reset_time
Reimposta l'ora dell'ultimo azzeramento del numero di occorrenze. count_reset_time è di tipo int e il valore predefinito è NULL.[ @last_occurrence_date =] last_occurrence_date
Reimposta la data dell'ultima occorrenza dell'avviso. last_occurrence_date è di tipo int e il valore predefinito è NULL. L'unico valore valido è 0.[ @last_occurrence_time =] last_occurrence_time
Reimposta l'ora dell'ultima occorrenza dell'avviso. last_occurrence_time è di tipo int e il valore predefinito è NULL. L'unico valore valido è 0.[ @last_response_date =] last_response_date
Reimposta la data dell'ultima risposta all'avviso inviata dal servizio SQLServerAgent. last_response_date è di tipo int e il valore predefinito è NULL. L'unico valore valido è 0.[ @last_response_time =] last_response_time
Reimposta l'ora dell'ultima risposta all'avviso inviata dal servizio SQLServerAgent. last_response_time è di tipo int e il valore predefinito è NULL. L'unico valore valido è 0.[ @raise_snmp_trap =] raise_snmp_trap
Riservato.[ @performance_condition =] 'performance_condition'
Valore espresso nel formato 'itemcomparatorvalue'. performance_condition è di tipo nvarchar(512) e il valore predefinito è NULL. È costituito dagli elementi seguenti.Elemento del formato
Descrizione
Item
Oggetto prestazioni, contatore delle prestazioni o istanza denominata del contatore
Comparator
Uno degli operatori seguenti: >, <, =
Value
Valore numerico del contatore
[ @category_name =] 'category'
Nome della categoria di avvisi. category è di tipo sysname e il valore predefinito è NULL.[ @wmi_namespace= ] 'wmi_namespace'
Spazio dei nomi WMI in cui eseguire query per gli eventi. wmi_namespace è di tipo sysname e il valore predefinito è NULL.[ @wmi_query= ] 'wmi_query'
Query che consente di specificare l'evento WMI per l'avviso. wmi_query è di tipo nvarchar(512) e il valore predefinito è NULL.
Valori restituiti
0 (esito positivo) o 1 (esito negativo)
Osservazioni
Gli avvisi vengono generati solo dai messaggi sysmessages scritti nel registro applicazioni di Microsoft Windows.
Tramite sp_update_alert vengono modificate solo le impostazioni di avviso per le quali sono stati specificati valori di parametro. Se si omette un parametro, viene conservata l'impostazione corrente.
Autorizzazioni
Per eseguire questa stored procedure, è necessario che gli utenti siano 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