sysmail_add_profileaccount_sp (Transact-SQL)

Artículo
06/18/2013

Agrega una cuenta del Correo electrónico de base de datos al perfil del Correo electrónico de base de datos. Ejecute sysmail_add_profileaccount_sp una vez se hayan creado la cuenta de base de datos con sysmail_add_account_sp (Transact-SQL) y el perfil de base de datos con sysmail_add_profile_sp (Transact-SQL).

Icono de vínculo a temas Convenciones de sintaxis de Transact-SQL

Sintaxis

sysmail_add_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
Identificador de perfil que se agrega a la cuenta. profile_id es de tipo int y su valor predeterminado es NULL. Debe especificarse profile_id o profile_name.
[ @profile_name = ] 'profile_name'
Nombre de perfil que se agrega a la cuenta. 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 cuenta que se agrega al perfil. 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 agregar al perfil. account_name es de tipo sysname y su valor predeterminado es NULL. Debe especificarse account_id o account_name.
[ @sequence_number = ] sequence_number
Número de secuencia de la cuenta en el perfil. 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)

Comentarios

El perfil y la cuenta ya deben existir. En caso contrario, el procedimiento almacenado devuelve un error.

Tenga en cuenta que este procedimiento almacenado no cambia el número de secuencia de una cuenta asociada al perfil especificado. Para obtener más información sobre la actualización del número de secuencia de una cuenta, vea sysmail_update_profileaccount_sp (Transact-SQL).

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 Correo electrónico de base de datos pausa los intentos de envío del correo electrónico durante el tiempo configurado en el parámetro AccountRetryDelay de sysmail_configure_sp y, a continuación, inicia el proceso de nuevo intento de envío del correo electrónico comenzando por el número de secuencia más bajo. Utilice el parámetro AccountRetryAttempts de sysmail_configure_sp para configurar el 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.

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_add_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 asocia el perfil AdventureWorks Administrator a la cuenta Audit Account. La cuenta de auditoría tiene el número de secuencia 1.

EXECUTE msdb.dbo.sysmail_add_profileaccount_sp
    @profile_name = 'AdventureWorks Administrator',
    @account_name = 'Audit Account',
    @sequence_number = 1 ;