sp_help_notification (Transact-SQL)

Aplica-se a:SQL Server

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

Convenções de sintaxe de 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 do operador fornecido*,* ou OPERATORS, que lista os operadores responsáveis pelo nome do 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 object_typeretornadas. enum_type é REAL na maioria dos casos. enum_typeé char(10), sem padrão, e pode ser um desses valores.

Valor	Descrição
ACTUAL	Lista apenas os object_types associados ao nome.
ALL	Lista todos osobject_types incluindo aqueles que não estão associados ao nome.
TARGET	Lista apenas os object_types correspondentes aos target_name fornecidos, independentemente da associação como nome.

[ @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 será necessário somente se enum_type for TARGET. target_name é sysname, com um padrão de NULL.

Valores de código de retorno

0 (êxito) ou 1 (falha)

Conjuntos de resultados

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

Nome da coluna	Tipo de dados	Descrição
alert_id	int	Número de identificador de alerta.
alert_name	sysname	Nome do 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 de envio líquido 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

Esse procedimento armazenado deve ser executado no 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  

Consulte Também

sp_add_notification (Transact-SQL)
sp_delete_notification (Transact-SQL)
sp_update_notification (Transact-SQL)
Procedimentos armazenados do sistema (Transact-SQL)