通过

  • 项目

sp_notify_operator (Transact-SQL)

使用数据库邮件向操作员发送电子邮件。

主题链接图标Transact-SQL 语法约定

语法

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

参数

  • [ @profile_name= ] 'profilename'
    用于发送消息的数据库邮件配置文件的名称。profilename 的数据类型为 nvarchar(128)。如果未指定 profilename，则使用默认的数据库邮件配置文件。

  • [ @id= ] id
    向其发送消息的操作员的标识符。id 的数据类型为 int，默认值为 NULL。必须指定 id 或 name 中的一项。

  • [ @name= ] 'name'
    向其发送消息的操作员的名称。name 的数据类型为 nvarchar(128)，默认值为 NULL。必须指定 id 或 name 中的一项。

    注意注意

    必须先为操作员定义一个电子邮件地址，然后他们才能接收消息。

  • [ @subject= ] 'subject'
    电子邮件的主题。subject 的数据类型为 nvarchar(256)，无默认值。

  • [ @body= ] 'message'
    电子邮件的正文。message 的数据类型为 nvarchar(max)，无默认值。

  • [ @file_attachments= ] 'attachment'
    附加到电子邮件的文件的名称。attachment 的数据类型为 nvarchar(512)，无默认值。

  • [ @mail_database= ] 'mail_host_database'
    指定邮件主机数据库的名称。mail_host_database 的数据类型为 nvarchar(128)。如果未指定 mail_host_database，则默认使用 msdb 数据库。

返回代码值

0（成功）或 1（失败）

注释

将指定消息发送到指定操作员的电子邮件地址。如果操作员没有配置电子邮件地址，则返回一个错误。

必须先配置数据库邮件和邮件主机数据库才能将通知发送给操作员。有关详细信息，请参阅 数据库邮件操作指南帮助主题。

权限

默认情况下，只有 sysadmin 固定服务器角色的成员才可以执行此存储过程。其他用户必须被授予 msdb 数据库中下列 SQL Server 代理固定数据库角色的权限之一：

  • SQLAgentUserRole

  • SQLAgentReaderRole

  • SQLAgentOperatorRole

有关这些角色的权限的详细信息，请参阅 SQL Server 代理固定数据库角色。

示例

下面的示例使用 AdventureWorks2008R2 Administrator 数据库邮件配置文件将一份通知电子邮件发送给操作员 François Ajenstat电子邮件的主题是 Test Notification。此电子邮件包含一句话“This is a test of notification via e-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