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.
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