热门标签 | HotTags
当前位置:  开发笔记 > 编程语言 > 正文

数据库邮件服务器中sp_send_dbmail的参数使用

sp_send_dbmail[[@profile_name]profile_name]Server:sp_send_dbmail参数设置(转载)srchttp:www

sp_send_dbmail [ [ @profile_name = ] 'profile_name' ]
SQL <wbr>Server:sp_send_dbmail参数设置(转载)    [ , [ @recipients = ] 'recipients [ ; SQL <wbr>Server:sp_send_dbmail参数设置(转载)n ]' ]
SQL <wbr>Server:sp_send_dbmail参数设置(转载)    [ , [ @copy_recipients = ] 'copy_recipient [ ; SQL <wbr>Server:sp_send_dbmail参数设置(转载)n ]' ]
SQL <wbr>Server:sp_send_dbmail参数设置(转载)    [ , [ @blind_copy_recipients = ] 'blind_copy_recipient [ ; SQL <wbr>Server:sp_send_dbmail参数设置(转载)n ]' ]
SQL <wbr>Server:sp_send_dbmail参数设置(转载)    [ , [ @subject = ] 'subject' ] 
SQL <wbr>Server:sp_send_dbmail参数设置(转载)    [ , [ @body = ] 'body' ] 
SQL <wbr>Server:sp_send_dbmail参数设置(转载)    [ , [ @body_format = ] 'body_format' ]
SQL <wbr>Server:sp_send_dbmail参数设置(转载)    [ , [ @importance = ] 'importance' ]
SQL <wbr>Server:sp_send_dbmail参数设置(转载)    [ , [ @sensitivity = ] 'sensitivity' ]
SQL <wbr>Server:sp_send_dbmail参数设置(转载)    [ , [ @file_attachments = ] 'attachment [ ; SQL <wbr>Server:sp_send_dbmail参数设置(转载)n ]' ]
SQL <wbr>Server:sp_send_dbmail参数设置(转载)    [ , [ @query = ] 'query' ]
SQL <wbr>Server:sp_send_dbmail参数设置(转载)    [ , [ @execute_query_database = ] 'execute_query_database' ]
SQL <wbr>Server:sp_send_dbmail参数设置(转载)    [ , [ @attach_query_result_as_file = ] attach_query_result_as_file ]
SQL <wbr>Server:sp_send_dbmail参数设置(转载)    [ , [ @query_attachment_filename = ] query_attachment_filename ]
SQL <wbr>Server:sp_send_dbmail参数设置(转载)    [ , [ @query_result_header = ] query_result_header ]
SQL <wbr>Server:sp_send_dbmail参数设置(转载)    [ , [ @query_result_width = ] query_result_width ]
SQL <wbr>Server:sp_send_dbmail参数设置(转载)    [ , [ @query_result_separator = ] 'query_result_separator' ]
SQL <wbr>Server:sp_send_dbmail参数设置(转载)    [ , [ @exclude_query_output = ] exclude_query_output ]
SQL <wbr>Server:sp_send_dbmail参数设置(转载)    [ , [ @append_query_error = ] append_query_error ]
SQL <wbr>Server:sp_send_dbmail参数设置(转载)    [ , [ @query_no_truncate = ] query_no_truncate ]
SQL <wbr>Server:sp_send_dbmail参数设置(转载)    [ , [ @mailitem_id = ] mailitem_id ] [ OUTPUT ]
SQL <wbr>Server:sp_send_dbmail参数设置(转载)

 参数

[ @profile_name = ] ' profile_name '

发送邮件的配置文件的名称。profile_name 的类型为 sysname,默认值为 NULL。profile_name 必须是现有数据库邮件配置文件的名称。如果未指定 profile_name,则 sp_send_dbmail 使用当前用户的默认专用配置文件。如果该用户没有默认专用配置文件,sp_send_dbmail 会使用 msdb 数据库的默认公共配置文件。如果用户没有默认的专用配置文件,而且数据库也没有默认的公共配置文件,则必须指定 @profile_name

[ @recipients = ] ' recipients '

要向其发送邮件的电子邮件地址列表,以分号分隔。收件人列表的类型为 varchar(max)。虽然此参数是可选参数,但是必须至少指定 @recipients@copy_recipients@blind_copy_recipients 中的一个,否则 sp_send_dbmail 将返回错误。

[ @copy_recipients = ] ' copy_recipients '

要向其抄送邮件的电子邮件地址列表,以分号分隔。抄送件收件人列表的类型为 varchar(max)。虽然此参数是可选参数,但是必须至少指定 @recipients@copy_recipients@blind_copy_recipients 中的一个,否则 sp_send_dbmail 将返回错误。

[ @blind_copy_recipients = ] ' blind_copy_recipients '

要向其密件抄送邮件的电子邮件地址列表,以分号分隔。密件副本收件人列表的类型为 varchar(max)。虽然此参数是可选参数,但是必须至少指定 @recipients@copy_recipients@blind_copy_recipients 中的一个,否则 sp_send_dbmail 将返回错误。

[ @subject = ] ' subject '

电子邮件的主题。主题的类型为 nvarchar(255)。如果未指定主题,则默认为“SQL Server 消息”。

[ @body = ] ' body '

电子邮件的正文。邮件正文的类型为 nvarchar(max),默认值为 NULL。

[ @body_format = ] ' body_format '

邮件正文的格式。该参数的类型为 varchar(20),默认值为 NULL。如果已指定,则待发邮件的标头设置会指示邮件正文具有指定格式。该参数可能包含下列值之一:

  • TEXT
  • HTML

默认为 TEXT。

[ @importance = ] ' importance '

邮件的重要性。该参数的类型为 varchar(6)。该参数可能包含下列值之一:

  • Low
  • Normal
  • High

默认值为 Normal。

[ @sensitivity = ] ' sensitivity '

邮件的敏感度。该参数的类型为 varchar(12)。该参数可能包含下列值之一:

  • Normal
  • Personal
  • Private
  • Confidential

默认值为 Normal。

[ @file_attachments = ] ' file_attachments ',

电子邮件附件的文件名列表,以分号分隔。必须使用绝对路径指定列表中的文件。附件列表的类型为 nvarchar(max)

[ @query = ] ' query '

要执行的查询。查询结果可以作为文件附加,或包含在电子邮件的正文中。查询的类型为 nvarchar(max),并且可以包含任何有效的 Transact-SQL 语句。请注意,查询在单独的会话中执行,所以调用 sp_send_dbmail 的脚本中的局部变量不可用于查询。

[ @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 参数指定的查询返回错误时发送电子邮件。append_query_error 的数据类型为 bit,默认值为 0。如果此参数的值为 1,则数据库邮件会发送电子邮件,并电子邮件的正文中显示查询错误消息。如果此参数的值为 0,则数据库邮件不发送电子邮件,sp_send_dbmail 在结束时会返回代码 1,指示失败。

[ @query_no_truncate = ] query_no_truncate

指定是否使用可避免截断大型可变长度数据类型(varchar(max)nvarchar(max)varbinary(max)xmltextntextimage 和用户定义类型)的选项执行查询。设置该选项后,查询结果将不包含列标题。query_no_truncate 值的数据类型为 bit。当该值为 0 或未指定时,查询中的列将截断为 256 个字符。当该值为 1 时,不截断查询中的列。此参数的默认值为 0。

注意:
与大量数据一起使用时,@query_no_truncate 选项会占用其他资源,并可降低服务器的性能。

 

 

[ @mailitem_id = ] mailitem_id [ OUTPUT ]

可选输出参数将返回消息的 mailitem_idmailitem_id 的类型为 int

SQL <wbr>Server:sp_send_dbmail参数设置(转载) 返回代码值

0(成功)或 1(失败)

SQL <wbr>Server:sp_send_dbmail参数设置(转载) 结果集

成功时,返回消息“邮件已排队”。

SQL <wbr>Server:sp_send_dbmail参数设置(转载) 备注

使用前,必须使用数据库邮件配置向导、SQL Server 外围应用配置器工具或 sp_configure 启用数据库邮件。

sysmail_stop_sp 通过停止外部程序使用的 Service Broker 对象来停止数据库邮件。使用 sysmail_stop_sp 停止数据库邮件后,sp_send_dbmail 仍会接受邮件。若要启动数据库邮件,请使用 sysmail_start_sp

如果未指定 @profile,则 sp_send_dbmail 使用默认配置文件。如果发送电子邮件的用户具有默认专用配置文件,则数据库邮件使用该配置文件。如果该用户没有默认的专用配置文件,则 sp_send_dbmail 将使用默认的公共配置文件。如果用户没有默认的专用配置文件和默认的公共配置文件,则 sp_send_dbmail 将返回错误。

sp_send_dbmail 不支持没有任何内容的电子邮件。若要发送电子邮件,至少必须指定 @body@query@file_attachments@subject 之一。否则,sp_send_dbmail 会返回错误。

数据库邮件使用当前用户的 Microsoft Windows 安全上下文控制对文件的访问。因此,经过 SQL Server 身份验证的用户无法使用 @file_attachments 附加文件。Windows 不允许 SQL Server 从一台远程计算机向另一台远程计算机提供凭据。所以,如果从运行 SQL Server 的计算机以外的计算机运行该命令,则数据库邮件可能无法从网络共享附加文件。

如果已同时指定 @query@file_attachments 且未找到文件,则查询仍然会执行,但是不会发送电子邮件。

指定查询后,结果集的格式被设置为内联文本。使用十六进制格式发送结果中的二进制数据。

参数 @recipients@copy_recipients@blind_copy_recipients 是以分号分隔的电子邮件地址列表。至少必须提供以上参数之一,否则 sp_send_dbmail 会返回错误。

在没有事务上下文的情况下执行 sp_send_dbmail 时,数据库邮件将启动并提交隐式事务。从现有事务内执行 sp_send_dbmail 时,数据库邮件将依赖用户提交或回滚任何更改。它不会启动内部事务。

SQL <wbr>Server:sp_send_dbmail参数设置(转载) 权限

默认情况下,msdb 数据库中的 DatabaseMailUser 数据库角色的所有成员对 sp_send_dbmail 都有执行权限。不过,如果发送邮件的用户不具有使用该请求的配置文件的权限,sp_send_dbmail 会返回错误且不发送该邮件。

SQL <wbr>Server:sp_send_dbmail参数设置(转载) 示例

A. 发送电子邮件

此示例使用电子邮件地址 danw@Adventure-Works.com 向 Dan Wilson 发送电子邮件。该邮件的主题为 Automated Success Message。邮件正文包含一句话 'The stored procedure finished successfully'

EXEC msdb.dbo.sp_send_dbmail@profile_name = 'AdventureWorks 
Administrator',@recipients = 'danw@Adventure-Works.com',@body = 'The 
stored procedure finished successfully.',@subject = 'Automated Success 
Message' ;

B. 发送包含查询结果的电子邮件

此示例使用电子邮件地址 danw@Adventure-Works.com 向 Dan Wilson 发送电子邮件。该邮件的主题为 Work Order Count,并执行查询以显示 DueDate 在 2004 年 4 月 30 日后的两日内的工单数。数据库邮件将该结果附加为文本文件。

EXEC msdb.dbo.sp_send_dbmail@profile_name = 'AdventureWorks 
Administrator',@recipients = 'danw@Adventure-Works.com',@query = 'SELECT
 COUNT(*) FROM AdventureWorks.Production.WorkOrderWHERE DueDate > 
''2004-04-30''AND  DATEDIFF(dd, ''2004-04-30'', DueDate) <2' 
,@subject = 'Work Order Count',@attach_query_result_as_file = 1 ;

A. 发送 HTML 电子邮件

此示例使用电子邮件地址 danw@Adventure-Works.com 向 Dan Wilson 发送电子邮件。邮件的主题为 Work Order List,并包含一个 HTML 文档,其中列出 DueDate 在 2004 年 4 月 30 日后的二日内的工单。数据库邮件使用 HTML 格式发送该邮件。

DECLARE @tableHTML  NVARCHAR(MAX) ;SET @tableHTML =N'

Work Order Report

' +N'' +N'' +N'' +N'' +CAST ( ( SELECT td = wo.WorkOrderID, '',td = p.ProductID, '',td = p.Name, '',td = wo.OrderQty, '',td = wo.DueDate, '',td = (p.ListPrice - p.StandardCost) * wo.OrderQtyFROM AdventureWorks.Production.WorkOrder as woJOIN AdventureWorks.Production.Product AS pON wo.ProductID = p.ProductIDWHERE DueDate > '2004-04-30'AND DATEDIFF(dd, '2004-04-30', DueDate) < 2ORDER BY DueDate ASC,(p.ListPrice - p.StandardCost) * wo.OrderQty DESCFOR XML PATH('tr'), TYPE) AS NVARCHAR(MAX) ) +N'
Work Order IDProduct IDNameOrder QtyDue DateExpected Revenue
' ;EXEC msdb.dbo.sp_send_dbmail @recipients='danw@Adventure-Works.com',@subject = 'Work Order List',@body = @tableHTML,@body_format = 'HTML' ;

以上摘自http://www.cnblogs.com/adandelion/articles/1045760.html

下面是个人例子:

--配置数据库邮件完毕之后
--其中 l_test 为配置文件名 ,Test为邮件主题名 ,邮件正文内容body,邮件中查询结果 query ,my_test 是附件名

--查询结果放在正文之中

EXEC msdb.dbo.sp_send_dbmail
    @profile_name = 'l_test',
    @recipients = 'lxxxx@xx.cn',
    @subject = 'Test',
    @body = 'the query is :',
    @query = 'SELECT TOP 10 [ID],[user_id],[date_time] FROM [xxx].[dbo].[xxx] where [date_time] > "2011-06-20 09:52:40.730" order by ID asc',
    @attach_query_result_as_file= 0

    
--查询结果放在附件之中
    
EXEC msdb.dbo.sp_send_dbmail
    @profile_name = 'l_test',
    @recipients = 'xxx@xx.cn;xxxx@qq.com',
    @subject = 'Test',
    @body = 'the query is in fujian',
    @query = 'SELECT TOP 10 [ID],[user_id],[date_time] FROM [xxxDB.[dbo].[xxxxx] where [date_time] > "2011-06-20 09:52:40.730" order by ID asc',
    @attach_query_result_as_file= 1,
    @query_attachment_filename= 'my_test'

 


推荐阅读
  • 本文详细介绍了SQL日志收缩的方法,包括截断日志和删除不需要的旧日志记录。通过备份日志和使用DBCC SHRINKFILE命令可以实现日志的收缩。同时,还介绍了截断日志的原理和注意事项,包括不能截断事务日志的活动部分和MinLSN的确定方法。通过本文的方法,可以有效减小逻辑日志的大小,提高数据库的性能。 ... [详细]
  • 向QTextEdit拖放文件的方法及实现步骤
    本文介绍了在使用QTextEdit时如何实现拖放文件的功能,包括相关的方法和实现步骤。通过重写dragEnterEvent和dropEvent函数,并结合QMimeData和QUrl等类,可以轻松实现向QTextEdit拖放文件的功能。详细的代码实现和说明可以参考本文提供的示例代码。 ... [详细]
  • 本文介绍了如何使用php限制数据库插入的条数并显示每次插入数据库之间的数据数目,以及避免重复提交的方法。同时还介绍了如何限制某一个数据库用户的并发连接数,以及设置数据库的连接数和连接超时时间的方法。最后提供了一些关于浏览器在线用户数和数据库连接数量比例的参考值。 ... [详细]
  • 本文介绍了使用PHP实现断点续传乱序合并文件的方法和源码。由于网络原因,文件需要分割成多个部分发送,因此无法按顺序接收。文章中提供了merge2.php的源码,通过使用shuffle函数打乱文件读取顺序,实现了乱序合并文件的功能。同时,还介绍了filesize、glob、unlink、fopen等相关函数的使用。阅读本文可以了解如何使用PHP实现断点续传乱序合并文件的具体步骤。 ... [详细]
  • 图解redis的持久化存储机制RDB和AOF的原理和优缺点
    本文通过图解的方式介绍了redis的持久化存储机制RDB和AOF的原理和优缺点。RDB是将redis内存中的数据保存为快照文件,恢复速度较快但不支持拉链式快照。AOF是将操作日志保存到磁盘,实时存储数据但恢复速度较慢。文章详细分析了两种机制的优缺点,帮助读者更好地理解redis的持久化存储策略。 ... [详细]
  • 本文介绍了将mysql从5.6.15升级到5.7.15的详细步骤,包括关闭访问、备份旧库、备份权限、配置文件备份、关闭旧数据库、安装二进制、替换配置文件以及启动新数据库等操作。 ... [详细]
  • WhenIusepythontoapplythepymysqlmoduletoaddafieldtoatableinthemysqldatabase,itdo ... [详细]
  • 使用Ubuntu中的Python获取浏览器历史记录原文: ... [详细]
  • 本文介绍了Oracle数据库中tnsnames.ora文件的作用和配置方法。tnsnames.ora文件在数据库启动过程中会被读取,用于解析LOCAL_LISTENER,并且与侦听无关。文章还提供了配置LOCAL_LISTENER和1522端口的示例,并展示了listener.ora文件的内容。 ... [详细]
  • 本文介绍了高校天文共享平台的开发过程中的思考和规划。该平台旨在为高校学生提供天象预报、科普知识、观测活动、图片分享等功能。文章分析了项目的技术栈选择、网站前端布局、业务流程、数据库结构等方面,并总结了项目存在的问题,如前后端未分离、代码混乱等。作者表示希望通过记录和规划,能够理清思路,进一步完善该平台。 ... [详细]
  • 本文介绍了在Mac上搭建php环境后无法使用localhost连接mysql的问题,并通过将localhost替换为127.0.0.1或本机IP解决了该问题。文章解释了localhost和127.0.0.1的区别,指出了使用socket方式连接导致连接失败的原因。此外,还提供了相关链接供读者深入了解。 ... [详细]
  • 解决VS写C#项目导入MySQL数据源报错“You have a usable connection already”问题的正确方法
    本文介绍了在VS写C#项目导入MySQL数据源时出现报错“You have a usable connection already”的问题,并给出了正确的解决方法。详细描述了问题的出现情况和报错信息,并提供了解决该问题的步骤和注意事项。 ... [详细]
  • 本文讨论了在数据库打开和关闭状态下,重新命名或移动数据文件和日志文件的情况。针对性能和维护原因,需要将数据库文件移动到不同的磁盘上或重新分配到新的磁盘上的情况,以及在操作系统级别移动或重命名数据文件但未在数据库层进行重命名导致报错的情况。通过三个方面进行讨论。 ... [详细]
  • Go GUIlxn/walk 学习3.菜单栏和工具栏的具体实现
    本文介绍了使用Go语言的GUI库lxn/walk实现菜单栏和工具栏的具体方法,包括消息窗口的产生、文件放置动作响应和提示框的应用。部分代码来自上一篇博客和lxn/walk官方示例。文章提供了学习GUI开发的实际案例和代码示例。 ... [详细]
  • 本文讨论了Kotlin中扩展函数的一些惯用用法以及其合理性。作者认为在某些情况下,定义扩展函数没有意义,但官方的编码约定支持这种方式。文章还介绍了在类之外定义扩展函数的具体用法,并讨论了避免使用扩展函数的边缘情况。作者提出了对于扩展函数的合理性的质疑,并给出了自己的反驳。最后,文章强调了在编写Kotlin代码时可以自由地使用扩展函数的重要性。 ... [详细]
author-avatar
手机用户2602940163
这个家伙很懒,什么也没留下!
PHP1.CN | 中国最专业的PHP中文社区 | DevBox开发工具箱 | json解析格式化 |PHP资讯 | PHP教程 | 数据库技术 | 服务器技术 | 前端开发技术 | PHP框架 | 开发工具 | 在线工具
Copyright © 1998 - 2020 PHP1.CN. All Rights Reserved | 京公网安备 11010802041100号 | 京ICP备19059560号-4 | PHP1.CN 第一PHP社区 版权所有