sysmail_update_profileaccount_sp (Transact-SQL)

Artículo
06/18/2013

Actualiza el número de secuencia de una cuenta en un perfil del Correo electrónico de base de datos.

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 identificador 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'
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
Identificador 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'
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
Nuevo número de secuencia de la cuenta. sequence_number es de tipo int y no tiene 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 (error)

Conjuntos 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. 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 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 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 del rol fijo de servidor sysadmin.

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;