Бөлісу құралы:


sysmail_help_queue_sp (Transact-SQL)

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

Существует две очереди в компоненте Database Mail: очередь почты и очередь состояний. Очередь почты содержит почтовые сообщения, ожидающие отправки. Очередь состояний содержит информацию о состоянии сообщений, которые уже были отправлены. Эта хранимая процедура позволяет просмотреть состояние очередей почты и состояний. Если параметр @queue_type не указан, хранимая процедура возвращает одну строку для каждой очереди.

Соглашения о синтаксисе Transact-SQL

Синтаксис

sysmail_help_queue_sp [ @queue_type = ] 'queue_type'
[ ; ]

Аргументы

[ @queue_type = ] 'queue_type'

Необязательный аргумент удаляет сообщения электронной почты типа, указанного в качестве @queue_type. @queue_type — nvarchar(6) без значения по умолчанию. Допустимые записи: mail и *status.

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

0 (успешно) или 1 (сбой).

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

Имя столбца Тип данных Description
queue_type nvarchar(6) Тип очереди. Возможные значения: mail и status.
length int Номер почтового сообщения в указанной очереди.
state nvarchar(64) Состояние монитора. Возможные значения: INACTIVE (очередь неактивна), NOTIFIED (очередь была уведомлена о получении квитанции) и RECEIVES_OCCURRING (очередь получает).
last_empty_rowset_time datetime Дата и время, когда очередь в последний раз была пуста. Указывается в военном формате времени относительно часового пояса GMT.
last_activated_time datetime Дата и время, когда очередь в последний раз была активирована. Указывается в военном формате времени относительно часового пояса GMT.

Замечания

При устранении неполадок с Database Mail используйте sysmail_help_queue_sp для просмотра количества элементов в очереди, состояния очереди и времени последнего активации.

Разрешения

По умолчанию доступ к этой процедуре может получить только члены предопределенных ролей сервера sysadmin .

Примеры

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

EXEC msdb.dbo.sysmail_help_queue_sp;
GO

Образец результирующего набора, отредактированный по длине строк:

queue_type length      state              last_empty_rowset_time  last_activated_time
---------- -------- ------------------ ----------------------- -----------------------
mail       0        RECEIVES_OCCURRING 2005-10-07 21:14:47.010 2005-10-10 20:52:51.517
status     0        INACTIVE           2005-10-07 21:04:47.003 2005-10-10 21:04:47.003

(2 row(s) affected)