sysmail_faileditems (Transact-SQL)
具有 failed 状态的每个数据库邮件都在视图中占一行。使用该视图可确定未成功发送的消息。
若要查看数据库邮件处理的所有消息，请使用 sysmail_allitems (Transact-SQL)。若要仅查看未发送的消息，请使用 sysmail_unsentitems (Transact-SQL)。若要仅查看已发送的消息，请使用 sysmail_sentitems (Transact-SQL)。若要查看电子邮件附件，请使用 sysmail_mailattachments (Transact-SQL)。
列名 |
数据类型 |
说明 |
|---|---|---|
mailitem_id |
int |
邮件队列中邮件项的标识符。 |
profile_id |
int |
提交消息所用配置文件的标识符。 |
recipients |
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 参数。 |
sensitivity |
varchar(12) |
消息的 sensitivity 参数。 |
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) |
邮件的状态。对于该视图，始终为 failed。 |
sent_date |
datetime |
从邮件队列中删除消息的日期和时间。 |
last_mod_date |
datetime |
上次修改行的日期和时间。 |
last_mod_user |
sysname |
上次修改行的用户。 |
注释
使用 sysmail_faileditems 视图可查看数据库邮件未发送的消息。排除数据库邮件故障时，该视图可以向您显示未发送的消息的属性，从而帮助您确定问题的性质。若要查看失败的原因，请参阅 sysmail_event_log (Transact-SQL) 视图中失败消息的项。
权限
授予 sysadmin 固定服务器角色和 databasemailuserrole 数据库角色。当由 sysadmin 固定服务器角色的成员执行时，该视图显示所有失败的消息。所有其他用户仅可查看他们已提交的失败的消息。