Partilhar via

sp_notify_operator (Transact-SQL)

Aplica-se a:SQL Server

Envia uma mensagem de e-mail a um operador usando Database Mail.

Transact-SQL convenções de sintaxe

Sintaxe

sp_notify_operator
    [ [ @profile_name = ] N'profile_name' ]
    [ , [ @id = ] id ]
    [ , [ @name = ] N'name' ]
    [ , [ @subject = ] N'subject' ]
    [ , [ @body = ] N'body' ]
    [ , [ @file_attachments = ] N'file_attachments' ]
    [ , [ @mail_database = ] N'mail_database' ]
[ ; ]

Arguments

[ @profile_name = ] N'profile_name'

O nome do perfil de Correio da Base de Dados a usar para enviar a mensagem. @profile_name é sysname, com um padrão de NULL. Se @profile_name não for especificado, é utilizado o perfil predefinido de Correio da Base de Dados.

[ @id = ] id

O identificador para o operador enviar a mensagem. @id é int, com um padrão de NULL.

Um dos @id ou @name deve ser especificado.

[ @name = ] N'nome'

O nome do operador para quem enviar a mensagem. @name é sysname, com um padrão de NULL.

Um dos @id ou @name deve ser especificado.

Deve ser definido um endereço de e-mail para o operador antes de este poder receber mensagens.

@subject [ = ] N'sujeito'

O assunto da mensagem de e-mail. @subject é nvarchar(256), com um padrão de NULL.

@body [ = ] N'corpo'

O corpo da mensagem de email. @body é nvarchar(max), com um padrão de NULL.

@file_attachments [ = ] N'file_attachments'

O nome de um ficheiro para anexar à mensagem de e-mail. @file_attachments é nvarchar(512), com um padrão de NULL.

[ @mail_database = ] N'mail_database'

Especifica o nome da base de dados anfitriã do correio. @mail_database é sysname, com um padrão de msdb. Se não for especificado @mail_database , a msdb base de dados é usada por defeito.

Valores de código de retorno

0 (sucesso) ou 1 (fracasso).

Observações

Envia a mensagem especificada para o endereço de e-mail do operador especificado. Se o operador não tiver um endereço de e-mail configurado, sp_notify_operator devolve um erro.

O Correio da Base de Dados e uma base de dados anfitriã de correio devem ser configurados antes de uma notificação poder ser enviada a um operador.

Permissions

Pode conceder EXECUTE permissões neste procedimento, mas essas permissões podem ser anuladas durante uma atualização do SQL Server.

Outros utilizadores devem receber um dos seguintes papéis fixos de base de dados SQL Server Agent na msdb base de dados:

  • SQLAgentUserRole
  • SQLAgentReaderRole
  • SQLAgentOperatorRole

Para detalhes sobre as permissões destes papéis, consulte Funções de Base de Dados Fixas do Agente SQL Server.

Examples

O exemplo seguinte envia um e-mail de notificação ao operador François Ajenstat usando o AdventureWorks Administrator perfil de Email da Base de Dados. O assunto do e-mail é Test Notification. A mensagem de e-mail contém a frase, This is a test of notification via e-mail.

USE msdb;
GO

EXECUTE 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

Conteúdo relacionado

  • Last updated on