SQL Server:s p_send_dbmail参数设置

    添加时间:2013-6-21 点击量:

    s p_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_ = ] query_no_ ]
        
    [ , [ @mailitem_id = ] mailitem_id ] [ OUTPUT ]


     参数



    [ @profile_name= ] profile_name

    发送邮件的设备文件的名称。profile_name 的类型为 sysname,默认值为 NULL。profile_name 必须是现稀有据库邮件设备文件的名称。若是未指定 profile_name,则 s p_send_dbmail 应用当前用户的默认专用设备文件。若是该用户没有默认专用设备文件,s p_send_dbmail 会应用 msdb 数据库的默认公共设备文件。若是用户没有默认的专用设备文件,并且数据库也没有默认的公共设备文件,则必须指定 @profile_name


    [ @recipients= ] recipients

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


    [ @copy_recipients= ] copy_recipients

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


    [ @blind_copy_recipients= ] blind_copy_recipients

    要向其密件抄送邮件的电子邮件地址列表,以分号分隔。密件副本收件人列表的类型为 varchar(max)。固然此参数是可选参数,然则必须至少指定 @recipients@copy_recipients@blind_copy_recipients 中的一个,不然 s p_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 语句。请重视,查询在零丁的会话中履行,所以调用 s p_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 时,s p_send_dbmail 存储过程的履行将在把握台上打印作为查询履行成果而返回的消息。当此参数为 1 时,s p_send_dbmail 存储过程的履行不会在把握台上打印任何查询履行消息。


    [ @append_query_error= ] append_query_error

    指定是否在 @query 参数指定的查询返回错误时发送电子邮件。append_query_error 的数据类型为 bit,默认值为 0。若是此参数的值为 1,则数据库邮件会发送电子邮件,并电子邮件的正文中显示查询错误消息。若是此参数的值为 0,则数据库邮件不发送电子邮件,s p_send_dbmail 在停止时会返回代码 1,指导失败。


    [ @query_no_= ] query_no_

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







    重视:
    与多量数据一路应用时,@query_no_ 选项会占用其他资料,并可降落办事器的机能。

    我俩之间有着强烈的吸引力。短短几个小时后,我俩已经明白:我们的心是一个整体的两半,我俩的心灵是孪生兄妹,是知己。她让我感到更有活力,更完美,更幸福。即使她不在我身边,我依然还是感到幸福,因为她总是以这样或者那样的方式出现在我心头。——恩里克·巴里奥斯《爱的文明》
    分享到: