sp_help_operator (Transact-SQL)

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

Ícone de vínculo de tópicoConvenções de 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 NULL.

    ObservaçãoObservaçã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.

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

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