更改数据库邮件的配置设置。使用 sysmail_configure_sp 指定的配置设置适用于整个 SQL Server 实例。
语法
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,则该过程必须使用由三部分组成的名称执行。
权限
默认情况下,sysadmin 固定服务器角色的成员有执行此过程的权限。
示例
A. 设置数据库邮件,使其重试每个帐户 10 次
以下示例将设置数据库邮件,使其重试每个帐户十次,然后才认为帐户不可访问。
复制代码 | |
---|---|
EXECUTE msdb.dbo.sysmail_configure_sp 'AccountRetryAttempts', '10' ; |
B. 将附件的最大大小设置为 2 MB
以下示例将把附件的最大大小设置为 2 MB。
复制代码 | |
---|---|
EXECUTE msdb.dbo.sysmail_configure_sp 'MaxFileSize', '2097152' ; |