• Статья

sysmail_help_queue_sp (Transact-SQL)

Существуют две очереди в компоненте 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 (неуспешное завершение)

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

Имя столбца

Тип данных

Описание

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)