• Статья

sysmail_configure_sp (Transact-SQL)

Изменяет настройки конфигурации компонента Database Mail. Настройки конфигурации, определенные процедурой 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 (неуспешное завершение)

Результирующие наборы

Нет

Замечания

Компонент Database Mail использует следующие параметры:

Имя параметра

Описание

Значение по умолчанию

AccountRetryAttempts

Число попыток, предпринимаемых процессом внешней почты для отправки сообщения электронной почты с использованием каждой учетной записи в указанном профиле.

1

AccountRetryDelay

Время ожидания процесса внешней почты между попытками отправить сообщение (в секундах).

5000

DatabaseMailExeMinimumLifeTime

Минимальное время в секундах, в течение которого остается активным процесс внешней почты. Когда компонент Database Mail рассылает большое количество сообщений, необходимо увеличить это значение, чтобы поддержать этот компонент в активном состоянии и избежать дополнительной нагрузки из-за частых остановок и запусков.

600

DefaultAttachmentEncoding

Кодировка для вложений электронной почты, используемая по умолчанию.

MIME

MaxFileSize

Максимальный размер вложения в байтах.

1000000

ProhibitedExtensions

Разделенный запятыми список расширений файлов, которые невозможно отправить в виде вложений в сообщение электронной почты.

EXE, DLL, VBS, JS

LoggingLevel

Укажите, какие сообщения записываются в журнал компонента Database Mail. Возможные значения: 1, 2 или 3.

  • 1 — Обычный режим. Регистрируются только ошибки.

  • 2 — Расширенный режим. Регистрируются ошибки, предупреждения и информационные сообщения.

  • 3 — Подробный режим. Регистрируются ошибки, предупреждения, информационные сообщения, сообщения об успешном выполнении и дополнительные внутренние сообщения. Используйте данный режим для диагностики.

2

Хранимая процедура sysmail_configure_sp находится в базе данных msdb и принадлежит схеме dbo. Процедуру следует выполнять с трехкомпонентным именем, если текущей базой данных является не msdb.

Разрешения

Разрешения на выполнение этой процедуры по умолчанию предоставляются членам предопределенной роли сервера sysadmin.

Примеры

А. Настройка компонента Database Mail на повторение попытки 10 раз для каждой учетной записи

В следующем примере показана настройка компонента Database Mail на повторение попытки для каждой учетной записи десять раз, прежде чем она будет воспринята как недоступная.

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

Б. Установка максимального размера вложения на 2 мегабайта

В следующем примере показана установка максимального размера вложения на 2 мегабайта.

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