Início / dba / Perguntas / 227060
Accepted
youcantryreachingme
Asked: 2019-01-14 21:57:52 +0800 CST

Quais são os valores de retorno sp_send_dbmail?

  • 772

Eu tenho um e-mail falhando com o valor de retorno da função de '101' e @@error valor de '0' (nenhuma linha é adicionada a sysmail_allitems).

Onde posso encontrar documentação sobre códigos de retorno para esta função?

Código de exemplo mostrando como obtenho os valores acima:

exec @result = msdb.dbo.sp_send_dbmail
    @profile_name = 'OBFUSCATED',  
    @recipients = @DL,  
    @subject = 'OBFUSCATED',
    @body = @emailBody,
    @body_format='html',
    @query = @reportQuery,
    @exclude_query_output = 1,
    @attach_query_result_as_file = 1,
    @query_attachment_filename = @filename,
    @query_result_separator = @temp,
    @query_result_header = 1,
    @mailitem_id = @mailitem_id
    ;

    set @temp = @@ERROR;
sql-server database-mail

2 respostas

  1. Best Answer

    O código de erro 101 ocorre porque o anexo do resultado da consulta é maior que a opção de configuração do Database Mail "MaxFileSize".

    Investigação

    Minha primeira tentativa de descobrir isso foi executar sp_helpttexto sp_send_dbmailprocedimento para analisar a implementação:

    EXEC sp_helptext 'sp_send_dbmail';

    O corpo principal desse procedimento retorna vários códigos de status diferentes, de 0 a 21. Ele não menciona 101. No entanto, ele chama alguns outros procedimentos armazenados, como sysmail_verify_profile_sp, então dei uma olhada nele:

    EXEC sp_helptext 'sysmail_verify_profile_sp';

    Mas isso só retorna códigos de 0 a 4.

    Mais tarde o proc chama em sysmail_verify_addressparams_sp, vamos dar uma olhada:

    EXEC sp_helptext 'sysmail_verify_addressparams_sp';

    Shucks, que retorna apenas 0 ou 1.

    A seguir é sp_RunMailQuery:

    EXEC sp_helptext 'sp_RunMailQuery';

    Ele chama sysmail_help_configure_value_spe sp_isprohibited, ambos retornando apenas 0 ou 1.

    Caixa preta

    No final de sp_RunMailQuery, um procedimento armazenado estendido do sistema é chamado: xp_sysmail_format_query.

    Não podemos pegar o código-fonte para isso, mas tive um palpite no início do proc:

    --Get the maximum file size allowed for attachments from sysmailconfig.  
EXEC msdb.dbo.sysmail_help_configure_value_sp @parameter_name = N'MaxFileSize',   
                                            @parameter_value = @fileSizeStr OUTPUT

    Percebi que você está usando o parâmetro attachment e os resultados da consulta + tamanho máximo do arquivo também são passados ​​para o procedimento armazenado estendido.

    Cidade de reprodução

    Configurei o tamanho máximo do arquivo do Database Mail para 10 bytes e executei:

    DECLARE @result AS INT;

exec @result = msdb.dbo.sp_send_dbmail
    @profile_name = 'DBMail',  
    @recipients = '[email protected]',  
    @subject = 'This is the subject',
    @body = 'This is the body',
    @body_format='html',
    @query = 'SELECT * FROM sys.messages;',
    @exclude_query_output = 1,
    @attach_query_result_as_file = 1,
    @query_attachment_filename = 'big-file.csv',
    @query_result_separator = '===',
    @query_result_header = 1;

SELECT @result;

    Nota: a tabela "sys.messages" tem um monte de dados de string que eu sabia que seriam mais de 10 bytes.

    E com certeza, eu tenho 101 como o código de retorno:

    Erro 101

    Bugz

    Como CR241 apontou , a documentação diz que @@ERROR deve conter o número de identificação do erro que corresponde à mensagem de erro apropriada na sys.messagestabela:

    O código de erro para a instrução que falhou é armazenado na variável @@ERROR. - sp_send_dbmail - Valores de código de retorno

    Em vez disso, é 0 no meu teste (que você observou na sua pergunta original). Isso me parece um bug.

    • 11

  2. De acordo com sp_send_dbmail

    Valores do código de retorno:

    Um código de retorno de 0 significa sucesso. Qualquer outro valor significa falha.

    O código de erro para a instrução que falhou é armazenado na @@ERRORvariável.

    sp_send_dbmail()retorna 0se o processo de envio de e-mails pode ser iniciado sem erro. Isso significa que os e-mails foram definidos na fila de e-mails do banco de dados e, para cada e-mail, o mailitem_idvalor da mensagem é retornado no conjunto de resultados.

    Qualquer valor de retorno diferente de 0significa erro. O código de erro preciso da instrução com falha pode ser visto em @@ERROR.

    Depois de usar sp_send_dbmail(), o email é enviado de forma assíncrona e ainda pode falhar por vários motivos. Portanto, se sp_send_dbmail()retornar 0, não significa sucesso final.

    Você pode olhar msdb.dbo.sysmail_faileditemscomo no caso de erro.

    • 2

relate perguntas