sp_notify_operator (Transact-SQL)
更新日期: 2006 年 7 月 17 日
使用数据库邮件向操作员发送电子邮件。
语法
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 的数据类型为 sysname。如果未指定 profilename,则使用默认的数据库邮件配置文件。
- [ @id= ] id
向其发送消息的操作员的标识符。id 的数据类型为 int,默认值为 NULL。必须指定 id 或 name 中的一项。
[ @name= ] 'name'
向其发送消息的操作员的名称。name 的数据类型为 sysname,默认值为 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 代理固定数据库角色。
示例
下面的示例使用 AdventureWorks 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'AdventureWorks Administrator',
@name = N'François Ajenstat',
@subject = N'Test Notification',
@body = N'This is a test of notification via e-mail.' ;
GO
请参阅
参考
sp_add_operator (Transact-SQL)
sp_help_operator (Transact-SQL)
sp_delete_operator (Transact-SQL)
帮助和信息
更改历史记录
发布日期 | 历史记录 |
---|---|
2006 年 7 月 17 日 |
|
2006 年 4 月 14 日 |
|