sysmail_configure_sp (Transact-SQL)

适用于SQL Server

更改数据库邮件的配置设置。 指定的 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 - 表示详细模式。 记录错误、警告、信息性消息、成功消息和其他内部消息。 该模式用于进行故障排除。
2

存储过程 sysmail_configure_sp 位于 msdb 数据库中,由 dbo 架构拥有。 如果当前数据库不是 msdb,则必须使用三部分名称执行该过程。

权限

此存储过程由 db_owner 角色拥有。 你可以为任何用户授予 EXECUTE 权限,但这些权限可能会在 SQL Server 升级期间被重写。

示例

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

以下示例显示设置数据库邮件以重试每个帐户 10 次,然后再将帐户视为无法访问。

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

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

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

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