sysmail_configure_sp (Transact-SQL)

Artigo
06/18/2013

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ó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. 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' ;

Consulte também

Referência

sysmail_help_configure_sp (Transact-SQL)

Procedimentos armazenados do Database Mail (Transact-SQL)

Conceitos

Database Mail

Compartilhar via