sysmail_help_principalprofile_sp (Transact-SQL)
S'applique à : 
SQL Server
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.
Conventions de la syntaxe Transact-SQL
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
ID de l’utilisateur ou du rôle de base de données dans la msdb base de données pour l’association à répertorier. @principal_id est int, avec la valeur par défaut NULL. 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 l’association à répertorier. @principal_name est sysname, avec la valeur par défaut NULL. Vous devez spécifier @principal_id ou @principal_name .
[ @profile_id = ] profile_id
ID du profil de l’association à répertorier. @profile_id est int, avec la valeur par défaut NULL. Vous pouvez spécifier @profile_id ou @profile_name .
[ @profile_name = ] 'profile_name'
Nom du profil de l’association à répertorier. @profile_name est sysname, avec la valeur par défaut NULL. Vous pouvez spécifier @profile_id ou @profile_name .
Valeurs des codes de retour
0 (réussite) ou 1 (échec).
Jeu de résultats
Retourne un jeu de résultats qui contient les colonnes répertoriées dans le tableau ci-dessous.
| Nom de la 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 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
S’il sysmail_help_principalprofile_sp est appelé sans paramètres, le jeu de résultats retourné répertorie 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 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
R. Répertorier les informations d’une association spécifique
L'exemple suivant illustre l'affichage d'une liste d'informations sur toutes les associations entre le profil AdventureWorks Administrator et le principal ApplicationLogin de la base de données msdb.
EXEC msdb.dbo.sysmail_help_principalprofile_sp
@principal_name = 'danw',
@profile_name = 'AdventureWorks 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 AdventureWorks Administrator 1
B. Informations de liste pour toutes les associations
L'exemple suivant illustre l'affichage d'une liste d'informations sur toutes les associations de l'instance.
EXEC 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 AdventureWorks Administrator 1