sp_help_notification (Transact-SQL)

Restituisce un elenco di avvisi per un determinato operatore o un elenco di operatori per un determinato avviso.

Icona di collegamento a un argomentoConvenzioni della sintassi Transact-SQL

Sintassi

sp_help_notification
     [ @object_type = ] 'object_type' ,
     [ @name = ] 'name' ,
     [ @enum_type = ] 'enum_type' , 
     [ @notification_method = ] notification_method 
     [ , [ @target_name = ] 'target_name' ] 

Argomenti

  • [ @object_type =] 'object_type'
    Tipo di informazioni da restituire. object_typeè di tipo char(9) e non prevede alcun valore predefinito. I possibili valori di object_type sono ALERTS, con cui vengono elencati gli avvisi assegnati al nome dell'operatore specificato*,* e OPERATORS, con cui vengono elencati gli operatori responsabili del nome di avviso specificato*.*

  • [ @name =] 'name'
    Nome di un operatore (se object_type è OPERATORS) o nome di un avviso (se object_type è ALERTS). name è di tipo sysname e non prevede alcun valore predefinito.

  • [ @enum_type =] 'enum_type'
    Informazioni su object_typerestituite. Nella maggior parte dei casi, enum_type è impostato su ACTUAL. enum_typeè di tipo char(10) e non prevede alcun valore predefinito. I possibili valori sono i seguenti.

    Valore

    Descrizione

    ACTUAL

    Elenca solo gli object_types associati a name.

    ALL

    Elenca tutti gliobject_types, inclusi quelli non associati a name.

    TARGET

    Elenca solo gli object_types che corrispondono al target_name specificato, indipendentemente dall'associazione aname.

  • [ @notification_method =] notification_method
    Valore numerico che determina le colonne da restituire relative al metodo di notifica. notification_method è di tipo tinyint e i possibili valori sono i seguenti.

    Valore

    Descrizione

    1

    Posta elettronica: restituisce solo la colonna use_email.

    2

    Cercapersone: restituisce solo la colonna use_pager.

    4

    NetSend: restituisce solo la colonna use_netsend.

    7

    Tutto: restituisce tutte le colonne.

  • [ @target_name =] 'target_name'
    Nome di un avviso da cercare (se object_type è impostato su ALERTS) oppure nome di un operatore da cercare (se object_type è impostato su OPERATORS). È necessario specificare target_name solo se enum_type è impostato su TARGET. target_name è di tipo sysname e il valore predefinito è NULL.

Valori restituiti

0 (esito positivo) o 1 (esito negativo)

Set di risultati

Se object_type è impostato su ALERTS, il set di risultati include tutti gli avvisi per un determinato operatore.

Nome colonna

Tipo di dati

Descrizione

alert_id

int

Numero di identificazione dell'avviso.

alert_name

sysname

Nome dell'avviso.

use_email

int

Specifica se il metodo di notifica utilizzato è la posta elettronica:

1 = sì

0 = no

use_pager

int

Specifica se il metodo di notifica utilizzato è il cercapersone:

1 = sì

0 = no

use_netsend

int

Specifica se il metodo di notifica utilizzato è NetSend:

1 = sì

0 = no

has_email

int

Numero di notifiche inviate tramite posta elettronica per l'avviso specificato.

has_pager

int

Numero di notifiche inviate tramite cercapersone per l'avviso specificato.

has_netsend

int

Numero di notifiche net send per l'avviso specificato.

Se object_type è OPERATORS, il set di risultati include tutti gli operatori per un determinato avviso.

Nome colonna

Tipo di dati

Descrizione

operator_id

int

Numero di identificazione dell'operatore.

operator_name

sysname

Nome dell'operatore.

use_email

int

Specifica se il metodo di notifica utilizzato è la posta elettronica:

1 = sì

0 = no

use_pager

int

Specifica se il metodo di notifica utilizzato è il cercapersone:

1 = sì

0 = no

use_netsend

int

Specifica se il metodo di notifica utilizzato è NetSend:

1 = sì

0 = no

has_email

int

Specifica se all'operatore è associato un indirizzo di posta elettronica:

1 = sì

0 = no

has_pager

int

Specifica se all'operatore è associato un indirizzo cercapersone:

1 = sì

0 = no

has_netsend

int

Specifica se per l'operatore è stata specificata la notifica tramite Net Send.

1 = sì

0 = no

Osservazioni

Questa stored procedure deve essere eseguita nel database msdb.

Autorizzazioni

Per eseguire questa stored procedure, è necessario che gli utenti siano membri del ruolo predefinito del server sysadmin.

Esempi

A. Visualizzazione di un elenco di avvisi per un operatore specifico

Nell'esempio seguente vengono restituiti tutti gli avvisi per i quali François Ajenstat riceve una notifica.

USE msdb ;
GO

EXEC dbo.sp_help_notification 
    @object_type = N'ALERTS',
    @name = N'François Ajenstat',
    @enum_type = N'ACTUAL',
    @notification_method = 7 ;
GO

B. Visualizzazione di un elenco di operatori per un avviso specifico

Nell'esempio seguente vengono restituiti tutti gli operatori che ricevono una notifica per l'avviso Test Alert.

USE msdb ;
GO

EXEC sp_help_notification
    @object_type = N'OPERATORS',
    @name = N'Test Alert',
    @enum_type = N'ACTUAL',
    @notification_method = 7 ;
GO