sysmail_help_queue_sp (Transact-SQL)
数据库邮件中具有两个队列:邮件队列和状态队列。邮件队列存储正在等待发送的邮件项。状态队列存储已发送项的状态。此存储过程允许查看邮件队列的状态或状态队列的状态。如果未指定参数 @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 |
上次队列为空的日期和时间。采用 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)