sysmail_update_profileaccount_sp (Transact-SQL)

Article
03/07/2014

Met à jour le numéro de séquence d'un compte dans le profil de messagerie de base de données.

S'applique à : SQL Server (SQL Server 2008 via la version actuelle).

Icône Lien de rubrique Conventions de la syntaxe Transact-SQL

Syntaxe

sysmail_update_profileaccount_sp  { [ @profile_id = ] profile_id 
| [ @profile_name = ] 'profile_name' } ,
    { [ @account_id = ] account_id | [ @account_name = ] 'account_name' } ,
    [ @sequence_number = ] sequence_number

Arguments

[ @profile_id = ] profile_id
Identificateur du profil à mettre à jour. profile_id est de type int, avec NULL comme valeur par défaut. L'argument profile_id ou profile_name doit être spécifié.
[ @profile_name = ] 'profile_name'
Nom du profil à mettre à jour. profile_name est de type sysname, avec NULL comme valeur par défaut. L'argument profile_id ou profile_name doit être spécifié.
[ @account_id = ] account_id
ID du compte à mettre à jour. account_id est de type int, avec NULL comme valeur par défaut. L'argument account_id ou account_name doit être spécifié.
[ @account_name = ] 'account_name'
Nom du compte à mettre à jour. account_name est de type sysname, avec NULL comme valeur par défaut. L'argument account_id ou account_name doit être spécifié.
[ @sequence_number = ] sequence_number
Nouveau numéro de séquence du compte. sequence_number est de type int et n'a pas de valeur par défaut. Le numéro de séquence détermine l'ordre dans lequel les comptes sont utilisés dans le profil.

Valeurs des codes renvoyés

0 (succès) ou 1 (échec)

Jeux de résultats

Aucun

Notes

Retourne une erreur si le compte spécifié n'est pas associé au profil spécifié.

Le numéro de séquence détermine l'ordre dans lequel la messagerie de base de données utilise les comptes dans le profil. Pour un nouveau message électronique, la messagerie de base de données démarre avec le compte dont le numéro de séquence est le plus petit. En cas d'échec de ce compte, la messagerie de base de données utilise le compte dont le numéro de séquence est le plus proche mais supérieur, et ainsi de suite jusqu'à ce que le message soit envoyé ou que le compte avec le numéro de séquence le plus élevé échoue. En cas d'échec du compte avec le numéro de séquence le plus élevé, le message échoue.

Si plusieurs comptes ont le même numéro de séquence, la messagerie de base de données utilise uniquement l'un de ces comptes pour un message électronique donné. Dans ce cas, la messagerie de base de données exclut toute garantie en ce qui concerne le compte utilisé pour ce numéro de séquence ou l'utilisation du même compte d'un message à un autre.

La procédure stockée sysmail_update_profileaccount_sp se trouve dans la base de données msdb et est détenue par le schéma dbo. La procédure doit être exécutée avec un nom en trois parties si la base de données actuelle n'est pas msdb.

Autorisations

Les autorisations d'exécution pour cette procédure reviennent par défaut aux membres du rôle de serveur fixe sysadmin.

Exemple

L'exemple suivant modifie le numéro de séquence du compte Admin-BackupServer dans le profil AdventureWorks Administrator de la base de données msdb. Une fois ce code exécuté, le numéro de séquence du compte est 3. Cela indique qu'il sera utilisé si les deux premiers comptes échouent.

EXECUTE msdb.dbo.sysmail_update_profileaccount_sp
    @profile_name = 'AdventureWorks Administrator'
    ,@account_name = 'Admin-BackupServer',
    ,@sequence_number = 3;