sp_add_operator (Transact-SQL)
Aplica-se a: 
SQL Server Instância Gerenciada de SQL do Azure
Cria um operador (destinatário da notificação) para uso com alertas e trabalhos.
Convenções de sintaxe de Transact-SQL
Sintaxe
sp_add_operator
[ @name = ] 'name'
[ , [ @enabled = ] enabled ]
[ , [ @email_address = ] N'email_address' ]
[ , [ @pager_address = ] N'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 = ] N'netsend_address' ]
[ , [ @category_name = ] 'category' ]
[ ; ]
Argumentos
@name [ = ] 'nome'
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 [ = ] habilitado
Indica o status atual do operador. @enabled é tinyint, com um padrão de 1 (enabled). Se 0, o operador não está habilitado e não recebe notificações.
@email_address [ = ] N'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:
fatmir.bregu ou fatmir.bregu@contoso.com
Observação
Você deve usar o endereço de email para Database Mail.
@pager_address [ = ] N'pager_address'
O endereço de pager do operador. Essa cadeia de caracteres é passada diretamente para o sistema de email. @pager_address é nvarchar(100), com um padrão de NULL.
@weekday_pager_start_time [ = ] weekday_pager_start_time
O tempo após o qual o SQL Server Agent envia a notificação do pager para o operador especificado nos dias da semana, de segunda a sexta-feira. @weekday_pager_start_time é int, com um padrão de 090000, que indica 9:00 A.M. em um relógio de 24 horas, e deve ser inserido usando o formulário HHmmss.
@weekday_pager_end_time [ = ] weekday_pager_end_time
O tempo após o qual o serviço SQL Server Agent não envia mais a notificação do pager para o operador especificado nos dias da semana, de segunda a sexta-feira. weekday_pager_end_time é int, com um padrão de 180000, que indica 18:00 em um relógio de 24 horas, e deve ser inserido usando o formulário HHmmss.
@saturday_pager_start_time [ = ] saturday_pager_start_time
O tempo após o qual o serviço SQL Server Agent envia a notificação do pager para o operador especificado aos sábados. saturday_pager_start_time é int, com um padrão de , que indica 9:00 A.M. em um relógio de 24 horas, e deve ser inserido 090000usando o formulário HHmmss.
@saturday_pager_end_time [ = ] saturday_pager_end_time
O tempo após o qual o serviço SQL Server Agent não envia mais notificação de pager para o operador especificado aos sábados. @saturday_pager_end_time é int, com um padrão de 180000, que indica 18:00 em um relógio de 24 horas, e deve ser inserido usando o formulário HHmmss.
@sunday_pager_start_time [ = ] sunday_pager_start_time
O tempo após o qual o serviço SQL Server Agent envia notificação de pager para o operador especificado aos domingos. @sunday_pager_start_time é int, com um padrão de , que indica 9:00 A.M. em um relógio de 24 horas, e deve ser inserido 090000usando o formulário HHmmss.
@sunday_pager_end_time [ = ] sunday_pager_end_time
O tempo após o qual o serviço SQL Server Agent não envia mais notificação de pager para o operador especificado aos domingos. @sunday_pager_end_time é int, com um padrão de , que indica 18:00 em um relógio de 24 horas, e deve ser inserido 180000usando o formulário 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 indicar que o operador nunca está disponível para receber uma página. Os valores válidos são de 0 até .127 @pager_days é calculado adicionando os 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.
| 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 [ = ] N'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 [ = ] 'categoria'
O nome da categoria para este operador. @category_name é sysname, com um padrão de NULL.
Valores do código de retorno
0 (sucesso) ou 1 (falha).
Conjunto de resultados
Nenhum.
Comentários
sp_add_operator deve ser executado a partir do msdb banco de dados.
Seu sistema de email deve ter um recurso de e-mail para paginação se você quiser usar a paginação.
O SQL Server Management Studio fornece um modo gráfico fácil de gerenciar trabalhos e é o modo recomendado de criar e gerenciar a infra-estrutura de trabalho.
Permissões
Esse procedimento armazenado pertence à função db_owner . Você pode conceder EXECUTE permissões para qualquer usuário, mas essas permissões podem ser substituídas durante uma atualização do SQL Server.
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