SQL SERVER2005发送邮件

key:sql server 2005 邮件

sp_configure 'show advanced options', 1;
GO
RECONFIGURE;
GO
sp_configure 'Database Mail XPs', 1;
GO
RECONFIGURE
GO

一：
http://sqlserver2005.itpub.net/post/22359/210413

早在sql server 2000中可以通过sql mail给指定的邮件地址发邮件。SQL SERVER 2005中我们仍外可以用sql server2000中的SQLMAIl功能

发送邮件，但SQL SERVER2005中又提供一个新数据库邮件功能也可以发送和接收邮件。这里以数据库邮件为例进行说明。

为了安全起见，微软将数 据中的一些可能带来安全隐患的一些功能组件禁用掉了,数据库邮件和SQL MAIL都在被禁用之列，因些第一步是通

过外围配置器将这两个功 能组件启用。启用之后进入SQL SERVER2005管理界面(SQL SERVER 2005 MANGEMENT STUDIO)找到管理节点，就可以找

到数据库邮件子项，在右键菜单中会有一个"配置数据库邮件"菜单，按照步骤先建立配置文件，然后创建 账号，保存退出。在右键菜单的第二

项"发送测试邮件",在弹出的窗口中输入接收的邮件地址，发送就可以。

我们可以在 SQL中通过刚才的配置来收发邮件。在sql server 2000中，通过xp_snedmail以及以xp_开头的存储过程来发送和管理邮件。数据

邮 件用的是在msdb库sp开头的一些存储过程来收发和管理邮件。

sp_send_dbmail发送电子邮件年，用法如下:

sp_send_dbmail [ [ @profile_name = ] 'profile_name' ]
[ , [ @recipients = ] 'recipients [ ; ...n ]' ]
[ , [ @copy_recipients = ] 'copy_recipient [ ; ...n ]' ]
[ , [ @blind_copy_recipients = ] 'blind_copy_recipient [ ; ...n ]' ]
[ , [ @subject = ] 'subject' ]
[ , [ @body = ] 'body' ]
[ , [ @body_format = ] 'body_format' ]
[ , [ @importance = ] 'importance' ]
[ , [ @sensitivity = ] 'sensitivity' ]
[ , [ @file_attachments = ] 'attachment [ ; ...n ]' ]
[ , [ @query = ] 'query' ]
[ , [ @execute_query_database = ] 'execute_query_database' ]
[ , [ @attach_query_result_as_file = ] attach_query_result_as_file ]
[ , [ @query_attachment_filename = ] query_attachment_filename ]
[ , [ @query_result_header = ] query_result_header ]
[ , [ @query_result_width = ] query_result_width ]
[ , [ @query_result_separator = ] 'query_result_separator' ]
[ , [ @exclude_query_output = ] exclude_query_output ]
[ , [ @append_query_error = ] append_query_error ]
[ , [ @query_no_truncate = ] query_no_truncate ]
[ , [ @mailitem_id = ] mailitem_id ] [ OUTPUT ]

sp_send_mail 返回值1表示成功，0表示失败

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 Message。

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

[ @body_format = ] 'body_format'
邮件正文的格式。该参数的类型为 varchar(20)，默认值为 NULL。如果已指定，则待发邮件的标头设置会指示邮件正文具有指定格式。该参数

可能包含下列值之一(默认为 TEXT)：

TEXT

HTML

[ @importance = ] 'importance'
邮件的重要性。该参数的类型为 varchar(6)。该参数可能包含下列值之一(默认值为 Normal)：

Low

Normal

High

[ @sensitivity = ] 'sensitivity'
邮件的敏感度。该参数的类型为 varchar(12)。该参数可能包含下列值之一(默认值为 Normal)：

Normal

Personal

Private

Confidential

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

[ @query = ] 'query'
要执行的查询。 查询结果可以作为文件附加，或包含在电子邮件的正文中。查询的类型为 nvarchar(max)，并且可以包含任何有效的

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'

二：http://www.sqlstudy.com/sql_article.php?id=2008072403

SQL Server：在 SQL Server 2005 中配置数据库邮件。

对于真正的 DBA 来说，数据库邮件是必不可少的。 例如，数据库发生了警报（alert）， DBA 希望得到邮件通知，以便即时排除故障。 或者是监控数据库作业（SQL Server Job）的运行状况，当检查到失败的作业时， 就发送数据库邮件报告给 DBA。

在 SQL Server 2000 中 配置 “SQL Mail”，需要安装 Outlook，配置过程比较麻烦。 在 SQL Server 2005 中配置 “Database Mail” 就相对容易多了。 主要是理清思路。

SQL Server 并没有内置邮件服务器（Mail Server）， 它跟我们发送邮件一样，需要用户名和密码通过 SMTP（Simple Message Transfer Protocol） 去连接邮件服务器。我们想让 SQL Server 来发送邮件，首先要告诉它用户名称，密码， 服务器地址，网络传送协议，邮件服务器的端口。。。等信息。这是通过 SQL Server 系统 存储过程 sysmail_add_account_sp 来实现的。

exec sysmail_add_account_sp

这样，在 SQL Server 2005 中就添加了一个发送邮件的帐户。 道理上讲，有了这个邮件帐户，SQL Server 就可以发送邮件了。 如：

sp_send_dbmail @account_name = 'mail_account'

但是，SQL Server 考虑的更周全。试想：如果这个邮件帐户发生故障 （比如：用户密码过期，或者邮件服务器宕机）那岂不是发送不了邮件了？ 为了应对这种情况，SQL Server 2005 引入了 mail profile 这个东东。 一个 profile 中可以包含多个 account （邮件帐户），这样，SQL Server 发邮件的时候会依次尝试 profile 中的多个邮件帐户，如果发送成功，则退出， 否则，利用下一个邮件帐户发送邮件。其中，添加 profile 和 在 account 和 profile 建立映射是通过下面两个系统存储过程实现的：

sysmail_add_profile_sp
sysmail_add_profileaccount_sp

这时候，SQL Server 发送邮件，就采用下面的方法了：

sp_send_dbmail @profile_name = 'profile_name'

下面是具体的配置邮件步骤

在 sa 系统帐户下运行。

1. 启用 SQL Server 2005 邮件功能。

use master
go

exec sp_configure 'show advanced options',1
go

reconfigure
go

exec sp_configure 'Database mail XPs',1
go

reconfigure
go

2. 在 SQL Server 2005 中添加邮件帐户（account）

exec msdb..sysmail_add_account_sp
        @account_name            = 'p.c.w.l'                 -- 邮件帐户名称（SQL Server 使用）
       ,@email_address           = 'webmaster@sqlstudy.com'  -- 发件人邮件地址
       ,@display_name            = null                      -- 发件人姓名
       ,@replyto_address         = null
       ,@description             = null
       ,@mailserver_name         = '58.215.64.159'           -- 邮件服务器地址
       ,@mailserver_type         = 'SMTP'                    -- 邮件协议（SQL 2005 只支持 SMTP）
       ,@port                    = 25                        -- 邮件服务器端口
       ,@username                = 'webmaster@sqlstudy.com'  -- 用户名
       ,@password                = 'xxxxxxxxx'               -- 密码
       ,@use_default_credentials = 0
       ,@enable_ssl              = 0
       ,@account_id              = null

3. 在 SQL Server 2005 中添加 profile

exec msdb..sysmail_add_profile_sp @profile_name = 'dba_profile'      -- profile 名称 
                                 ,@description  = 'dba mail profile' -- profile 描述 
                                 ,@profile_id   = null

4. 在 SQL Server 2005 中映射 account 和 profile

exec msdb..sysmail_add_profileaccount_sp  @profile_name    = 'dba_profile' -- profile 名称 
                                         ,@account_name    = 'p.c.w.l'     -- account 名称 
                                         ,@sequence_number = 1             -- account 在 profile 中顺序 

5. 利用 SQL Server 2005 Database Mail 功能发送邮件。

exec msdb..sp_send_dbmail @profile_name =  'dba_profile'               -- profile 名称 
                         ,@recipients   =  'sqlstudy@163.com'          -- 收件人邮箱 
                         ,@subject      =  'SQL Server 2005 Mail Test' -- 邮件标题 
                         ,@body         =  'Hello Mail!'               -- 邮件内容 
                         ,@body_format  =  'TEXT'                      -- 邮件格式 

6. 查看邮件发送情况：

use msdb
go

select * from sysmail_allitems
select * from sysmail_mailitems
select * from sysmail_event_log

如果不是以 sa 帐户发送邮件，则可能会出现错误：

Msg 229, Level 14, State 5, Procedure sp_send_dbmail, Line 1
EXECUTE permission denied on object 'sp_send_dbmail', database 'msdb', schema 'dbo'.

这是因为，当前 SQL Server 登陆帐户（login），在 msdb 数据库中没有发送数据库邮件的权限， 需要加入 msdb 数据库用户，并通过加入 sp_addrolemember 角色赋予权限。假设该SQL Server 登陆帐户 名字为 “dba”

use msdb
go

create user dba for login dba
go

exec dbo.sp_addrolemember @rolename   = 'DatabaseMailUserRole',
                          @membername = 'dba'
go

此时，再次发送数据库邮件，仍可能有错误：

Msg 14607, Level 16, State 1, Procedure sp_send_dbmail, Line 119
profile name is not valid

虽然，数据库用户 “dba” 已经在 msdb 中拥有发送邮件的权限了， 但这还不够，他还需要有使用 profile：“dba_profile” 的权限。

use msdb
go

exec sysmail_add_principalprofile_sp  @principal_name = 'dba'
                                     ,@profile_name   = 'dba_profile'
                                     ,@is_default     = 1

从上面的参数 @is_default=1 可以看出，一个数据库用户可以在多个 mail profile 拥有发送权限。

现在，可以利用 SQL Server 2005 发送数据库邮件了吧。如仍有问题，请留言。

exec msdb..sp_send_dbmail
@profile_name='Hunter',                              --配置名稱
@recipients='XXX@XXX.com',           --收件者
@copy_recipients='XXX@XXX.com',      --副本抄送
@blind_copy_recipients='XXX@XXX.com',--密送
@subject='這是郵件主旨',                             --郵件主旨
@body=@tableHTML,                                    --郵件正文
@body_format=@bodyformat,                            --郵件格式
@importance='NORMAL',                                --郵件重要性,Low,Normal,High
@sensitivity='NORMAL',                               --敏感度,(普通,個人,私密,機密)Normal,Personal,Private,Confidential
@file_attachments='',                                --附件地址
@query=@sql,                                         --執行查詢語句
@execute_query_database='',
@attach_query_result_as_file=1,                      --是否有附件,1:有;0:沒有
@query_attachment_filename='Hunter.CSV',             --自定義附件名稱及後綴名
@query_result_header=1,
@query_result_width=256,
@query_result_separator=' ',
@exclude_query_output=0,
@append_query_error=0,
@query_no_truncate=0,
@mailitem_id= ''