sysmail_help_principalprofile_sp (Transact-SQL)

Mis à jour : 12 décembre 2006

Répertorie des informations sur les associations entre les profils de messagerie de la base de données et les entités de sécurité de la base de données msdb.

Conventions de 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 de base de données dans la base de données msdb ou 0 pour le rôle public. 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 de base de données dans la base de données msdb ou 'public' pour pour le rôle public. 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é.

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.

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.

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 l'entité de sécurité 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 et SQL Mail (Transact-SQL)

Autres ressources

Messagerie de base de données
Sélectionner une tâche de configuration (messagerie de base de données)

Aide et Informations

Assistance sur SQL Server 2005

Historique des modifications