Compartilhar via


sp_notify_operator (Transact-SQL)

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

Ícone de vínculo de tópicoConvenções de sintaxe 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 ao qual operador enviará a mensagem. id é int, com um padrão NULL. É necessário especificar a id ou o name.

  • [ @name= ] 'name'
    O nome do operador ao qual a mensagem será enviada. name é nvarchar(128), com um padrão NULL. É necessário especificar a id ou o name.

    ObservaçãoObservação

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

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

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

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

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

Valores de código de retorno

0 (êxito) ou 1 (falha)

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. Para obter mais informações, consulte Tópicos de instruções do Database Mail.

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 AdventureWorks2008R2 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'AdventureWorks2008R2 Administrator',
   @name = N'François Ajenstat',
   @subject = N'Test Notification',
   @body = N'This is a test of notification via e-mail.' ;
GO