sysmail_faileditems (Transact-SQL)
Contém uma linha para cada mensagem do Database Mail com o status de falha. Use esta exibição para determinar quais mensagens não foram enviadas com êxito.
Para consultar todas as mensagens processadas pelo Database Mail, use sysmail_allitems (Transact-SQL). Para consultar somente as mensagens não enviadas, use sysmail_unsentitems (Transact-SQL). Para consultar somente as mensagens que foram enviadas, use sysmail_sentitems (Transact-SQL). Para exibir anexos de email, use sysmail_mailattachments (Transact-SQL).
Nome da coluna |
Tipo de dados |
Descrição |
---|---|---|
mailitem_id |
int |
Identificador do item de email na fila de email. |
profile_id |
int |
O identificador do perfil usado para enviar a mensagem. |
recipients |
varchar(max) |
Os endereços de email dos destinatários da mensagem. |
copy_recipients |
varchar(max) |
Os endereços de email daqueles que recebem cópias da mensagem. |
blind_copy_recipients |
varchar(max) |
Os endereços de email daqueles que recebem cópias da mensagem, mas cujos nomes não aparecem no cabeçalho. |
subject |
nvarchar(510) |
A linha de assunto da mensagem. |
body |
varchar(max) |
O corpo da mensagem. |
body_format |
varchar(20) |
O formato do corpo da mensagem. Os valores possíveis são TEXT e HTML. |
importance |
varchar(6) |
O parâmetro de importância da mensagem. |
sensibilidade |
varchar(12) |
O parâmetro de sensibilidade da mensagem. |
file_attachments |
varchar(max) |
Uma lista delimitada por ponto e vírgula de nomes de arquivo anexados à mensagem de email. |
Attachment_encoding |
varchar(20) |
O tipo de anexo de email. |
Query |
varchar(max) |
A consulta executada pelo programa de email. |
execute_query_database |
sysname |
O contexto de banco de dados no qual o programa de email executou a consulta. |
attach_query_result_as_file |
bit |
Quando o valor é 0, os resultados da consulta são incluídos no corpo da mensagem de email, depois do conteúdo do corpo. Quando o valor é 1, os resultados são retornados como um anexo. |
query_result_header |
bit |
Quando o valor é 1, os resultados da consulta contêm cabeçalhos de coluna. Quando o valor é 0, resultados da consulta não incluem cabeçalhos de coluna. |
query_result_width |
int |
O parâmetro query_result_width da mensagem. |
query_result_separator |
char(1) |
O caractere usado para separar as colunas na saída da consulta. |
exclude_query_output |
bit |
O parâmetro exclude_query_output da mensagem. Para obter mais informações, consulte sp_send_dbmail (Transact-SQL). |
append_query_error |
bit |
O parâmetro append_query_error da mensagem. 0 indica que o Database Mail não deverá enviar a mensagem de email se houver um erro na consulta. |
send_request_date |
datetime |
A data e a hora em que a mensagem foi colocada na fila de email. |
send_request_user |
sysname |
O usuário que enviou a mensagem. Esse é o contexto de usuário do procedimento de email do banco de dados, e não o campo De da mensagem. |
sent_account_id |
int |
O identificador da conta do Database Mail usado para enviar a mensagem. Será sempre NULL para essa exibição. |
sent_status |
varchar(8) |
O status do email. Sempre falha para esta exibição. |
sent_date |
datetime |
A data e a hora em que a mensagem foi removida da fila de email. |
last_mod_date |
datetime |
A data e a hora da última modificação da linha. |
last_mod_user |
sysname |
O usuário que modificou a linha pela última vez. |
Comentários
Use a exibição sysmail_faileditems para ver quais mensagens não foram enviadas pelo Database Mail. Na solução de problemas do Database Mail, essa exibição pode ajudá-lo a identificar a natureza do problema, mostrando os atributos das mensagens que não foram enviadas. Para exibir o motivo da falha, consulte a entrada para a mensagem que falhou na exibição sysmail_event_log (Transact-SQL).
Permissões
Concedidas à função de servidor fixa sysadmin e à função de banco de dados databasemailuserrole. Quando executada por um membro da função de servidor fixa sysadmin, essa exibição mostra todas as mensagens que falharam. Todos os demais usuários veem somente as mensagens que falharam que eles submeteram.