sysmail_help_queue_sp (Transact-SQL)

适用于SQL Server

数据库邮件中具有两个队列:邮件队列和状态队列。 邮件队列存储正在等待发送的邮件项。 状态队列存储已发送项的状态。 此存储过程允许查看邮件队列的状态或状态队列的状态。 如果未指定参数 @queue_type ,则存储过程为每个队列返回一行。

Transact-SQL 语法约定

语法

sysmail_help_queue_sp [ @queue_type = ] 'queue_type'
[ ; ]

参数

[ @queue_type = ] 'queue_type'

可选参数删除指定为 @queue_type的类型的电子邮件。 @queue_typenvarchar(6), 没有默认值。 有效条目为 mail *status

返回代码值

0(成功)或 1(失败)。

结果集

列名称 数据类型 描述
queue_type nvarchar(6) 队列的类型。 可能值为 mailstatus
length int 指定队列中邮件项的数量。
state nvarchar(64) 监视器的状态。 可能的值为 INACTIVE (队列处于非活动状态)、 NOTIFIED (队列已收到接收通知),以及 RECEIVES_OCCURRING (队列正在接收)。
last_empty_rowset_time datetime 上次队列为空的日期和时间。 采用军用时间格式和 GMT 时区。
last_activated_time datetime 上次激活队列的日期和时间。 采用军用时间格式和 GMT 时区。

注解

排查数据库邮件问题时,用于sysmail_help_queue_sp查看队列中的项数、队列的状态以及上次激活时间。

权限

默认情况下,只有 sysadmin 固定服务器角色的成员才能访问此过程。

示例

以下示例返回邮件队列和状态队列。

EXEC 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)