sysmail_help_queue_sp (Transact-SQL)
Существуют две очереди в компоненте Database Mail: очередь почты и очередь состояний. Очередь почты содержит почтовые сообщения, ожидающие отправки. Очередь состояний содержит информацию о состоянии сообщений, которые уже были отправлены. Эта хранимая процедура позволяет просмотреть состояние очередей почты и состояний. Если аргумент @queue_type не указан, хранимая процедура возвращает по одной строке для каждой из очередей.
.gif "Значок ссылки на раздел")
Синтаксические обозначения в Transact-SQL
Синтаксис
sysmail_help_queue_sp [ @queue_type = ] 'queue_type'
Аргументы
- [ @queue_type = ] 'queue_type'
Дополнительный аргумент удаляет сообщения электронной почты, принадлежащие к типу, указанному в аргументе queue_type. Аргумент queue_type имеет тип nvarchar(6) и не имеет значения по умолчанию. Допустимыми значениями являются mail и status.
Значения кода возврата
0 (успешное завершение) или 1 (неудачное завершение)
Результирующий набор
Имя столбца |
Тип данных |
Описание |
|---|---|---|
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 могут получить доступ к этой процедуре.
Примеры
В следующем примере возвращаются очередь почты и очередь состояний.
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)