Compartilhar via

sp_help_operator (Transact-SQL)

  • Artigo

Aplica-se: SQL Server

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

Convenções de sintaxe de Transact-SQL

Sintaxe

sp_help_operator
    [ [ @operator_name = ] N'operator_name' ]
    [ , [ @operator_id = ] operator_id ]
[ ; ]

Argumentos

@operator_name [ = ] N'operator_name'

O nome do operador. @operator_name é sysname, com um padrão de NULL. Se @operator_name não for especificado, as informações sobre todos os operadores serão retornadas.

O @operator_id ou o @operator_name devem ser especificados, mas ambos não podem ser especificados.

@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.

O @operator_id ou o @operator_name devem ser especificados, mas ambos não podem ser especificados.

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Conjunto de resultados

Nome da coluna Tipo de dados Descrição
id int Número de identificação do operador.
name sysname Nome do operador.
enabled 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 Uma máscara de bits (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 msdb banco de dados.

Permissões

Você pode conceder EXECUTE permissões nesse procedimento, mas essas permissões podem ser substituídas durante uma atualização do SQL Server.

Outros usuários devem receber uma das seguintes funções de banco de dados fixas do msdb SQL Server Agent no banco de dados:

  • 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

Conteúdo relacionado