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.

Icône Lien de rubriqueConventions de syntaxe de 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. 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