sysmail_help_queue_sp (Transact-SQL)

適用対象: SQL サーバー

データベース メールには、メール キューと状態キューの 2 つのキューがあります。 メール キューには、送信待ちのメール アイテムが格納され、 状態キューには、送信済みのアイテムの状態が格納されます。 このストアド プロシージャを使用すると、メールキューまたはステータスキューの状態を表示できます。 パラメーター @queue_type が指定されていない場合、ストアド プロシージャはキューごとに 1 行を返します。

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 タイム ゾーン。

解説

データベース メールのトラブルシューティングを行うときは、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)

関連するコンテンツ

• データベース メール