sp_help_operator (Transact-SQL)

Relata informações sobre os operadores definidos para o servidor.

Convenções da sintaxe Transact-SQL

Sintaxe

sp_help_operator
     { [ @operator_name = ] 'operator_name' 
     | [ @operator_id = ] operator_id }

Argumentos

• [ @operator_name= ] 'operator_name'
  O nome do operador. operator_name é sysname. Se o operator_name não for especificado, serão retornadas informações sobre todos os operadores.

• [ @operator_id= ] operator_id
  O número de identificação do operador para o qual as informações são solicitadas. operator_id é int, com um padrão de NULL.

  Observação
  É necessário especificar a operator_id ou o operator_name, mas não é possível especificar ambos ao mesmo tempo.

Valores de código de retorno

0 (êxito) ou 1 (falha)

Conjuntos de resultados

Nome da coluna	Tipo de dados	Descrição
id	int	Número de identificação do operador.
nome	sysname	Nome do operador.
habilitado	tinyint	Operador está disponível para receber qualquer notificação: 1 = Sim 0 = Não
email_address	nvarchar(100)	Endereço de email do operador.
last_email_date	int	Data em que o operador foi notificado pela última vez por email.
last_email_time	int	Hora em que o operador foi notificado pela última vez por email.
pager_address	nvarchar(100)	Endereço de pager do operador.
last_pager_date	int	Data em que o operador foi notificado pela última vez por pager.
last_pager_time	int	Hora em que o operador foi notificado pela última vez por pager.
weekday_pager_start_time	int	O início do período durante o qual o operador está disponível para receber notificações de pager em um dia da semana.
weekday_pager_end_time	int	O fim do período durante o qual o operador está disponível para receber notificações de pager em um dia da semana.
saturday_pager_start_time	int	O início do período durante o qual o operador está disponível para receber notificações de pager aos sábados.
saturday_pager_end_time	int	O fim do período durante o qual o operador está disponível para receber notificações de pager aos sábados.
sunday_pager_start_time	int	O início do período durante o qual o operador está disponível para receber notificações de pager aos domingos.
sunday_pager_end_time	int	O fim do período durante o qual o operador está disponível para receber notificações de pager aos domingos.
pager_days	tinyint	Um bitmask (1 = Domingo, 64 = Sábado) de dias da semana indicando quando o operador está disponível para receber notificações de pager.
netsend_address	nvarchar(100)	Endereço de operador para notificações pop-up de rede.
last_netsend_date	int	Data em que o operador foi notificado pela última vez por pop-up de rede.
last_netsend_time	int	Hora em que o operador foi notificado pela última vez por pop-up de rede.
category_name	sysname	Nome da categoria de operador ao qual esse operador pertence.

Comentários

sp_help_operator deve ser executado a partir do banco de dados msdb.

Permissões

Por padrão, os membros da função de servidor fixa sysadmin podem executar este procedimento armazenado. Deve ser concedida a outros usuários uma das seguintes funções de banco de dados fixas do SQL Server Agent no banco de dados msdb:

• SQLAgentUserRole

• SQLAgentReaderRole

• SQLAgentOperatorRole

Para obter detalhes sobre as permissões dessas funções, consulte Funções de banco de dados fixas do SQL Server Agent.

Exemplos

O exemplo a seguir relata informações sobre o operador François Ajenstat.

USE msdb ;
GO

EXEC dbo.sp_help_operator
    @operator_name = N'François Ajenstat' ;
GO

Consulte também

Referência

sp_add_operator (Transact-SQL)

sp_delete_operator (Transact-SQL)

sp_update_operator (Transact-SQL)

Procedimentos armazenados do sistema (Transact-SQL)