sp_add_operator (Transact-SQL)

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

Convenções da 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 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 é passada 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ção
  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 é passada 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 ao operador especificado nos dias de semana, de segunda-feira a sexta-feira. weekday_pager_start_time* *é int, com um padrão de 090000, que indica 09h00 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 envia mais notificação por pager ao operador especificado nos dias de semana, de segunda-feira a sexta-feira. weekday_pager_end_timeé int, com um padrão de 180000, que indica 18h00 em um relógio de 24 horas e deve 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 por pager ao operador especificado aos sábados. saturday_pager_start_time é int, com um padrão de 090000, que indica 09h00 em um relógio de 24 horas e deve 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 envia mais notificação por pager ao operador especificado aos sábados. saturday_pager_end_timeé int, com um padrão de 180000, que indica 18h00 em um relógio de 24 horas e deve ser inserido com o formato HHMMSS.

• [ @sunday_pager_start_time= ] sunday_pager_start_time
  A hora depois da qual o serviço SQLServerAgent envia notificação por pager ao operador especificado aos domingos. sunday_pager_start_timeé int, com um padrão de 090000, que indica 09h00 em um relógio de 24 horas e deve 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 envia mais notificação por pager ao operador especificado aos domingos. sunday_pager_end_timeé int, com um padrão de 180000, que indica 18h00 em um relógio de 24 horas e deve 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 páginas (sujeito 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 página. Os valores válidos são de 0 a 127. pager_daysé calculado com a adição de valores individuais para os 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.

  Value	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 para o qual a mensagem de rede é enviada. netsend_address é nvarchar(100), com um padrão de NULL.

• [ @category_name= ] 'category'
  O nome da categoria para este 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 gerencia trabalhos de forma fácil e com representação gráfica. Além disso, ele é recomendado para criar e gerenciar a infraestrutura 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 8h à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

Consulte também

Referência

sp_delete_operator (Transact-SQL)

sp_help_operator (Transact-SQL)

sp_update_operator (Transact-SQL)

Procedimentos armazenados do sistema (Transact-SQL)