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