sysmail_update_profileaccount_sp (Transact-SQL)
Met à jour le numéro de séquence d'un compte dans le profil de messagerie de base de données.
.gif "Icône Lien de rubrique")
Conventions de la syntaxe de 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 et la valeur par défaut est NULL. 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 et sa valeur par défaut est NULL. 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. L'argument 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, sans valeur par défaut. Le numéro de séquence détermine l'ordre dans lequel les comptes sont utilisés dans le profil.
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. Cette procédure doit être exécutée avec un nom en trois parties si la base de données active 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.
Valeurs des codes renvoyés
0 (succès) ou 1 (échec)
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 ;
Voir aussi
Référence
Procédures stockées de messagerie de base de données et SQL Mail (Transact-SQL)
Autres ressources
Messagerie de base de données
Comptes de messagerie de base de données
Profils de messagerie de base de données
Sélectionner une tâche de configuration (messagerie de base de données)