Share via


sysmail_help_principalprofile_sp (Transact-SQL)

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.

Icono de vínculo a temasConvenciones 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
    Es el Id. de usuario o función de la base de datos msdb de la asociación que se va a mostrar. principal_id es de tipo int y tiene el valor predeterminado NULL.Puede especificarse principal_id o principal_name.

  • [ @principal_name= ] 'principal_name'
    Es el nombre de usuario o función de la base de datos msdb de la asociación que se va a mostrar. principal_name es de tipo sysname y tiene el valor predeterminado NULL.Puede especificarse principal_id o principal_name.

  • [ @profile_id= ] profile_id
    Es el Id. del perfil para la asociación que se va a enumerar. profile_id es de tipo int y su valor predeterminado es NULL. Puede especificarse profile_id o profile_name.

  • [ @profile_name= ] 'profile_name'
    Es el nombre del perfil para la asociación que se va a enumerar. profile_name es de tipo sysname y su valor predeterminado es NULL. Puede especificarse profile_id o profile_name.

Valores de código de retorno

0 (correcto) o 1 (error)

Conjuntos de resultados

Devuelve un conjunto de resultados que contiene las columnas que se indican en la siguiente tabla.

Nombre de 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

Indicador que indica si el perfil es el perfil predeterminado del usuario.

Notas

Si se llama a sysmail_help_principalprofile_sp sin parámetros, en el conjunto de resultados devuelto se muestran todas las asociaciones en 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 se encuentra en la base de datos msdb y pertenece al esquema dbo. El procedimiento se debe ejecutar con un nombre de tres partes si la base de datos actual no es msdb.

Permisos

Requiere la pertenencia a la función fija de servidor sysadmin.

Ejemplos

A. Mostrar información para 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.

EXECUTE 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. Mostrar información para todas las asociaciones

En el ejemplo siguiente se indica cómo mostrar la información de todas las asociaciones en la instancia.

EXECUTE 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