sysmail_help_principalprofile_sp (Transact-SQL)

  • Artículo

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

Contenido relacionado