Partilhar via

  • Artigo

sp_add_operator (Transact-SQL)

Cria um operador (destinatário da notificação) para uso com alertas e trabalhos.

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

Sintaxe

sp_add_operator [ @name = ] 'name' 
     [ , [ @enabled = ] enabled ] 
     [ , [ @email_address = ] 'email_address' ] 
     [ , [ @pager_address = ] 'pager_address' ] 
     [ , [ @weekday_pager_start_time = ] weekday_pager_start_time ] 
     [ , [ @weekday_pager_end_time = ] weekday_pager_end_time ] 
     [ , [ @saturday_pager_start_time = ] saturday_pager_start_time ] 
     [ , [ @saturday_pager_end_time = ] saturday_pager_end_time ] 
     [ , [ @sunday_pager_start_time = ] sunday_pager_start_time ] 
     [ , [ @sunday_pager_end_time = ] sunday_pager_end_time ] 
     [ , [ @pager_days = ] pager_days ] 
     [ , [ @netsend_address = ] 'netsend_address' ] 
     [ , [ @category_name = ] 'category' ]

Argumentos

  • [ @name= ] 'name'
    O nome de um operador (destinatário da notificação). Esse nome deve ser exclusivo e não pode conter o caractere de porcentagem (%). name é sysname, sem padrão.

  • [ @enabled= ] enabled
    Indica o status atual do operador. enabled é tinyint, com um padrão de 1 (habilitado). Se for 0, o operador não estará habilitado e não receberá notificações.

  • [ @email_address= ] 'email_address'
    O endereço de email do operador. Essa cadeia de caracteres é transmitida diretamente para o sistema de email. email_address é nvarchar(100), com um padrão de NULL.

    Você pode especificar um endereço de email físico ou um alias para email_address. Por exemplo:

    'jdoe' ou 'jdoe@xyz.com'

    ObservaçãoObservação

    Você pode usar uma alias de email somente para SQL Mail. Você deve usar o endereço de email para Database Mail.

  • [ @pager_address= ] 'pager_address'
    O endereço de pager do operador. Essa cadeia de caracteres é transmitida diretamente para o sistema de email. pager_address é narchar(100), com um padrão de NULL.

  • [ @weekday_pager_start_time= ] weekday_pager_start_time
    A hora depois da qual o SQL Server Agent envia notificação de pager para o operador especificado em dias da semana, de segunda a sexta-feira. weekday_pager_start_timeé int, com um padrão de 090000, que indica 9h em um relógio de 24 horas, e deve ser inserido com o formato HHMMSS.

  • [ @weekday_pager_end_time= ] weekday_pager_end_time
    A hora depois da qual o serviço SQLServerAgent não mais envia notificação de pager para o operador especificado em dias da semana, de segunda a sexta-feira. weekday_pager_end_timeé int, com um padrão de 180000, que indica 18h em um relógio de 24 horas, devendo ser inserido com o formato HHMMSS.

  • [ @saturday_pager_start_time =] saturday_pager_start_time
    A hora depois da qual o serviço SQLServerAgent envia notificação de pager para o operador especificado aos sábados. saturday_pager_start_time é int, com um padrão de 090000, que indica 9h em um relógio de 24 horas, devendo ser inserido com o formato HHMMSS.

  • [ @saturday_pager_end_time= ] saturday_pager_end_time
    A hora depois da qual o serviço SQLServerAgent não mais envia notificação de pager para o operador especificado aos sábados. saturday_pager_end_timeé int, com um padrão de 180000, que indica 18h em um relógio de 24 horas, devendo ser inserido usando o formato HHMMSS.

  • [ @sunday_pager_start_time= ] sunday_pager_start_time
    A hora depois da qual o serviço SQLServerAgent envia notificação de pager para o operador especificado aos domingos. sunday_pager_start_timeé int, com um padrão de 090000, que indica 9h em um relógio de 24 horas, devendo ser inserido com o formato HHMMSS.

  • [ @sunday_pager_end_time =] sunday_pager_end_time
    A hora depois da qual o serviço SQLServerAgent não mais envia notificação de pager para o operador especificado aos domingos. sunday_pager_end_timeé int, com um padrão de 180000, que indica 18h em um relógio de 24 horas, devendo ser inserido com o formato HHMMSS.

  • [ @pager_days= ] pager_days
    É um número que indica os dias em que o operador está disponível para receber notificações por pager (sujeitos aos horários de início/término especificados). pager_daysé tinyint, com um padrão de 0 que indica que o operador nunca está disponível para receber uma notificação por pager. Os valores válidos são de 0 a 127. pager_days é calculado somando os valores individuais dos dias necessários. Por exemplo, de segunda a sexta-feira é 2+4+8+16+32 = 62. A tabela a seguir lista o valor de cada dia da semana.

    Valor

    Descrição

    1

    Domingo

    2

    Segunda-feira

    4

    Terça-feira

    8

    Quarta-feira

    16

    Quinta-feira

    32

    Sexta-feira

    64

    Sábado

  • [ @netsend_address= ] 'netsend_address'
    O endereço de rede do operador ao qual a mensagem de rede é enviada. netsend_addressé nvarchar(100), com um padrão de NULL.

  • [ @category_name= ] 'category'
    O nome da categoria desse operador. category é sysname, com um padrão de NULL.

Valores de código de retorno

0 (êxito) ou 1 (falha)

Conjuntos de resultados

Nenhum

Comentários

sp_add_operator deve ser executado no banco de dados msdb.

É oferecido suporte à chamada por pager pelo sistema de email, que deve ter um recurso de email para pager se você quiser usar chamada por pager.

O SQL Server Management Studio fornece um modo gráfico e fácil de gerenciar trabalhos e é o modo recomendado para criar e gerenciar a infra-estrutura de trabalhos.

Permissões

Somente membros da função de servidor fixa sysadmin podem executar sp_add_operator.

Exemplos

O exemplo a seguir configura as informações do operador para danwi. O operador está habilitado. O SQL Server Agent envia notificações por pager de segunda a sexta-feira, das 8 às 17h.

USE msdb ;
GO

EXEC dbo.sp_add_operator
    @name = N'Dan Wilson',
    @enabled = 1,
    @email_address = N'danwi',
    @pager_address = N'5551290AW@pager.Adventure-Works.com',
    @weekday_pager_start_time = 080000,
    @weekday_pager_end_time = 170000,
    @pager_days = 62 ;
GO