sysmail_faileditems (Transact-SQL)
適用対象: 
SQL サーバー
失敗状態のデータベース メールメッセージごとに 1 行が含まれます。 このビューは、正しく送信されなかったメッセージを特定するときに使用できます。
データベース メールによって処理されたすべてのメッセージを表示するには、sysmail_allitems (Transact-SQL) を使用します。 未送信のメッセージのみを表示するには、 sysmail_unsentitems (Transact-SQL)を使用します。 送信されたメッセージのみを表示するには、 sysmail_sentitems (Transact-SQL)を使用します。 電子メールの添付ファイルを表示するには、 sysmail_mailattachments (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 | メッセージがメール キューから削除された日時。 |
| last_mod_date | datetime | 行の最後の変更の日時。 |
| last_mod_user | sysname | 行を最後に変更したユーザー。 |
解説
sysmail_faileditems ビューを使用して、データベース メールによって送信されなかったメッセージを確認します。 データベース メールのトラブルシューティングを行うとき、このビューでは送信されなかったメッセージの属性を確認できるので、問題の性質を特定するのに役立ちます。 エラーの理由を表示するには、 sysmail_event_log (Transact-SQL) ビューで失敗したメッセージのエントリを参照してください。
アクセス許可
sysadmin固定サーバー ロールと databasemailuserrole データベース ロールに付与されます。 固定サーバー ロール sysadmin のメンバーによって実行されると、このビューには失敗したすべてのメッセージが表示されます。 他のすべてのユーザーには、送信した失敗したメッセージのみが表示されます。