sysmail_update_profileaccount_sp (Transact-SQL)
Actualiza el número de secuencia de una cuenta en un perfil del Correo electrónico de base de datos.
.gif "Icono de vínculo a temas")
Convenciones de sintaxis de Transact-SQL
Sintaxis
sysmail_update_profileaccount_sp { [ @profile_id = ] profile_id
| [ @profile_name = ] 'profile_name' } ,
{ [ @account_id = ] account_id | [ @account_name = ] 'account_name' } ,
[ @sequence_number = ] sequence_number
Argumentos
- [ @profile_id = ] profile_id
El Id. del perfil que se va a actualizar. profile_id es de tipo int y su valor predeterminado es NULL. Debe especificarse profile_id o profile_name.
- [ @profile_name = ] 'profile_name'
El nombre del perfil que se va a actualizar. profile_name es de tipo sysname y su valor predeterminado es NULL. Debe especificarse profile_id o profile_name.
- [ @account_id = ] account_id
El Id. de la cuenta que se va a actualizar. account_id es de tipo int y su valor predeterminado es NULL. Debe especificarse account_id o account_name.
- [ @account_name = ] 'account_name'
El nombre de la cuenta que se va a actualizar. account_name es de tipo sysname y su valor predeterminado es NULL. Debe especificarse account_id o account_name.
- [ @sequence_number = ] sequence_number
El nuevo número de secuencia de la cuenta. sequence_number es de tipo int y no tiene ningún valor predeterminado. El número de secuencia determina el orden en que las cuentas se utilizan en el perfil.
Conjuntos de resultados
Ninguno
Notas
Devuelve un error si la cuenta especificada no está asociada al perfil especificado.
El número de secuencia determina el orden en que el Correo electrónico de base de datos utiliza las cuentas en el perfil. En el caso de un mensaje de correo electrónico nuevo, el Correo electrónico de base de datos se inicia con la cuenta con el número de secuencia más bajo. Si la cuenta genera un error, el Correo electrónico de base de datos utiliza la cuenta con el siguiente número de secuencia superior y así sucesivamente hasta que el Correo electrónico de base de datos envía el mensaje correctamente o la cuenta con el número de secuencia superior genera un error. Si la cuenta con el número de secuencia superior genera un error, el mensaje de correo electrónico también genera un error.
Si hay más de una cuenta con el mismo número de secuencia, el Correo electrónico de base de datos sólo utiliza una de estas cuentas para un mensaje de correo electrónico determinado. En este caso, el Correo electrónico de base de datos no confirma qué cuenta se va a utilizar para el número de secuencia o que se vaya a utilizar la misma cuenta de un mensaje a otro.
El procedimiento almacenado sysmail_update_profileaccount_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.
Valores de código de retorno
0 (correcto) o 1 (error)
Ejemplos
En el siguiente ejemplo se cambia el número de secuencia de la cuenta Admin-BackupServer en el perfil AdventureWorks Administrator de la base de datos msdb. Tras ejecutar este código, el número de secuencia para la cuenta es 3, lo que indica que se va a probar si las dos primeras cuentas generan un error.
EXECUTE msdb.dbo.sysmail_update_profileaccount_sp
@profile_name = 'AdventureWorks Administrator',
@account_name = 'Admin-BackupServer',
@sequence_number = 3 ;
Vea también
Referencia
Procedimientos almacenados de Correo electrónico de base de datos y SQL Mail (Transact-SQL)
Otros recursos
Correo electrónico de base de datos
Cuentas del Correo electrónico de base de datos
Perfiles del Correo electrónico de base de datos
Seleccionar tarea de configuración (Correo electrónico de base de datos)