Partilhar via


sysmail_configure_sp (Transact-SQL)

Aplica-se a: 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 esquema dbo . O procedimento deve ser executado com um nome de três partes se o banco de dados atual não msdbfor .

Permissões

Esse procedimento armazenado pertence à função db_owner . Você pode conceder EXECUTE permissões para qualquer usuário, mas essas permissões 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.

EXEC 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.

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