• 项目

sysmail_help_queue_sp (Transact-SQL)

数据库邮件中具有两个队列：邮件队列和状态队列。邮件队列存储正在等待发送的邮件项。状态队列存储已发送项的状态。此存储过程允许查看邮件队列的状态或状态队列的状态。如果未指定参数 @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

上次队列为空的日期和时间。采用 24 小时制和 GMT 时区。

last_activated_time

DATETIME

上次激活队列的日期和时间。采用军用时间格式和 GMT 时区。

注释

排除数据库邮件故障时，请使用 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)