sysmail_help_principalprofile_sp (Transact-SQL)

Artículo
12/15/2008

Actualizado: 12 de diciembre de 2006

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

Icono de vínculo a temas 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
Es el identificador del usuario de la base de datos msdb o 0 para la función public. 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 del usuario de la base de datos msdb o 'public' para la función public. 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.

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.

Valores de código de retorno

0 (correcto) o 1 (error)

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

Vea también

Historial de cambios

Versión	Historial
12 de diciembre de 2006	Contenido modificado: Se ha aclarado que los usuarios son usuarios de msdb y que la función se limita a public.
14 de abril de 2006	Contenido modificado: Se eliminaron los parámetros no existentes @database_id y @database_name.

Compartir a través de