Partager via


sysmail_update_profileaccount_sp (Transact-SQL)

S'applique à : SQL Server

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

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 int, avec la valeur par défaut NULL. Les @profile_id ou les @profile_name doivent être spécifiés.

[ @profile_name = ] 'profile_name'

Nom du profil à mettre à jour. @profile_name est sysname, avec la valeur par défaut NULL. Les @profile_id ou les @profile_name doivent être spécifiés.

[ @account_id = ] account_id

ID du compte à mettre à jour. @account_id est int, avec la valeur par défaut NULL. La @account_id ou la @account_name doit être spécifiée.

[ @account_name = ] 'account_name'

Nom du compte à mettre à jour. @account_name est sysname, avec la valeur par défaut NULL. La @account_id ou la @account_name doit être spécifiée.

[ @sequence_number = ] sequence_number

Nouveau numéro de séquence du compte. @sequence_number est 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.

Valeurs des codes de retour

0 (réussite) ou 1 (échec).

Jeu de résultats

Aucune.

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 d'utilisation des comptes de messagerie de base de données dans le profil. Pour un nouveau message électronique, la messagerie de base de données commence par le compte qui est le numéro de séquence le plus bas. Si ce compte échoue, La messagerie de base de données utilise le compte avec le numéro de séquence le plus élevé suivant, et ainsi de suite, jusqu’à ce que la messagerie de base de données envoie le message correctement, 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 possèdent le même numéro de séquence, la messagerie de base de données utilise uniquement l'un d'eux 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 sysmail_update_profileaccount_sp stockée se trouve dans la msdb base de données et appartient au 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

Cette procédure stockée appartient au rôle db_owner . Vous pouvez accorder EXECUTE des autorisations pour n’importe quel utilisateur, mais ces autorisations peuvent être remplacées lors d’une mise à niveau de SQL Server.

Exemples

L’exemple suivant modifie le numéro de séquence du compte Admin-BackupServer dans le profil AdventureWorks Administrator dans la msdb base de données. 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.

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