• Artigo

sysmail_configure_sp (Transact-SQL)

Altera definições de configuração do Database Mail. As definições de configuração especificadas com sysmail_configure_sp são aplicadas à instância inteira do SQL Server.

Ícone de vínculo de tópicoConvenções de sintaxe Transact-SQL

Sintaxe

sysmail_configure_sp [ [ @parameter_name = ] 'parameter_name' ]
    [ , [ @parameter_value = ] 'parameter_value' ]
    [ , [ @description = ] 'description' ]

Argumentos

  • [@parameter_name = ] 'parameter_name'
    O nome do parâmetro a ser alterado.

  • [@parameter_value = ] 'parameter_value'
    O novo valor do parâmetro.

  • [@description = ] 'description'
    Uma descrição do parâmetro.

Valores de código de retorno

0 (êxito) ou 1 (falha)

Conjuntos de resultados

Nenhum

Comentários

O Database Mail usa os seguintes parâmetros:

Nome do parâmetro

Descrição

Valor padrão

AccountRetryAttempts

O número de vezes que o processo de email externo tenta enviar a mensagem de email usando cada conta no perfil especificado.

1

AccountRetryDelay

O período de tempo, em segundos, que o processo de email externo deve esperar entre tentativas de envio de uma mensagem.

5000

DatabaseMailExeMinimumLifeTime

O período mínimo de tempo, em segundos, que o processo de email externo permanece ativo. Quando o Database Mail estiver enviando muitas mensagens, aumente este valor para manter o Database Mail ativo e evitar a sobrecarga de inícios e paradas freqüentes.

600

DefaultAttachmentEncoding

A codificação padrão para anexos de email.

MIME

MaxFileSize

O tamanho máximo de um anexo, em bytes.

1000000

ProhibitedExtensions

Uma lista separada por vírgula de extensões que não podem ser enviadas como um anexo a uma mensagem de email.

exe,dll,vbs,js

LoggingLevel

Especifique quais mensagens são registradas no log do Database Mail. Os valores possíveis são 1, 2 ou 3.

  • 1 - Este é o modo normal. Registra apenas erros.

  • 2 - Este é o modo estendido. Registra erros, avisos e mensagens informativas.

  • 3 - Este é o modo detalhado. Registra erros, avisos, mensagens informativas, mensagens de êxito e mensagens internas adicionais. Use este modo para diagnóstico.

2

O procedimento armazenado sysmail_configure_sp está no banco de dados msdb e pertence ao esquema dbo. O procedimento deverá ser executado com um nome de três partes se o banco de dados atual não for msdb.

Permissões

As permissões de execução deste procedimento usam como padrão membros da função de servidor fixa sysadmin.

Exemplos

A. Definindo o Database Mail para repetir cada conta 10 vezes

O exemplo a seguir mostra a definição do Database Mail para repetir cada conta dez vezes antes de considerá-la inacessível.

EXECUTE msdb.dbo.sysmail_configure_sp
    'AccountRetryAttempts', '10' ;

B. Definindo o tamanho máximo do anexo como dois megabytes

O exemplo a seguir mostra a definição do tamanho máximo do anexo como 2 megabytes.

EXECUTE msdb.dbo.sysmail_configure_sp
    'MaxFileSize', '2097152' ;