sysmail_help_queue_sp (Transact-SQL)

適用於:SQL Server

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) 佇列的類型。 可能的值是 mailstatus
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 查看佇列中的項目數目、佇列的狀態,以及上次啟用的時間。

權限

根據預設,只有系統管理員固定伺服器角色的成員才能存取此程式。

範例

下列範例會傳回郵件和狀態佇列。

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)