sysmail_help_queue_sp （Transact-SQL）
適用於：
SQL Server
Database Mail 中有兩個佇列：郵件佇列和狀態佇列。 郵件佇列會儲存正在等候傳送的郵件專案。 狀態佇列會儲存已傳送的項目狀態。 此預存程式允許檢視郵件或狀態佇列的狀態。 如果未指定參數 @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 時區表示。 |
備註
針對 Database Mail 進行疑難解答時，請使用 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)