sysmail_configure_sp (Transact-SQL)
Aplica-se: 
SQL Server
Altera definições de configuração do Database Mail. As definições de configuração especificadas se sysmail_configure_sp aplicam a toda a instância do SQL Server.
Convenções de sintaxe de 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 [ = ] 'descrição'
Uma descrição do parâmetro.
Valores do código de retorno
0 (sucesso) ou 1 (falha).
Conjunto 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. Um dos seguintes valores numéricos: 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 sysmail_configure_sp armazenado está no msdb banco de dados e pertence ao dbo esquema. O procedimento deve ser executado com um nome de três partes se o banco de dados atual não msdbfor .
Permissões
Requer CONTROL SERVER permissão no servidor ou associação na função de banco de dados db_owner no msdb banco de dados.
Você também pode conceder EXECUTE permissões para qualquer usuário, o que permite que o usuário use esse procedimento para ler a configuração, mas não para alterar nenhum parâmetro. Essas permissões adicionadas podem ser substituídas durante uma atualização do SQL Server.
Exemplos
R. Defina o Database Mail para repetir cada conta 10 vezes
O exemplo a seguir mostra a configuração do Database Mail para repetir cada conta 10 vezes antes de considerar a conta inacessível.
EXECUTE msdb.dbo.sysmail_configure_sp 'AccountRetryAttempts', '10';
B. Defina o tamanho máximo do anexo como 2 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';