sp_help_alert (Transact-SQL)

Si applica a:SQL Server

Restituisce informazioni sugli avvisi definiti per il server.

Convenzioni relative alla sintassi Transact-SQL

Sintassi

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

Argomenti

[ @alert_name = ] N'alert_name'

Nome dell'avviso. @alert_name è nvarchar(128). Se non viene specificato @alert_name , vengono restituite informazioni su tutti gli avvisi.

[ @order_by = ] N'order_by'

Criterio da applicare per l'ordinamento dei risultati. @order_by è sysname, con un valore predefinito del @alert_name.

[ @alert_id = ] alert_id

Numero di identificazione dell'avviso su cui si desidera ottenere informazioni. @alert_id è int, con il valore predefinito NULL.

[ @category_name = ] N'category'

Categoria dell'avviso. @category è sysname, con un valore predefinito .NULL

[ @legacy_format = ] legacy_format

Indica se produrre un set di risultati legacy. @legacy_format è bit, con un valore predefinito .0 Quando @legacy_format è 1, sp_help_alert restituisce il set di risultati restituito da sp_help_alert in SQL Server 2000 (8,x).

Valori del codice restituito

0 (esito positivo) o 1 (errore).

Set di risultati

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

Nome colonna Tipo di dati Descrizione
id int Identificatore univoco di tipo integer assegnato dal sistema.
name sysname Nome avviso (ad esempio, Demo: log completo msdb ).
event_source nvarchar(100) Origine dell'evento. Sarà sempre MSSQLServer per Microsoft SQL Server versione 7.0
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 (in genere corrisponde a un numero di errore nella sysmessages tabella). Se viene usata la gravità per definire l'avviso, message_id è 0 o NULL.
severity int Livello di gravità (da 9 a 25, 120110, 130, o 140) che definisce l'avviso.
enabled tinyint Stato del fatto che l'avviso sia attualmente abilitato (1) o meno (0). Non viene inviato un avviso non raggiungibile.
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 dell'avviso da parte del servizio SQL Server Agent.
last_response_time int Ora dell'ultima risposta dell'avviso da parte del servizio SQL Server Agent.
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 dalla posizione in cui si è verificato l'errore.
event_description_keyword nvarchar(100) Descrizione dell'errore di SQL Server nel registro applicazioni di Windows che deve essere simile alla sequenza di caratteri fornita.
occurrence_count int Numero di volte che l'avviso è stato generato.
count_reset_date int Data dell'ultima occurrence_count reimpostazione.
count_reset_time int Ora dell'ultima occurrence_count reimpostazione.
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. Il valore è uno o più dei valori seguenti (ORed together):

1=ha una notifica tramite posta elettronica
2=ha una notifica di cercapersone
4= ha net send una notifica.
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 di 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. Sarà sempre '[Uncategorized]' per SQL Server 7.0.
wmi_namespace sysname Se type è 3, questa colonna mostra lo spazio dei nomi per l'evento WMI.
wmi_query nvarchar(512) Se type è 3, questa colonna mostra la query per l'evento WMI.
type int Tipo dell'evento:

1 = Avviso per gli eventi di SQL Server
2 = Avviso di prestazioni di SQL Server
3 = Avviso di evento WMI

Quando @legacy_format è 1, sp_help_alert produce il set di risultati seguente.

Nome colonna Tipo di dati Descrizione
id int Identificatore univoco di tipo integer assegnato dal sistema.
name sysname Nome avviso (ad esempio, Demo: log completo msdb ).
event_source nvarchar(100) Origine dell'evento. Sarà sempre MSSQLServer per SQL Server versione 7.0
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 (in genere corrisponde a un numero di errore nella sysmessages tabella). Se viene usata la gravità per definire l'avviso, message_id è 0 o NULL.
severity int Livello di gravità (da 9 a 25, 120110, 130, o 140) che definisce l'avviso.
enabled tinyint Stato del fatto che l'avviso sia attualmente abilitato (1) o meno (0). Non viene inviato un avviso non raggiungibile.
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 dell'avviso da parte del servizio SQL Server Agent.
last_response_time int Ora dell'ultima risposta dell'avviso da parte del servizio SQL Server Agent.
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 dal registro applicazioni di Windows deve essere inclusa come parte del 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 dalla posizione in cui si è verificato l'errore.
event_description_keyword nvarchar(100) Descrizione dell'errore di SQL Server nel registro applicazioni di Windows che deve essere simile alla sequenza di caratteri fornita.
occurrence_count int Numero di volte che l'avviso è stato generato.
count_reset_date int Data dell'ultima occurrence_count reimpostazione.
count_reset_time int Ora dell'ultima occurrence_count reimpostazione.
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=ha una notifica tramite posta elettronica
2=ha una notifica di cercapersone
4=ha net send una notifica.
flags int Identificato solo a scopo informativo. Non supportato. La compatibilità futura non è garantita.
performance_condition nvarchar(512) Se type è 2, questa colonna mostra la definizione della condizione di prestazioni. Se type è 3, questa colonna mostra la query per l'evento WMI. In caso contrario, la colonna è NULL.
category_name sysname Identificato solo a scopo informativo. Non supportato. Non è garantita la compatibilità con le versioni future. Sarà sempre [Uncategorized] per SQL Server 7.0.
type int Tipo di avviso:

1 = Avviso per gli eventi di SQL Server
2 = Avviso di prestazioni di SQL Server
3 = Avviso di evento WMI

Osservazioni:

sp_help_alert deve essere eseguito dal msdb database.

Autorizzazioni

Per impostazione predefinita, questa stored procedure può essere eseguita dai membri del ruolo predefinito del server sysadmin . È necessario concedere ad altri utenti il ruolo predefinito del database SQLAgentOperatorRole nel msdb database.

Per informazioni dettagliate su SQLAgentOperatorRole, vedere Ruoli predefiniti del database 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