• Artigo

Como verificar o status de mensagens de email enviadas por Database Mail (Transact-SQL)

O Database Mail mantém cópias das mensagens de email enviadas, que podem ser visualizadas nas exibições sysmail_allitems, sysmail_sentitems, sysmail_unsentitems e sysmail_faileditems do banco de dados msdb. O programa externo do Database Mail registra a atividade e exibe o log através do Log de Eventos de Aplicativos do Windows e da exibição sysmail_event_log do banco de dados msdb. Para verificar o status de uma mensagem de email, execute uma consulta para essa exibição. São quatro os status possíveis das mensagens de email: sent (enviada), unsent (não enviada), retrying (tentando novamente) e failed (falhou).

Para verificar o status de uma mensagem de email

  1. Selecione na tabela sysmail_allitems as mensagens de interesse, especificando-as por mailitem_id ou sent_status.

  2. Para verificar o status retornado pelo programa externo para as mensagens de email, junte a exibição sysmail_allitems à exibição sysmail_event_log na coluna mailitem_id, como mostra a seção a seguir.

ObservaçãoObservação

Por padrão, o programa externo não registra informações sobre mensagens enviadas com êxito. Para registrar todas as mensagens, defina o nível de log como detalhado na página Configurar Parâmetros do Sistema do Assistente para Configuração do Database Mail.

Exemplo

O exemplo a seguir lista informações sobre todas as mensagens de email enviadas a danw que o programa externo não conseguiu enviar com êxito. A instrução lista o assunto, a data e a hora que o programa externo falhou em enviar a mensagem, além da mensagem de erro do log do Database Mail.

USE msdb ;
GO

-- Show the subject, the time that the mail item row was last
-- modified, and the log information.
-- Join sysmail_faileditems to sysmail_event_log 
-- on the mailitem_id column.
-- In the WHERE clause list items where danw was in the recipients,
-- copy_recipients, or blind_copy_recipients.
-- These are the items that would have been sent
-- to danw.

SELECT items.subject,
    items.last_mod_date
    ,l.description FROM dbo.sysmail_faileditems as items
INNER JOIN dbo.sysmail_event_log AS l
    ON items.mailitem_id = l.mailitem_id
WHERE items.recipients LIKE '%danw%'  
    OR items.copy_recipients LIKE '%danw%' 
    OR items.blind_copy_recipients LIKE '%danw%'
GO