Compartilhar via


Verificar o status de mensagens de email enviadas por Database Mail

Aplica-se a: SQL Server Instância Gerenciada de SQL do Azure

Este tópico descreve como verificar o status da mensagem de email enviada usando o Database Mail no SQL Server com o Transact-SQL.

  • Antes de começar:

  • Para exibir o status do email enviado usando o Database Mail, com: Transact-SQL

Antes de começar

O Database Mail mantém cópias das mensagens de email enviadas, que podem ser visualizadas nas exibições sysmail_allitems, sysmail_sentitems, sysmail_unsentitemse sysmail_faileditems do banco de dados msdb . O programa externo do Database Mail registra a atividade e exibe o log por meio 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).

Usando o Transact-SQL

Para exibir o status do email enviado usando Database Mail

  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, una a exibição sysmail_allitems à exibição sysmail_event_log na coluna mailitem_id , como mostra a seção a seguir.

    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 (Transact-SQL)

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  

Confira também

Log e auditoria do Database Mail