Share via


sysmail_help_principalprofile_sp (Transact-SQL)

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

Referencia

Procedimientos almacenados de Correo electrónico de base de datos y SQL Mail (Transact-SQL)

Otros recursos

Correo electrónico de base de datos
Seleccionar tarea de configuración (Correo electrónico de base de datos)

Ayuda e información

Obtener ayuda sobre SQL Server 2005

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.