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.
.gif "Ícone de vínculo de tópico")
Convenções da 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 frequentes. |
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.
|
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' ;
Consulte também
Referência
sysmail_help_configure_sp (Transact-SQL)
Procedimentos armazenados do Database Mail (Transact-SQL)