sysmail_faileditems (Transact-SQL)

适用于：SQL Server

对于状态为失败的每个数据库邮件消息包含一行。 使用该视图可确定未成功发送的消息。

若要查看数据库邮件处理的所有消息，请使用 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）	消息的主题行。
正文	varchar(max)	邮件的正文。
body_format	varchar（20）	消息正文的格式。 可能值为 TEXT 和 HTML。
importance	varchar（6）	消息的重要性参数。
sensitivity	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	提交消息的用户。 这是数据库邮件过程的用户上下文，不是邮件的“发件人:”字段。
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 固定服务器角色的成员执行时，此视图将显示所有失败的消息。 所有其他用户仅可查看他们已提交的失败的消息。