Поделиться через


sysmail_configure_sp (Transact-SQL)

Область применения: SQL Server

Изменяет настройки конфигурации компонента 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 использует следующие параметры:

Наименование параметра Description Default value
AccountRetryAttempts Число попыток, предпринимаемых процессом внешней почты для отправки сообщения электронной почты с использованием каждой учетной записи в указанном профиле. 1
AccountRetryDelay Время ожидания процесса внешней почты между попытками отправить сообщение (в секундах). 5000
DatabaseMailExeMinimumLifeTime Минимальное время в секундах, в течение которого остается активным процесс внешней почты. Когда компонент Database Mail рассылает большое количество сообщений, необходимо увеличить это значение, чтобы поддержать этот компонент в активном состоянии и избежать дополнительной нагрузки из-за частых остановок и запусков. 600
DefaultAttachmentEncoding Кодировка для вложений электронной почты, используемая по умолчанию. MIME
MaxFileSize Максимальный размер вложения в байтах. 1000000
ProhibitedExtensions Разделенный запятыми список расширений, которые не могут быть отправлены в виде вложения в сообщение электронной почты. exe,dll,vbs,js
LoggingLevel Укажите, какие сообщения записываются в журнал компонента Database Mail. Одно из следующих числовых значений:

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

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

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

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

Разрешения

Эта хранимая процедура принадлежит роли db_owner . Вы можете предоставить EXECUTE разрешения для любого пользователя, но эти разрешения могут быть переопределены во время обновления SQL Server.

Примеры

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

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

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

B. Задайте максимальный размер вложения в 2 мегабайта

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

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