sysmail_help_principalprofile_sp (Transact-SQL)

Articolo
12/15/2008

Data aggiornamento: 12 dicembre 2006

Restituisce un elenco di informazioni sulle associazioni tra i profili di Posta elettronica database e le entità di database di msdb.

Icona di collegamento a un argomento Convenzioni della sintassi Transact-SQL

Sintassi

sysmail_help_principalprofile_sp [ {   [ @principal_id = ] principal_id | [ @principal_name = ] 'principal_name' } ]
    [ [ , ] {   [ @profile_id = ] profile_id | [ @profile_name = ] 'profile_name' } ]

Argomenti

[ @principal_id= ] principal_id
ID dell'utente del database msdb o 0 per il ruolo public. principal_id è di tipo int e il valore predefinito è NULL. È possibile specificare l'argomento principal_id o l'argomento principal_name.

[ @principal_name= ] 'principal_name'
Nome dell'utente del database msdb o 'public' per il ruolo public. principal_name è di tipo sysname e il valore predefinito è NULL. È possibile specificare l'argomento principal_id o l'argomento principal_name.

[ @profile_id= ] profile_id
ID del profilo per l'associazione da includere nell'elenco. profile_id è di tipo int e il valore predefinito è NULL. È possibile specificare l'argomento profile_id o l'argomento profile_name.

[ @profile_name= ] 'profile_name'
Nome del profilo per l'associazione da includere nell'elenco. profile_name è di tipo sysname e il valore predefinito è NULL. È possibile specificare l'argomento profile_id o l'argomento profile_name.

Set di risultati

Restituisce un set di risultati contenente le colonne elencate nella tabella seguente.

Nome colonna	Tipo di dati	Descrizione
principal_id	int	ID dell'utente del database.
principal_name	sysname	Nome dell'utente del database.
profile_id	int	Numero ID del profilo di Posta elettronica database.
profile_name	sysname	Nome del profilo di Posta elettronica database.
is_default	bit	Flag che indica se il profilo è il profilo predefinito per l'utente.

Osservazioni

Se sysmail_help_principalprofile_sp viene richiamata senza parametri, nel set di risultati restituito verranno elencate tutte le associazioni dell'istanza di SQL Server. Negli altri casi il set di risultati conterrà le informazioni relative alle associazioni che corrispondono ai parametri specificati. Se ad esempio si specifica il nome di un profilo, la procedura elenca tutte le associazioni per tale profilo.

sysmail_help_principalprofile_sp si trova nel database msdb ed è di proprietà dello schema dbo. La procedura deve essere eseguita con un nome in tre parti se il database corrente non è msdb.

Autorizzazioni

È richiesta l'appartenenza al ruolo predefinito del server sysadmin.

Valori restituiti

0 (esito positivo) o 1 (esito negativo)

Cronologia delle modifiche

Versione	Cronologia
12 dicembre 2006	Contenuto modificato: Indicazioni relative agli utenti del database msdb e al fatto che il ruolo è limitato al ruolo public.
14 aprile 2006	Contenuto modificato: Rimozione dei parametri inesistenti @database_id e @database_name.

Esempi

A. Visualizzazione delle informazioni relative a un'associazione specifica

Nell'esempio seguente viene illustrato come visualizzare le informazioni relative a tutte le associazioni tra il profilo AdventureWorks Administrator e l'entità ApplicationLogin nel database msdb.

EXECUTE msdb.dbo.sysmail_help_principalprofile_sp
    @principal_name = 'danw',
    @profile_name = 'AdventureWorks Administrator' ;

Set di risultati di esempio, riformattato in base alla lunghezza di riga:

principal_id principal_name     profile_id  profile_name                   is_default
------------ ------------------ ----------- ------------------------------ ----------
5            danw               9           AdventureWorks Administrator   1

B. Visualizzazione delle informazioni relative a tutte le associazioni

Nell'esempio seguente viene illustrato come visualizzare le informazioni relative a tutte le associazioni nell'istanza.

EXECUTE msdb.dbo.sysmail_help_principalprofile_sp ;

Set di risultati di esempio, riformattato in base alla lunghezza di riga:

principal_id principal_name     profile_id  profile_name                   is_default
------------ ------------------ ----------- ------------------------------ ----------
6            terrid             3           Product Update Profile         1
5            danw               9           AdventureWorks Administrator   1

Vedere anche

Condividi tramite