sysmail_help_queue_sp (Transact-SQL)
适用范围：
SQL Server
数据库邮件中具有两个队列：邮件队列和状态队列。 邮件队列存储正在等待发送的邮件项。 状态队列存储已发送的项目的状态。 此存储过程允许查看邮件队列的状态或状态队列的状态。 如果未指定参数 @queue_type ，则存储过程为每个队列返回一行。
语法
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 时区。 |
注解
排查数据库邮件问题时，用于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)