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
для просмотра количества элементов в очереди, состояния очереди и времени последнего активации.
Разрешения
Необходимо разрешение CONTROL SERVER
на сервере.
Примеры
В следующем примере возвращаются очередь почты и очередь состояний.
EXECUTE 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)