Artigo
09/28/2010

sp_help_notification (Transact-SQL)

Informa uma lista de alertas para determinado operador ou uma lista de operadores para um determinado alerta.

Ícone de vínculo de tópico Convenções de sintaxe Transact-SQL

Sintaxe

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

Argumentos

[ @object_type =] 'object_type'
O tipo de informação a ser retornado. object_typeé char(9), sem padrão. object_type pode ser ALERTS, que lista os alertas atribuídos ao nome de operador fornecido*,* ou OPERATORS, que lista os operadores responsáveis pelo nome de alerta fornecido*.*
[ @name =] 'name'
Um nome de operador (se object_type for OPERATORS) ou um nome de alerta (se object_type for ALERTS). name é sysname, sem padrão.

[ @enum_type =] 'enum_type'
As informações de object_typeque são retornadas. enum_type é ACTUAL na maioria dos casos. enum_typeé char(10), sem padrão, e pode ser um destes valores.

Valor	Descrição
ACTUAL	Lista apenas os object_types associados a name.
ALL	Lista todos osobject_types incluindo aqueles que não estão associados a name.
TARGET	Lista apenas os object_types que correspondem ao target_namefornecido, independentemente da associação comname.

[ @notification_method =] notification_method
Um valor numérico que determina as colunas do método de notificação a serem retornadas. notification_method é tinyint e pode ser um dos valores a seguir.

Valor	Descrição
1	Email: retorna apenas a coluna use_email.
2	Pager: retorna apenas a coluna use_pager.
4	NetSend: retorna apenas a coluna use_netsend.
7	Tudo: retorna todas as colunas.

[ @target_name =] 'target_name'
Um nome de alerta a ser pesquisado (se object_type for ALERTS) ou um nome de operador a ser pesquisado (se object_type for OPERATORS). target_name é necessário apenas se enum_type for TARGET. target_name é sysname, com um padrão NULL.

Valores de código de retorno

0 (êxito) ou 1 (falha)

Conjuntos de resultados

Se object_type for ALERTS, o conjunto de resultados listará todos os alertas para um determinado operador.

Nome da coluna	Tipo de dados	Descrição
alert_id	int	Número de identificador de alerta.
alert_name	sysname	Nome de alerta.
use_email	int	Email é usado para notificar o operador: 1 = Sim 0 = Não
use_pager	int	Pager é usado para notificar o operador: 1 = Sim 0 = Não
use_netsend	int	Pop-up de rede é usado para notificar o operador: 1 = Sim 0 = Não
has_email	int	Número de notificações de email enviadas para esse alerta.
has_pager	int	Número de notificações de pager enviadas para esse alerta.
has_netsend	int	Número de notificações net send enviadas para esse alerta.

Se object_type for OPERATORS, o conjunto de resultados listará todos os operadores para um determinado alerta.

Nome da coluna	Tipo de dados	Descrição
operator_id	int	Número de identificação do operador.
operator_name	sysname	Nome do operador.
use_email	int	O email é usado para enviar uma notificação ao operador: 1 = Sim 0 = Não
use_pager	int	O pager é usado para enviar uma notificação ao operador: 1 = Sim 0 = Não
use_netsend	int	É um pop-up de rede usado para notificar o operador: 1 = Sim 0 = Não
has_email	int	O operador tem um endereço de email: 1 = Sim 0 = Não
has_pager	int	O operador tem um endereço de pager: 1 = Sim 0 = Não
has_netsend	int	O operador tem uma notificação net send configurada. 1 = Sim 0 = Não

Comentários

Este procedimento armazenado deve ser executado a partir do banco de dados msdb.

Permissões

Para executar este procedimento armazenado, o usuário deve ser um membro da função de servidor fixa sysadmin.

Exemplos

A. Listando alertas para um operador específico

O exemplo a seguir retorna todos os alertas para os quais o operador François Ajenstat recebe qualquer tipo de notificação.

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. Listando operadores para um alerta específico

O exemplo a seguir retorna todos os operadores que recebem qualquer tipo de notificação para o alerta 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