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';