sysmail_help_queue_sp (Transact-SQL)
適用対象: 
SQL サーバー
データベース メールには、メール キューと状態キューの 2 つのキューがあります。 メール キューには、送信待ちのメール アイテムが格納され、 状態キューには、送信済みのアイテムの状態が格納されます。 このストアド プロシージャを使用すると、メールキューまたはステータスキューの状態を表示できます。 パラメーター @queue_type が指定されていない場合、ストアド プロシージャはキューごとに 1 行を返します。
構文
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 タイム ゾーン。 |
解説
データベース メールのトラブルシューティングを行うときは、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)