sp_notify_operator (Transact-SQL)

Aplica-se a:SQL Server

Envia uma mensagem de email a um operador usando o Database Mail.

Convenções de sintaxe de Transact-SQL

Sintaxe

  
sp_notify_operator  
    [ @profile_name = ] 'profilename' ,  
    [ @id = ] id ,  
    [ @name = ] 'name' ,  
    [ @subject = ] 'subject' ,  
    [ @body = ] 'message' ,  
    [ @file_attachments = ] 'attachment'  
    [ @mail_database = ] 'mail_host_database'  

Argumentos

[ @profile_name = ] 'profilename' O nome do perfil do Database Mail a ser usado para enviar a mensagem. profilename é nvarchar(128). Se profilename não for especificado, o perfil padrão do Database Mail será usado.

[ @id = ] id O identificador para o qual o operador deve enviar a mensagem. id é int, com um padrão de NULL. Um dos id ou nome deve ser especificado.

[ @name = ] 'name' O nome do operador para o qual enviar a mensagem. name é nvarchar(128), com um padrão de NULL. Um dos id ou nome deve ser especificado.

Observação

Um endereço de email deve ser definido para o operador antes que ele possa receber mensagens.

[ @subject = ] 'subject' O assunto da mensagem de email. O assunto é nvarchar(256) sem padrão.

[ @body = ] 'message' O corpo da mensagem de email. mensagem é nvarchar(max) sem padrão.

[ @file_attachments = ] 'attachment' O nome de um arquivo a ser anexado à mensagem de email. anexo é nvarchar(512), sem padrão.

[ @mail_database = ] 'mail_host_database' Especifica o nome do banco de dados do host de email. mail_host_database é nvarchar(128). Se nenhuma mail_host_database for especificada, o banco de dados msdb será usado por padrão.

Valores do código de retorno

0 (sucesso) ou 1 (fracasso)

Comentários

Envia a mensagem especificada ao endereço de email do operador especificado. Se o operador não tiver nenhum endereço de email configurado, retornará um erro.

O Database Mail e um banco de dados host de email devem ser configurados para que uma notificação possa ser enviada a um operador.

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 envia um email de notificação ao operador François Ajenstat que usa o perfil do Database Mail AdventureWorks Administrator . O assunto do email é Test Notification. A mensagem de email contém a oração: "Este é um email de teste enviado pelo Database Mail".

USE msdb ;  
GO  
  
EXEC dbo.sp_notify_operator  
   @profile_name = N'AdventureWorks Administrator',  
   @name = N'François Ajenstat',  
   @subject = N'Test Notification',  
   @body = N'This is a test of notification via e-mail.' ;  
GO  

Confira também

Procedimentos armazenados do SQL Server Agent (Transact-SQL)
sp_add_operator (Transact-SQL)
sp_help_operator (Transact-SQL)
sp_delete_operator (Transact-SQL)