sysmail_stop_sp (Transact-SQL)

Прекращает работу компонента Database Mail, останавливая работу объектов компонента Service Broker, используемых внешней программой.

Значок ссылки на разделСинтаксические обозначения в Transact-SQL

Синтаксис

sysmail_stop_sp

Аргументы

Нет.

Значения кодов возврата

0 (успешное завершение) или 1 (неуспешное завершение)

Замечания

Эта хранимая процедура содержится в базе данных msdb.

Она останавливает обработку очереди компонента Database Mail, содержащей исходящие запросы, и выполняет деактивацию компонента Service Broker для внешней программы.

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

Для запуска компонента Database Mail используйте процедуру sysmail_start_sp. Обратите внимание, что хранимая процедура sp_send_dbmail продолжает принимать почту и после остановки объектов компонента Service Broker.

ПримечаниеПримечание

Эта хранимая процедура останавливает только обработку очередей компонента Database Mail. Она не деактивирует доставку сообщений компонента Service Broker в базе данных. Дополнительные сведения о деактивации компонента Service Broker для доставки сообщений см. в разделе Как деактивировать доставку сообщений компонента Service Broker в базах данных (Transact-SQL). Эта системная процедура не отключает расширенные хранимые процедуры компонента Database Mail, т. е. не сокращает контактную зону. Для отключения расширенных хранимых процедур используйте Параметр Database Mail XPs системной хранимой процедуры sp_configure.

Разрешения

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

Примеры

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

USE msdb ;
GO

EXECUTE dbo.sysmail_stop_sp ;
GO