Partager via


sysmail_add_profile_sp (Transact-SQL)

S’applique à : SQL Server Azure SQL Managed Instance

Crée un profil de messagerie de base de données.

Conventions de la syntaxe Transact-SQL

Syntaxe

sysmail_add_profile_sp [ @profile_name = ] 'profile_name'
    [ , [ @description = ] N'description' ]
    [ , [ @profile_id = ] new_profile_id OUTPUT ]
[ ; ]

Arguments

[ @profile_name = ] 'profile_name'

Nom du nouveau profil. @profile_name est sysname, sans valeur par défaut.

Pour envoyer des messages électroniques à l’aide de travaux SQL Server Agent dans Azure SQL Managed Instance, SQL Server Agent ne peut utiliser qu’un seul profil de messagerie de base de données et doit être appelé AzureManagedInstance_dbmail_profile. Pour plus d’informations et un exemple de script, consultez les notifications de travaux d’Azure SQL Managed Instance SQL Agent.

[ @description = ] N’description'

Description facultative du nouveau profil. @description est nvarchar(256), sans valeur par défaut.

[ @profile_id = ] sortie de new_profile_id

Retourne l'ID du nouveau profil. @profile_id est int, avec la valeur par défaut NULL.

Valeurs des codes de retour

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

Notes

Un profil de messagerie de base de données contient un nombre quelconque de comptes de messagerie de base de données. Les procédures stockées de messagerie de base de données peuvent faire référence à un profil par le nom du profil ou l’ID de profil généré par cette procédure. Pour plus d’informations sur l’ajout d’un compte à un profil, consultez sysmail_add_profileaccount_sp (Transact-SQL).

Le nom et la description du profil peuvent être modifiés avec la procédure sysmail_update_profile_spstockée, tandis que l’ID de profil reste constant pour la durée de vie du profil.

Le nom du profil doit être unique dans l’instance sql Server Moteur de base de données ou la procédure stockée retourne une erreur.

La procédure sysmail_add_profile_sp stockée se trouve dans la msdb base de données et appartient au dbo schéma. 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

R. Créer un nouveau profil

L'exemple ci-dessous crée un profil de messagerie de base de données nommé AdventureWorks Administrator.

EXEC msdb.dbo.sysmail_add_profile_sp
       @profile_name = 'AdventureWorks Administrator',
       @description = 'Profile used for administrative mail.';

B. Créer un profil, en enregistrant l’ID de profil dans une variable

L'exemple ci-dessous crée un profil de messagerie de base de données nommé AdventureWorks Administrator. L’exemple stocke le numéro d’ID de profil dans la variable @profileId et retourne un jeu de résultats contenant le numéro d’ID de profil pour le nouveau profil.

DECLARE @profileId INT;

EXECUTE msdb.dbo.sysmail_add_profile_sp
       @profile_name = 'AdventureWorks Administrator',
       @description = 'Profile used for administrative mail.',
       @profile_id = @profileId OUTPUT;

SELECT @profileId;