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.
.gif "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 o el rol de la base de datos msdb de la asociación que se va a mostrar. principal_id es de tipo int y su valor predeterminado es NULL. Puede especificarse principal_id o principal_name.[ @principal_name= ] 'principal_name'
Es el nombre del usuario o el rol de la base de datos msdb de la asociación que se va a mostrar. principal_name es de tipo sysname y su valor predeterminado es NULL. Puede especificarse principal_id o principal_name.[ @profile_id= ] profile_id
Es el identificador del perfil para la asociación que se va a mostrar. 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 mostrar. 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 |
Marca que indica si el perfil es el perfil predeterminado del usuario. |
Comentarios
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 al rol fijo 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
Vea también
Referencia
Procedimientos almacenados de Correo electrónico de base de datos (Transact-SQL)