共用方式為

  • 發行項

sysmail_help_queue_sp (Transact-SQL)

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)

佇列的類型。可能的值是 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)