sp_help_alert (Transact-SQL)

Restituisce informazioni sugli avvisi definiti per il server.

Icona di collegamento a un argomentoConvenzioni 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 è di tipo bit e il 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 è attivato (1) o meno (0). Gli avvisi non attivati 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.

type

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 è attivato (1) o meno (0). Gli avvisi non attivati 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]'.

type

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