sp_help_alert (Transact-SQL)

Restituisce informazioni sugli avvisi definiti per il server.

Convenzioni della sintassi Transact-SQL

Sintassi

sp_help_alert [ [ @alert_name = ] 'alert_name' ] 
     [ , [ @order_by = ] 'order_by' ] 
     [ , [ @alert_id = ] alert_id ] 
     [ , [ @category_name = ] 'category' ] 
     [ , [ @legacy_format = ] legacy_format ]

Argomenti

• [ @alert_name =] 'alert_name'
  Nome dell'avviso. alert_name è di tipo nvarchar(128). Se alert_name viene omesso, vengono restituite informazioni su tutti gli account di accesso.

• [ @order_by =] 'order_by'
  Criterio da applicare per l'ordinamento dei risultati. order_byè di tipo sysname e il valore predefinito è N 'name'.

• [ @alert_id =] alert_id
  Numero di identificazione dell'avviso su cui si desidera ottenere informazioni. alert_id è di tipo int e il valore predefinito è NULL.

• [ @category_name =] 'category'
  Categoria dell'avviso. category è di tipo sysname e il valore predefinito è NULL.

• [ @legacy_format=] legacy_format
  Indica se generare un set di risultati legacy. legacy_format è bit, con valore predefinito 0. Quando legacy_format è 1, sp_help_alert restituisce il set di risultati restituito da sp_help_alert in Microsoft SQL Server 2000.

Valori restituiti

0 (esito positivo) o 1 (esito negativo)

Set di risultati

Quando @legacy_format è 0, sp_help_alert restituisce il set di risultati seguente.

Nome colonna	Tipo di dati	Descrizione
id	int	Identificatore univoco di tipo integer assegnato dal sistema.
name	sysname	Nome dell'avviso, ad esempio Demo: Full msdb log.
event_source	nvarchar(100)	Origine dell'evento. In Microsoft SQL Server versione 7.0 è sempre MSSQLServer.
event_category_id	int	Identificato solo a scopo informativo. Non supportato. Non è garantita la compatibilità con le versioni future.
event_id	int	Identificato solo a scopo informativo. Non supportato. Non è garantita la compatibilità con le versioni future.
message_id	int	Numero dell'errore del messaggio che definisce l'avviso (corrisponde in genere a un numero di errore della tabella sysmessages). Se l'avviso viene definito in base al livello di gravità, message_id è 0 o NULL.
severity	int	Livello di gravità, compreso tra 9 e 25, 110, 120, 130 o 140, che definisce l'avviso.
enabled	tinyint	Stato che indica se l'avviso è abilitato (1) o meno (0). Gli avvisi non abilitati non vengono inviati.
delay_between_responses	int	Periodo di attesa in secondi tra risposte successive per l'avviso.
last_occurrence_date	int	Data dell'ultima generazione dell'avviso.
last_occurrence_time	int	Ora dell'ultima generazione dell'avviso.
last_response_date	int	Data dell'ultima risposta all'avviso inviata dal servizio SQLServerAgent.
last_response_time	int	Ora dell'ultima risposta all'avviso inviata dal servizio SQLServerAgent.
notification_message	nvarchar(512)	Messaggio aggiuntivo facoltativo inviato all'operatore come parte della notifica tramite posta elettronica o cercapersone.
include_event_description	tinyint	Indica se la descrizione dell'errore di SQL Server inclusa nel registro applicazioni di Microsoft Windows deve essere inserita nel messaggio di notifica.
database_name	sysname	Database in cui deve verificarsi l'errore affinché l'avviso venga generato. Se il nome del database è NULL, l'avviso viene generato indipendentemente dal database in cui l'errore si verifica.
event_description_keyword	nvarchar(100)	Descrizione dell'errore di SQL Server inclusa nel registro applicazioni di Windows, che deve corrispondere alla sequenza di caratteri specificata.
occurrence_count	int	Numero di volte che l'avviso è stato generato.
count_reset_date	int	Data dell'ultima reimpostazione di occurrence_count.
count_reset_time	int	Ora dell'ultima reimpostazione di occurrence_count.
job_id	uniqueidentifier	Numero di identificazione del processo da eseguire in risposta a un avviso.
job_name	sysname	Nome del processo da eseguire in risposta a un avviso.
has_notification	int	È diverso da zero se uno o più operatori ricevono una notifica dell'avviso. Può essere uno o più d'uno dei valori seguenti uniti dall'operatore OR: 1 = notifica tramite posta elettronica 2 = notifica tramite cercapersone 4=notifica net send.
flags	int	Identificato solo a scopo informativo. Non supportato. Non è garantita la compatibilità con le versioni future.
performance_condition	nvarchar(512)	Se type è 2, questa colonna mostra la definizione della condizione delle prestazioni. In caso contrario, la colonna è NULL.
category_name	sysname	Identificato solo a scopo informativo. Non supportato. Non è garantita la compatibilità con le versioni future. In SQL Server 7.0 è sempre '[Uncategorized]'.
wmi_namespace	sysname	Se type è 3 in questa colonna viene visualizzato lo spazio dei nomi per l'evento WMI.
wmi_query	nvarchar(512)	Se type è 3 in questa colonna viene visualizzata la query per l'evento WMI.
tipo	int	Tipo dell'evento: 1 = avviso relativo a un evento SQL Server 2 = avviso relativo alle prestazioni di SQL Server 3 = avviso relativo a un evento WMI

Quando @legacy_format è 1, sp_help_alert restituisce il set di risultati seguente:

Nome colonna	Tipo di dati	Descrizione
id	int	Identificatore univoco di tipo integer assegnato dal sistema.
name	sysname	Nome dell'avviso, ad esempio Demo: Full msdb log.
event_source	nvarchar(100)	Origine dell'evento. In SQL Server versione 7.0 è sempre MSSQLServer.
event_category_id	int	Identificato solo a scopo informativo. Non supportato. Non è garantita la compatibilità con le versioni future.
event_id	int	Identificato solo a scopo informativo. Non supportato. Non è garantita la compatibilità con le versioni future.
message_id	int	Numero dell'errore del messaggio che definisce l'avviso (corrisponde in genere a un numero di errore della tabella sysmessages). Se l'avviso viene definito in base al livello di gravità, message_id è 0 o NULL.
severity	int	Livello di gravità, compreso tra 9 e 25, 110, 120, 130 o 140, che definisce l'avviso.
enabled	tinyint	Stato che indica se l'avviso è abilitato (1) o meno (0). Gli avvisi non abilitati non vengono inviati.
delay_between_responses	int	Periodo di attesa in secondi tra risposte successive per l'avviso.
last_occurrence_date	int	Data dell'ultima generazione dell'avviso.
last_occurrence_time	int	Ora dell'ultima generazione dell'avviso.
last_response_date	int	Data dell'ultima risposta all'avviso inviata dal servizio SQLServerAgent.
last_response_time	int	Ora dell'ultima risposta all'avviso inviata dal servizio SQLServerAgent.
notification_message	nvarchar(512)	Messaggio aggiuntivo facoltativo inviato all'operatore come parte della notifica tramite posta elettronica o cercapersone.
include_event_description	tinyint	Indica se la descrizione dell'errore di SQL Server inclusa nel registro applicazioni di Windows deve essere inserita nel messaggio di notifica.
database_name	sysname	Database in cui deve verificarsi l'errore affinché l'avviso venga generato. Se il nome del database è NULL, l'avviso viene generato indipendentemente dal database in cui l'errore si verifica.
event_description_keyword	nvarchar(100)	Descrizione dell'errore di SQL Server inclusa nel registro applicazioni di Windows, che deve corrispondere alla sequenza di caratteri specificata.
occurrence_count	int	Numero di volte che l'avviso è stato generato.
count_reset_date	int	Data dell'ultima reimpostazione di occurrence_count.
count_reset_time	int	Ora dell'ultima reimpostazione di occurrence_count.
job_id	uniqueidentifier	Numero di identificazione del processo.
job_name	sysname	Processo su richiesta da eseguire in risposta a un avviso.
has_notification	int	È diverso da zero se uno o più operatori ricevono una notifica dell'avviso. Può essere uno o più d'uno dei valori seguenti uniti dall'operatore OR: 1 = notifica tramite posta elettronica 2 = notifica tramite cercapersone 4=notifica net send.
flags	int	Identificato solo a scopo informativo. Non supportato. Non è garantita la compatibilità con le versioni future..
performance_condition	nvarchar(512)	Se type è 2 questa colonna mostra la definizione della condizione delle prestazioni. Se type è 3 in questa colonna viene visualizzata la query per l'evento WMI. Negli altri casi la colonna è NULL.
category_name	sysname	Identificato solo a scopo informativo. Non supportato. Non è garantita la compatibilità con le versioni future. In SQL Server 7.0 è sempre '[Uncategorized]'.
tipo	int	Tipo di avviso: 1 = avviso relativo a un evento SQL Server 2 = avviso relativo alle prestazioni di SQL Server 3 = avviso relativo a un evento WMI

Osservazioni

La stored procedure sp_help_alert deve essere eseguita dal database msdb.

Autorizzazioni

Per impostazione predefinita, questa stored procedure può essere eseguita dai membri del ruolo predefinito del server sysadmin. Gli altri utenti devono appartenere al ruolo predefinito del database SQLAgentOperatorRole nel database msdb.

Per informazioni su SQLAgentOperatorRole, vedere Ruoli di database predefiniti di SQL Server Agent.

Esempi

Nell'esempio seguente vengono restituite informazioni sull'avviso Demo: Sev. 25 Errors.

USE msdb ;
GO

EXEC sp_help_alert @alert_name = 'Demo: Sev. 25 Errors'
GO

Vedere anche

Riferimento

sp_add_alert (Transact-SQL)

sp_update_alert (Transact-SQL)

Stored procedure di sistema (Transact-SQL)