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

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является.

Разрешения

Требуется CONTROL SERVER разрешение на сервер или членство в роли базы данных db_owner в msdb базе данных.

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

Примеры

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

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

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

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

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

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

Связанный контент