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.
S'applique à : SQL Server (SQL Server 2008 via la version actuelle). |
.gif "Icône Lien de rubrique")
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
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. 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. 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. 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. 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)
Jeux 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 AdventureWorks Administrator et le principal ApplicationLogin de la base de données msdb.
EXECUTE 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.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 AdventureWorks Administrator 1
Voir aussi
Référence
Procédures stockées de messagerie de base de données (Transact-SQL)