sp_update_alert (Transact-SQL)

Aggiorna le impostazioni di un avviso esistente.

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. Tale nome deve essere univoco. new_name è di tipo sysname e il valore predefinito è NULL.

• [ @enabled =] enabled
  Specifica se l'avviso è abilitato (1) o disabilitato (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	Tutti

• [ @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 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 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: >, <, =
  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 specifica 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 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)