sysmail_help_profile_sp (Transact-SQL)

  • Artículo

Se aplica a:SQL Server

Muestra información acerca de uno o más perfiles de correo.

Convenciones de sintaxis de Transact-SQL

Sintaxis

sysmail_help_profile_sp [ [ @profile_id = ] profile_id | [ @profile_name = ] 'profile_name' ]
[ ; ]

Argumentos

[ @profile_id = ] profile_id

Identificador de perfil para el que se va a devolver información. @profile_id es int, con un valor predeterminado de NULL.

[ @profile_name = ] 'profile_name'

Nombre del perfil para el que se devuelve información. @profile_name es sysname, con un valor predeterminado de NULL.

Valores de código de retorno

0 (correcto) o 1 (erróneo).

Conjunto de resultados

Devuelve un conjunto de resultados con las columnas siguientes:

Nombre de la columna Tipo de datos Descripción
profile_id int Identificador de perfil del perfil.
name sysname Nombre del perfil.
description nvarchar(256) Descripción del perfil.

Comentarios

Cuando se especifica un nombre de perfil o un identificador de perfil, sysmail_help_profile_sp devuelve información sobre ese perfil. De lo contrario, sysmail_help_profile_sp devuelve información sobre cada perfil de la instancia de SQL Server.

El procedimiento sysmail_help_profile_sp almacenado 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 Enumerar todos los perfiles

En el ejemplo siguiente se muestra una lista de todos los perfiles de una instancia.

EXEC msdb.dbo.sysmail_help_profile_sp;

El siguiente es un conjunto de resultados de ejemplo con la longitud de línea ajustada:

profile_id  name                          description
----------- ----------------------------- ------------------------------
56          AdventureWorks Administrator  Administrative mail profile.
57          AdventureWorks Operator       Operator mail profile.

B. Enumerar un perfil específico

En el ejemplo siguiente se muestra una lista de información del perfil AdventureWorks Administrator.

EXEC msdb.dbo.sysmail_help_profile_sp
    @profile_name = 'AdventureWorks Administrator' ;

El siguiente es un conjunto de resultados de ejemplo con la longitud de línea ajustada:

profile_id  name                          description
----------- ----------------------------- ------------------------------
56          AdventureWorks Administrator  Administrative mail profile.

Contenido relacionado