• Artículo

sysmail_configure_sp (Transact-SQL)

Cambia los valores de configuración del Correo electrónico de base de datos. Los valores de configuración especificados con sysmail_configure_sp se aplican a toda la instancia de SQL Server.

Icono de vínculo a temasConvenciones de sintaxis de Transact-SQL

Sintaxis

sysmail_configure_sp [ [ @parameter_name = ] 'parameter_name' ]
    [ , [ @parameter_value = ] 'parameter_value' ]
    [ , [ @description = ] 'description' ]

Argumentos

  • [@parameter_name = ] 'parameter_name'
    Nombre del parámetro que se va a cambiar.

  • [@parameter_value = ] 'parameter_value'
    Valor nuevo del parámetro.

  • [@description = ] 'description'
    Descripción del parámetro.

Valores de código de retorno

0 (correcto) o 1 (error)

Conjuntos de resultados

Ninguno

Comentarios

El Correo electrónico de base de datos utiliza los siguientes parámetros:

Nombre del parámetro

Descripción

Valor predeterminado

AccountRetryAttempts

Número de veces que el proceso de correo electrónico externo intenta enviar el mensaje de correo electrónico con cada cuenta del perfil especificado.

1

AccountRetryDelay

Cantidad de tiempo en segundos que el proceso de correo electrónico externo espera entre cada intento de envío de un mensaje.

5000

DatabaseMailExeMinimumLifeTime

Cantidad de tiempo mínima en segundos que el proceso de correo electrónico externo permanece activo. Si el Correo electrónico de base de datos está enviando muchos mensajes, aumente este valor para mantener activo el Correo electrónico de base de datos y evitar una sobrecarga de inicios y detenciones frecuentes.

600

DefaultAttachmentEncoding

Codificación predeterminada para los datos adjuntos de correo electrónico.

MIME

MaxFileSize

Tamaño máximo de los datos adjuntos en bytes.

1000000

ProhibitedExtensions

Lista de extensiones separadas por comas que no se puede enviar como datos adjuntos en un mensaje de correo electrónico.

exe,dll,vbs,js

LoggingLevel

Sirve para especificar qué mensajes se deben registrar en el registro de Correo electrónico de base de datos. Los valores posibles son 1, 2 ó 3.

  • 1 - Éste es el modo normal. Sólo registra los errores.

  • 2 - Éste es el modo extendido. Registra errores, advertencias y mensajes informativos.

  • 3 - Éste es el modo detallado. Registra errores, advertencias, mensajes informativos, mensajes de acciones correctas y otros mensajes internos. Utilice este modo para solucionar problemas.

2

El procedimiento almacenado sysmail_configure_sp se encuentra en la base de datos msdb y pertenece al esquema dbo. El procedimiento se debe ejecutar con un nombre de tres partes si la base de datos actual no es msdb.

Permisos

Los permisos de ejecución para este procedimiento corresponden de forma predeterminada a los miembros de la función fija de servidor sysadmin.

Ejemplos

A. Configurar el Correo electrónico de base de datos para reintentar con cada cuenta 10 veces

En el siguiente ejemplo se muestra el valor del Correo electrónico de base de datos para reintentar con cada cuenta diez veces antes de determinar que no se puede obtener acceso a la cuenta.

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

B. Establecer el tamaño máximo de los datos adjuntos en dos megabytes

En el siguiente ejemplo se muestra cómo se establece el tamaño máximo de los datos adjuntos en 2 megabytes.

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