sp_update_alert (Transact-SQL)
Aggiorna le impostazioni di un avviso esistente.
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_name']
[ , [ @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 è sysname, senza alcun valore predefinito.
- [ @new_name =] 'new_name'
Nuovo nome per l'avviso. Deve essere un nome univoco. new_name è di tipo sysname e il valore predefinito è NULL.
- [ @enabled =] enabled
Specifica se l'avviso è attivato (1) o disattivato (0). enabled è tinyint, con valore predefinito NULL. Per consentire la generazione di un avviso, è necessario che l'avviso sia attivato.
- [ @message_id =] message_id
Nuovo messaggio o numero di errore per la definizione dell'avviso. message_id corrisponde in genere a un numero di errore della tabella sysmessages). message_id è di tipo int, con valore predefinito di 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 dai messaggi di Microsoft SQL Server inviati al registro applicazioni di Windows aventi 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
Il nuovo intervallo di attesa, in secondi, che intercorre tra le varie risposte per l'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 SQL Server del registro applicazioni di Windows nel messaggio di notifica. include_event_description_in è di tipo tinyint e il valore predefinito è NULL. I possibili valori sono i seguenti.Valore Descrizione 0
Nessuno
1
Posta elettronica
2
Cercapersone
4
net send
7
Tutti
- [ @database_name =] 'database_name'
Nome del database in cui deve verificarsi l'errore affinché l'avviso possa essere generato. database_name è di tipo sysname e 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 di 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 anche job_name.
- [ @job_name =] 'job_name'
Nome del processo da eseguire in risposta all'avviso. job_name è di tipo sysname e il valore predefinito è NULL. Se si specifica job_name, è necessario omettere anche 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 in cui si è verificato l'ultimo 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'orario in cui si è verificato l'ultimo 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 per l'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 per l'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'
Un valore espresso nel formato 'itemcomparatorvalue'. performance_condition è di tipo nvarchar(512) e il valore predefinito è NULL. È costituito dagli elementi seguenti.Componente del formato Descrizione Item
Oggetto prestazioni, contatore delle prestazioni o istanza denominata del contatore
Comparator
Uno degli operatori: >, <, =
Value
Valore numerico del contatore
- [ @category_name =] 'category'
Nome della categoria di avvisi. category è di tipo sysname con 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 specifica l'evento WMI per l'avviso. wmi_query è di tipo nvarchar(512) e il valore predefinito è NULL.
Osservazioni
Gli avvisi vengono generati solo dai messaggi sysmessages inclusi 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.
Valori restituiti
0 (esito positivo) o 1 (esito negativo)
Esempi
Nell'esempio seguente l'impostazione di attivazione di Test Alert viene sostituita con 0.
USE msdb ;
GO
EXEC dbo.sp_update_alert
@name = N'Test Alert',
@enabled = 0 ;
GO
Vedere anche
Riferimento
sp_add_alert (Transact-SQL)
sp_help_alert (Transact-SQL)
Stored procedure di sistema (Transact-SQL)