sysmail_update_profileaccount_sp (Transact-SQL)
Se aplica a: SQL Server
Actualiza el número de secuencia de una cuenta de un perfil del Correo electrónico de base de datos.
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 identificador del perfil que se va a actualizar. @profile_id es int, con un valor predeterminado de NULL
. Debe especificarse el @profile_id o el @profile_name .
[ @profile_name = ] 'profile_name'
Nombre del perfil que se va a actualizar. @profile_name es sysname, con un valor predeterminado de NULL
. Debe especificarse el @profile_id o el @profile_name .
[ @account_id = ] account_id
Identificador de la cuenta que se va a actualizar. @account_id es int, con un valor predeterminado de NULL
. Debe especificarse el @account_id o el @account_name .
[ @account_name = ] 'account_name'
Nombre de la cuenta que se va a actualizar. @account_name es sysname, con un valor predeterminado de NULL
. Debe especificarse el @account_id o el @account_name .
[ @sequence_number = ] sequence_number
Nuevo número de secuencia de la cuenta. @sequence_number es int, sin valor predeterminado. El número de secuencia determina el orden en que las cuentas se utilizan en el perfil.
Valores de código de retorno
0
(correcto) o 1
(erróneo).
Conjunto de resultados
Ninguno.
Comentarios
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. Para un nuevo mensaje de correo electrónico, Correo electrónico de base de datos comienza con la cuenta que es 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 solo 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 usar para el número de secuencia o que se vaya a usar la misma cuenta de un mensaje a otro.
El procedimiento sysmail_update_profileaccount_sp
almacenado está en la msdb
base de datos y es propiedad del esquema dbo . El procedimiento debe ejecutarse con un nombre de tres partes si la base de datos actual no msdb
es .
Permisos
Este procedimiento almacenado es propiedad del rol db_owner . Puede conceder EXECUTE
permisos para cualquier usuario, pero estos permisos se pueden invalidar durante una actualización de SQL Server.
Ejemplos
En el ejemplo siguiente se cambia el número de secuencia de la cuenta Admin-BackupServer
dentro del perfil AdventureWorks Administrator
de la msdb
base de datos. 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.
EXEC msdb.dbo.sysmail_update_profileaccount_sp
@profile_name = 'AdventureWorks Administrator',
@account_name = 'Admin-BackupServer',
@sequence_number = 3;