sysmail_unsentitems (Transact-SQL)

適用対象: SQL Server Azure SQL Managed Instance

unsent または retrying 状態のデータベース メールメッセージごとに 1 行が含まれます。 未送信または再試行中の状態のメッセージはメール キューに残っており、いつでも送信できます。 メッセージには、次の理由により、 unsent 状態が含まれる場合があります。

• メッセージが新しく、メール キューに挿入されていても、データベース メールが他のメッセージの処理中でこのメッセージに達していない。

• データベース メール外部プログラムが実行されておらず、メールが送信されていない

メッセージには、次の理由により、 retrying 状態が含まれる場合があります。

• データベース メールでメッセージの送信が試行されたが、SMTP メール サーバーに接続できなかった。 データベース メールは、メッセージを送信したプロファイルに割り当てられている他のデータベース メール アカウントを使用して、メッセージの送信を試みます。 アカウントがメールを送信できない場合、データベース メールは Account Retry Delay パラメーターに対して構成された時間の長さを待機し、メッセージの再送信を試みます。 データベース メールはを使用しますAccount Retry Attempts パラメーターを使用して、メッセージの送信を試行する回数を決定します。 メッセージ送信データベース メールがメッセージを送信しようとしている限り、状態は保持されます。

このビューは、送信待ちメッセージの数と、それらのメール キューでの待機時間を確認する場合に使用できます。 通常、 送信 メッセージの数は少なくなります。 通常の操作中にベンチマーク テストを実施して、操作のメッセージ キュー内の妥当な数のメッセージを決定します。

データベース メールによって処理されたすべてのメッセージを表示するには、sysmail_allitems (Transact-SQL) を使用します。 失敗した状態のメッセージのみを表示するには、 sysmail_faileditems (Transact-SQL)を使用します。 送信されたメッセージのみを表示するには、 sysmail_sentitems (Transact-SQL)を使用します。

列名	データ型	説明
mailitem_id	int	メール キュー内のメール アイテムの識別子。
profile_id	int	メッセージの送信に使用されるプロファイルの識別子。
受信者	varchar(max)	メッセージ受信者の電子メール アドレス。
copy_recipients	varchar(max)	メッセージのコピーを受信したユーザーの電子メール アドレス。
blind_copy_recipients	varchar(max)	メッセージのコピーを受信したが、メッセージ ヘッダーに名前が表示されないユーザーの電子メール アドレス。
subject	nvarchar(510)	メッセージの件名行。
body	varchar(max)	メッセージの本文です。
body_format	varchar(20)	メッセージの本文形式。 指定できる値は、 TEXT と HTML です。
importance	varchar(6)	メッセージの importance パラメーター。
感度	varchar(12)	メッセージの センシティビティ パラメーター。
file_attachments	varchar(max)	電子メール メッセージに添付されたファイル名の、セミコロン区切りの一覧。
attachment_encoding	varchar(20)	メールの添付ファイルの種類。
クエリ	varchar(max)	メール プログラムによって実行されるクエリ。
execute_query_database	sysname	メール プログラムがクエリを実行したデータベース コンテキスト。
attach_query_result_as_file	bit	値が 0 の場合、本文の内容の後の電子メール メッセージの本文にクエリ結果が含まれていました。 値が 1 の場合、結果が添付ファイルとして返されたことを示します。
query_result_header	bit	値が 1 の場合、クエリ結果には列ヘッダーが含まれていました。 値が 0 の場合、クエリの結果に列のヘッダーが含まれていないことを示します。
query_result_width	int	メッセージの query_result_width パラメーター。
query_result_separator	char(1)	クエリの出力で列の区切りに使用された文字。
exclude_query_output	bit	メッセージの exclude_query_output パラメーター。 詳細については、「 sp_send_dbmail (Transact-SQL)」を参照してください。
append_query_error	bit	メッセージの append_query_error パラメーター。 0 は、クエリにエラーがあった場合、データベース メールで電子メール メッセージが送信されないことを示します。
send_request_date	datetime	メッセージがメール キューに配置された日時。
send_request_user	sysname	メッセージを送信したユーザー。 これは、メッセージの From フィールドではなく、データベース メール プロシージャのユーザー コンテキストです。
sent_account_id	int	メッセージの送信に使用するデータベース メール アカウントの識別子。 このビューの場合は常に NULL。
sent_status	varchar(8)	データベース メールがメールの送信を試みなかった場合は送信されません。 データベース メールがメッセージの送信に失敗したが再試行中の場合は、再試行されます。
sent_date	datetime	データベース メールが最後にメールを送信しようとした日時。 データベース メールでメッセージの送信が試行されていない場合は NULL になります。
last_mod_date	datetime	行の最後の変更の日時。
last_mod_user	sysname	行を最後に変更したユーザー。

解説

データベース メールのトラブルシューティングを行うとき、このビューでは送信済みのメッセージ数とメッセージの待機時間を確認できるので、問題の性質を特定するのに役立ちます。 メッセージが 1 つも送信されていない場合は、データベース メール外部プログラムが動作していないか、ネットワークの問題によってデータベース メールから SMTP サーバーへの接続に障害が発生している可能性があります。 送信されていないメッセージの多くが同じ profile_idを持っている場合は、SMTP サーバーに問題がある可能性があります。 プロファイルにアカウントを追加することを検討してください。 メッセージが送信されていても、メッセージがキューに多くの時間を費やしている場合、SQL Server では、必要なメッセージの量を処理するために必要なリソースが増える可能性があります。

アクセス許可

sysadmin固定サーバー ロールと DatabaseMailUserRole データベース ロールに付与されます。 sysadmin固定サーバー ロールのメンバーによって実行されると、このビューには、すべてのunsentまたはretrying メッセージが表示されます。 他のすべてのユーザーには、送信したまたはメッセージのみが表示されます。