sysmail_help_queue_sp (Transact-SQL)
Database Mail 中有兩個佇列：郵件佇列和狀態佇列。郵件佇列儲存等候傳送的郵件項目。狀態佇列儲存已傳送之項目的狀態。這個預存程序可檢視郵件或狀態佇列的狀態。如果未指定參數 @queue_type，預存程序會針對每個佇列，各傳回一個資料列。
.gif "主題連結圖示")
語法
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 時區表示。 |
備註
針對 Database Mail 進行疑難排解時，請使用 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)