sysmail_help_principalprofile_sp (Transact-SQL)
Répertorie des informations sur les associations entre les profils de messagerie de la base de données et les principaux de la base de données.
.gif "Icône Lien de rubrique")
Syntaxe
sysmail_help_principalprofile_sp [ { [ @principal_id = ] principal_id | [ @principal_name = ] 'principal_name' } ]
[ [ , ] { [ @profile_id = ] profile_id | [ @profile_name = ] 'profile_name' } ]
Arguments
[ @principal_id= ] principal_id
Correspond à l'ID de l'utilisateur ou du rôle de base de données dans la base de données msdb pour l'association à répertorier. L'argument principal_id est de type int avec NULL comme valeur par défaut. principal_id ou principal_name peut être spécifié.[ @principal_name= ] 'principal_name'
Correspond au nom de l'utilisateur ou du rôle de base de données dans la base de données msdb pour l'association à répertorier. L'argument principal_name est de type sysname avec NULL comme valeur par défaut. principal_id ou principal_name peut être spécifié.[ @profile_id= ] profile_id
Identificateur du profil pour l'association à répertorier. L'argument profile_id est de type int, avec NULL comme valeur par défaut. profile_id ou profile_name peut être spécifié.[ @profile_name= ] 'profile_name'
Nom du profil pour l'association à répertorier. L'argument profile_name est de type sysname, avec NULL comme valeur par défaut. profile_id ou profile_name peut être spécifié.
Valeurs du code de retour
0 (succès) ou 1 (échec)
Ensemble de résultats
Retourne un jeu de résultats qui contient les colonnes répertoriées dans le tableau ci-dessous.
Nom de colonne |
Type de données |
Description |
principal_id |
int |
Identificateur de l'utilisateur de la base de données. |
principal_name |
sysname |
Nom de l'utilisateur de la base de données. |
profile_id |
int |
Numéro d'identification du profil de messagerie de la base de données. |
profile_name |
sysname |
Nom du profil de messagerie de la base de données. |
is_default |
bit |
Indicateur signalant s'il s'agit du profil par défaut de l'utilisateur. |
Notes
Si sysmail_help_principalprofile_sp est appelé sans paramètre, l'ensemble de résultats retourné indique toutes les associations de l'instance de SQL Server. Sinon, l'ensemble de résultats contient des informations pour les associations qui correspondent aux paramètres fournis. Par exemple, la procédure répertorie toutes les associations d'un profil lorsque le nom de ce dernier est fourni.
sysmail_help_principalprofile_sp se trouve dans la base de données msdb et appartient au schéma dbo. Elle doit être exécutée avec un nom en trois parties si la base de données active n'est pas msdb.
Autorisations
Nécessite l'appartenance au rôle de serveur fixe sysadmin.
Exemples
A. Affichage d'une liste d'informations pour une association spécifique
L'exemple suivant illustre l'affichage d'une liste d'informations sur toutes les associations entre le profil AdventureWorks2008R2 Administrator et le principal ApplicationLogin de la base de données msdb.
EXECUTE msdb.dbo.sysmail_help_principalprofile_sp
@principal_name = 'danw',
@profile_name = 'AdventureWorks2008R2 Administrator' ;
Exemple d'un ensemble de résultats remis en forme au niveau de la longueur de ligne.
principal_id principal_name profile_id profile_name is_default
------------ ------------------ ----------- ------------------------------ ----------
5 danw 9 AdventureWorks2008R2 Administrator 1
B. Affichage d'une liste d'informations pour toutes les associations
L'exemple suivant illustre l'affichage d'une liste d'informations sur toutes les associations de l'instance.
EXECUTE msdb.dbo.sysmail_help_principalprofile_sp ;
Exemple d'un ensemble de résultats remis en forme au niveau de la longueur de ligne.
principal_id principal_name profile_id profile_name is_default
------------ ------------------ ----------- ------------------------------ ----------
6 terrid 3 Product Update Profile 1
5 danw 9 AdventureWorks2008R2 Administrator 1