sysmail_help_queue_sp (Transact-SQL)

適用対象:SQL Server

データベース メールには、メール キューと状態キューの 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)

関連するコンテンツ

• データベース メール