sysmail_help_principalprofile_sp (Transact-SQL)
Se aplica a: 
SQL Server
Muestra información acerca de las asociaciones entre los perfiles del Correo electrónico de base de datos y las entidades de seguridad de la base de datos.
Convenciones de sintaxis de Transact-SQL
Sintaxis
sysmail_help_principalprofile_sp [ { [ @principal_id = ] principal_id | [ @principal_name = ] 'principal_name' } ]
[ [ , ] { [ @profile_id = ] profile_id | [ @profile_name = ] 'profile_name' } ]
[ ; ]
Argumentos
[ @principal_id = ] principal_id
Identificador del usuario o rol de la base de datos en la msdb base de datos de la asociación a la que se va a enumerar. @principal_id es int, con un valor predeterminado de NULL. Se deben especificar @principal_id o @principal_name .
[ @principal_name = ] 'principal_name'
Nombre del usuario o rol de la base de datos en la msdb base de datos de la asociación a la que se va a enumerar. @principal_name es sysname, con un valor predeterminado de NULL. Se deben especificar @principal_id o @principal_name .
[ @profile_id = ] profile_id
Identificador del perfil de la asociación que se va a enumerar. @profile_id es int, con un valor predeterminado de NULL. Se pueden especificar @profile_id o @profile_name .
[ @profile_name = ] 'profile_name'
Nombre del perfil de la asociación que se va a enumerar. @profile_name es sysname, con un valor predeterminado de NULL. Se pueden especificar @profile_id o @profile_name .
Valores de código de retorno
0 (correcto) o 1 (erróneo).
Conjunto de resultados
Devuelve un conjunto de resultados que contiene las columnas que se indican en la siguiente tabla.
| Nombre de la columna | Tipo de datos | Descripción |
|---|---|---|
principal_id |
int | Id. del usuario de la base de datos. |
principal_name |
sysname | Nombre del usuario de la base de datos. |
profile_id |
int | Número de Id. del perfil de Correo electrónico de base de datos. |
profile_name |
sysname | Nombre del perfil de Correo electrónico de base de datos. |
is_default |
bit | Marca que indica si el perfil es el perfil predeterminado del usuario. |
Comentarios
Si sysmail_help_principalprofile_sp se invoca sin parámetros, el conjunto de resultados devuelto enumera todas las asociaciones de la instancia de SQL Server. En caso contrario, el conjunto de resultados contiene información para las asociaciones que coincidan con los parámetros suministrados. Por ejemplo, en el procedimiento se muestran todas las asociaciones para un perfil cuando se proporciona el nombre del perfil.
sysmail_help_principalprofile_sp está en la msdb base de datos y es propiedad del esquema dbo . El procedimiento debe ejecutarse con un nombre de tres partes si la base de datos actual no msdbes .
Permisos
Este procedimiento almacenado es propiedad del rol db_owner . Puede conceder EXECUTE permisos para cualquier usuario, pero estos permisos se pueden invalidar durante una actualización de SQL Server.
Ejemplos
A Enumeración de la información de una asociación específica
En el ejemplo siguiente se indica cómo mostrar información para todas las asociaciones entre el perfil AdventureWorks Administrator y la entidad de seguridad ApplicationLogin en la base de datos msdb.
EXEC msdb.dbo.sysmail_help_principalprofile_sp
@principal_name = 'danw',
@profile_name = 'AdventureWorks Administrator';
A continuación se muestra un conjunto de resultados de ejemplo con el formato cambiado para la longitud de línea.
principal_id principal_name profile_id profile_name is_default
------------ ------------------ ----------- ------------------------------ ----------
5 danw 9 AdventureWorks Administrator 1
B. Enumerar la información de todas las asociaciones
En el ejemplo siguiente se indica cómo mostrar la información de todas las asociaciones en la instancia.
EXEC msdb.dbo.sysmail_help_principalprofile_sp;
A continuación se muestra un conjunto de resultados de ejemplo con el formato cambiado para la longitud de línea.
principal_id principal_name profile_id profile_name is_default
------------ ------------------ ----------- ------------------------------ ----------
6 terrid 3 Product Update Profile 1
5 danw 9 AdventureWorks Administrator 1