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.

Conventions de la 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. 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.

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)

Concepts

Messagerie de base de données