sysmail_help_principalprofile_sp (Transact-SQL)

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

Icona di collegamento a un argomentoConvenzioni 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 o del ruolo nel database msdb per l'associazione all'elenco. 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 o del ruolo nel database msdb per l'associazione all'elenco. 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.

Valori restituiti

0 (esito positivo) o 1 (esito negativo)

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.

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