Partager via


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