sysmail_help_principalprofile_sp (Transact-SQL)
Si applica a: SQL Server
Restituisce un elenco di informazioni sulle associazioni tra i profili di Posta elettronica database e le entità di database.
Convenzioni relative alla 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 o del msdb
ruolo del database nel database per l'associazione da elencare. @principal_id è int, con il valore predefinito .NULL
È necessario specificare @principal_id o @principal_name .
[ @principal_name = ] 'principal_name'
Nome dell'utente o del msdb
ruolo del database nel database per l'associazione da elencare. @principal_name è sysname, con il valore predefinito NULL
. È necessario specificare @principal_id o @principal_name .
[ @profile_id = ] profile_id
ID del profilo da elencare per l'associazione. @profile_id è int, con il valore predefinito NULL
. È possibile specificare @profile_id o @profile_name .
[ @profile_name = ] 'profile_name'
Nome del profilo da elencare per l'associazione. @profile_name è sysname, con il valore predefinito NULL
. È possibile specificare @profile_id o @profile_name .
Valori del codice restituito
0
(esito positivo) o 1
(errore).
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 richiamato senza parametri, il set di risultati restituito elenca tutte le associazioni nell'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
è nel msdb
database ed è di proprietà dello schema dbo . La procedura deve essere eseguita con un nome in tre parti se il database corrente non msdb
è .
Autorizzazioni
Questa stored procedure è di proprietà del ruolo db_owner . È possibile concedere EXECUTE
autorizzazioni per qualsiasi utente, ma queste autorizzazioni possono essere sottoposte a override durante un aggiornamento di SQL Server.
Esempi
R. Elencare le informazioni per 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
.
EXEC 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. Elencare le informazioni per tutte le associazioni
Nell'esempio seguente viene illustrato come visualizzare le informazioni relative a tutte le associazioni nell'istanza.
EXEC 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