• 项目

sysmail_configure_sp (Transact-SQL)

更改数据库邮件的配置设置。使用 sysmail_configure_sp 指定的配置设置适用于整个 SQL Server 实例。

主题链接图标Transact-SQL 语法约定

语法

sysmail_configure_sp [ [ @parameter_name = ] 'parameter_name' ]
    [ , [ @parameter_value = ] 'parameter_value' ]
    [ , [ @description = ] 'description' ]

参数

  • [@parameter_name = ] 'parameter_name'
    要更改的参数的名称。

  • [@parameter_value = ] 'parameter_value'
    参数的新值。

  • [@description = ] 'description'
    参数的说明。

返回代码值

0（成功）或 1（失败）

结果集

无

注释

数据库邮件使用以下参数：

参数名

说明

默认值

AccountRetryAttempts

外部电子邮件进程尝试使用指定配置文件中的每个帐户发送电子邮件的次数。

1

AccountRetryDelay

外部邮件进程在两次尝试发送邮件之间的等待时间（以秒为单位）。

5000

DatabaseMailExeMinimumLifeTime

外部邮件进程保持活动状态的最少时间（以秒为单位）。如果数据库邮件要发送多个邮件，增加此值可以使数据库邮件保持活动状态，避免频繁启动和停止的开销。

600

DefaultAttachmentEncoding

电子邮件附件的默认编码。

MIME

MaxFileSize

附件的最大大小（以字节为单位）。

1000000

ProhibitedExtensions

一组以逗号分隔的扩展名，具有这些扩展名的文件不能作为电子邮件附件发送。

exe,dll,vbs,js

LoggingLevel

指定数据库邮件日志中要记录的消息。可能值为 1、2 或 3。

  • 1 - 表示正常模式。仅记录错误。

  • 2 - 表示扩展模式。记录错误、警告和信息性消息。

  • 3 - 表示详细模式。记录错误、警告、信息性消息、成功消息和其他内部消息。该模式用于进行故障排除。

2

存储过程 sysmail_configure_sp 在 msdb 数据库中，归属于 dbo 架构。如果当前数据库不是 msdb，则该过程必须使用由三部分组成的名称执行。

权限

默认情况下，sysadmin 固定服务器角色的成员有执行此过程的权限。

示例

A. 设置数据库邮件，使其重试每个帐户 10 次

以下示例将设置数据库邮件，使其重试每个帐户十次，然后才认为帐户不可访问。

EXECUTE msdb.dbo.sysmail_configure_sp
    'AccountRetryAttempts', '10' ;

B. 将附件的最大大小设置为 2 MB

以下示例将把附件的最大大小设置为 2 MB。

EXECUTE msdb.dbo.sysmail_configure_sp
    'MaxFileSize', '2097152' ;