sysmail_configure_sp (Transact-SQL)

Cambia los valores de configuración de 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.

Convenciones 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. Solo 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 del rol fijo 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' ;

Vea también

Referencia

sysmail_help_configure_sp (Transact-SQL)

Procedimientos almacenados de Correo electrónico de base de datos (Transact-SQL)

Conceptos

Correo electrónico de base de datos