Transact-SQL。请注意,查询在单独的会话中执行,所以调用sp_send_dbmail 的脚本中的局部变量不可用于查询。
(注意:发邮件的用户必须有执行@query的权限)
[ @execute_query_database = ] 'execute_query_database'
存储过程在其中运行查询的数据库上下文。该参数的类型为sysname,默认为当前数据库。只有在指定@query 时,此参数才适用。
[ @attach_query_result_as_file = ] attach_query_result_as_file
指定查询结果集是否作为附件返回。attach_query_result_as_file 的数据类型为bit,默认值为0。
如果该值为0,查询结果包含在电子邮件的正文中,在@body 参数的内容之后。如果该值为1,结果作为附件返回。只有在指定@query 时,
此参数才适用。
[ @query_attachment_filename = ] query_attachment_filename
指定查询结果集附件使用的文件名。query_attachment_filename 的数据类型为nvarchar(255),默认值为NULL。如果attach_query_result
为0,则忽略此参数。如果attach_query_result 为1 且此参数为NULL,则数据库邮件会创建任意文件名。
[ @query_result_header = ] query_result_header
指定查询结果是否包含列标题。query_result_header 值的数据类型为bit。如果该值为1,则查询结果包含列标题。如果该值为0,则查询
结果不包含列标题。该参数的默认值为1。只有在指定@query 时,此参数才适用。
[ @query_result_width = ] query_result_width
用于设置查询结果的格式的线条宽度(字符)。query_result_width 的数据类型为int,默认值为256。提供的值必须介于10 到32767 之
间。只有在指定@query 时,此参数才适用。
[ @query_result_separator = ] 'query_result_separator'
用于分隔查询输出中的列的字符。分隔符的类型为char(1)。默认为' '(空格)。
[ @exclude_query_output = ] exclude_query_output
指定是否使用电子邮件返回查询执行的输出。exclude_query_output 的数据类型为bit,默认值为0。当此参数为0 时,sp_send_dbmail 存
储过程的执行将在控制台上打印作为查询执行结果而返回的消息。当此参数为1 时,sp_send_dbmail 存储过程的执行不会在控制台上打印任
何查询执行消息。
[ @append_query_error = ] append_query_error
指定是否在@query 参数中指定的查询返回错误时发送电子邮件。exclude_query_output 的数据类型为bit,默认值为0。如果该参数的值为
1,数据库邮件会发送电子邮件,并将查询错误消息包含在电子邮件的正文中。如果该参数的值为0,数据库邮件不发送电子邮件,
sp_send_dbmail 在结束时会返回代码1,表示失败。
[ @query_no_truncate = ] query_no_truncate
指定是否使用可避免截断大型可变长度数据类型(varchar(max)、nvarchar(max)、varbinary(max)、xml、text、ntext、image 以及用户定义
数据类型)的选项执行查询。设置该选项后,查询结果将不包含列标题。query_no_truncate 值的数据类型为bit。当该值为0 或未指定时,
查询中的列截断为256 个字符。当该此值为1 时,不截断查询中的列。该参数的默认值为0。
注意:
与大量数据一起使用时,query_no_truncate 选项会占用其他资源,并可降低服务器的性能。
[ @mailitem_id = ] mailitem_id [ OUTPUT ]
可选输出参数将返回消息的mailitem_id。mailitem_id 的数据类型为int。
以sp开头的一些与数据邮件相关的过程存储在msdb数据库中,msdb 数据库中的DatabaseMailUser 数据库角色的所有成员对sp_send_dbmail
都有执行权限。不过,如果发送邮件的用户不具有使用该请求的配置文件的权限,sp_send_dbmail 会返回错误且不发送该邮件。
配置数据库邮件
1、在外围配置器中启用数据库邮件
2、在数据库管理节点下配置数据库邮件(先建立配置文件,然后创建账号)
3、建立账号,使他成为msdb中DatabaseMailUser 数据库角色所成员
4、修改据库管理节点下配置数据库邮件配置设置,使刚建立的账号有权使用刚才建立的配置文件
5、以刚建立的用户登陆,测试
下面是我的测试SQL:
use mdsb
--基本的发送语句
EXEC sp_send_dbmail @profile_name = 'xx_adam',
@recipients = 'xx_adam@263.com',
@subject = '我数据库邮件测试成功了!',
@body = 'hello,world!'
--包含查询的
EXEC sp_send_dbmail @profile_name = 'xx_adam',
@recipients = 'xx_adam@263.com',
@subject = '查询结果',
@query = 'select * from demo.dbo.orders',
--包含附件
EXEC sp_send_dbmail @profile_name = 'xx_adam',
@recipients = 'xx_adam@263.com',
@subject = '包含附件',
@body = '有附件,请查收',
@file_attachments = 'c:a.txt'
--将查询作为附件
EXEC sp_send_dbmail @profile_name = 'xx_adam',
@recipients = 'xx_adam@263.com',
@subject = '查询结果',
@body = '查询结果在附件中',
@query = 'select * from demo.dbo.orders',
@attach_query_result_as_file = 1,
@query_attachment_filename = 'a.txt'
作者:菩提树下的杨过