sysmail_configure_sp (Transact-SQL)

Aplica-se a: SQL Server

Altera as definições de configuração do Correio de Base de Dados. As definições de configuração especificadas sysmail_configure_sp aplicam-se a toda a instância do SQL Server.

Transact-SQL convenções de sintaxe

Syntax

dbo.sysmail_configure_sp
    [ @parameter_name = ] N'parameter_name'
    , [ @parameter_value = ] N'parameter_value'
    [ , [ @description = ] N'description' ]
[ ; ]

Arguments

[ @parameter_name = ] N'parameter_name'

O nome do parâmetro a mudar.

[ @parameter_value = ] N'parameter_value'

O novo valor do parâmetro.

[ @description = ] N'descrição'

Uma descrição do parâmetro.

Valores de código de retorno

0 (sucesso) ou 1 (fracasso).

Conjunto de resultados

Nenhum.

Observações

Correio de Base de Dados utiliza os seguintes parâmetros:

Nome do parâmetro Description Valor predefinido
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 tempo, em segundos, para o processo de correio externo esperar entre tentativas de enviar uma mensagem. 5000
DatabaseMailExeMinimumLifeTime O tempo mínimo, em segundos, que o processo de e-mail externo permanece ativo. Quando o Correio de Base de Dados está a enviar muitas mensagens, aumente esse valor para manter o Correio de Base de Dados ativo e evitar o sobrecusto de arranques e paragens frequentes. 600
DefaultAttachmentEncoding A codificação padrão para anexos de e-mail. MIME
MaxFileSize O tamanho máximo de um anexo, em bytes. 1000000
ProhibitedExtensions Uma lista separada por vírgulas de extensões que não podem ser enviadas como anexo a uma mensagem de email. exe,dll,vbs,js
LoggingLevel Especifique quais mensagens são registradas no log do Correio de Base de Dados. Um dos seguintes valores numéricos:

1 - Este é o modo normal. Registos apenas erros.

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

3 - Este é o modo verboso. Regista erros, avisos, mensagens informativas, mensagens de sucesso e mensagens internas adicionais. Usa este modo para resolução de problemas.
2

O procedimento sysmail_configure_sp armazenado está na msdb base 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 .

Permissions

Requer CONTROL SERVER permissão no servidor ou pertença ao papel db_owner base de dados na base de msdb dados.

Também pode conceder EXECUTE permissões a qualquer utilizador, o que permite ao utilizador usar este procedimento para ler a configuração, mas sem alterar quaisquer parâmetros. Estas permissões adicionais podem ser anuladas durante uma atualização do SQL Server.

Examples

A. Defina o Correio de Base de Dados para tentar novamente cada conta 10 vezes

O exemplo seguinte mostra como configurar o Correio de Base de Dados para tentar repetir cada conta 10 vezes antes de considerar a conta como inacessível.

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

B. Defina o tamanho máximo do anexo para 2 megabytes

O exemplo seguinte mostra definir o tamanho máximo do anexo para 2 megabytes.

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