sysmail_delete_principalprofile_sp (Transact-SQL)

  • Article

S'applique à : SQL Server

Supprime l'autorisation d'utilisation d'un profil de messagerie de base de données public ou privé pour un utilisateur de base de données ou un rôle de base de données.

Conventions de la syntaxe Transact-SQL

Syntaxe

sysmail_delete_principalprofile_sp { [ @principal_id = ] principal_id | [ @principal_name = ] 'principal_name' } ,
    { [ @profile_id = ] profile_id | [ @profile_name = ] 'profile_name' }
[ ; ]

Arguments

[ @principal_id = ] principal_id

ID de l’utilisateur ou du rôle de base de données dans la msdb base de données pour que l’association soit supprimée. @principal_id est int, avec la valeur par défaut NULL. Pour transformer un profil public en profil privé, fournissez l’ID 0 du principal ou le nom publicdu principal. Vous devez spécifier @principal_id ou @principal_name .

[ @principal_name = ] 'principal_name'

Nom de l’utilisateur ou du rôle de base de données dans la msdb base de données pour que l’association soit supprimée. @principal_name est sysname, avec la valeur par défaut NULL. Pour transformer un profil public en profil privé, fournissez l’ID 0 du principal ou le nom publicdu principal. Vous devez spécifier @principal_id ou @principal_name .

[ @profile_id = ] profile_id

ID du profil à supprimer pour l’association. @profile_id est int, avec la valeur par défaut NULL. Vous devez spécifier @profile_id ou @profile_name .

[ @profile_name = ] 'profile_name'

Nom du profil pour l’association à supprimer. @profile_name est sysname, avec la valeur par défaut NULL. Vous devez spécifier @profile_id ou @profile_name .

Valeurs des codes de retour

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

Notes

Pour transformer un profil public en profil privé, indiquez « public » pour le nom du principal ou 0 pour l’ID de principal.

Soyez prudent lorsque vous supprimez des autorisations pour le profil privé par défaut d'un utilisateur ou pour le profil public par défaut. Lorsqu’aucun profil par défaut n’est disponible, sp_send_dbmail nécessite le nom d’un profil en tant qu’argument. Par conséquent, la suppression d’un profil par défaut entraîne l’échec des appels sp_send_dbmail . Pour plus d’informations, consultez sp_send_dbmail.

La procédure sysmail_delete_principalprofile_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 montre la suppression de l’association entre le profil AdventureWorks Administrator et la connexion ApplicationUser dans la msdb base de données.

EXEC msdb.dbo.sysmail_delete_principalprofile_sp
    @principal_name = 'ApplicationUser',
    @profile_name = 'AdventureWorks Administrator';

Contenu connexe