Share via

  • Статья

sysmail_help_profile_sp (Transact-SQL)

Отображает сведения об одном или нескольких почтовых профилях.

Значок ссылки на разделСинтаксические обозначения в Transact-SQL

Синтаксис

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

Аргументы

  • [ @profile_id = ] profile_id
    Идентификатор профиля, для которого возвращаются сведения. Аргумент profile_id имеет тип int и значение по умолчанию NULL.

  • [ @profile_name = ] 'profile_name'
    Имя профиля, для которого возвращаются сведения. Аргумент profile_name имеет тип sysname и значение по умолчанию NULL.

Значения кодов возврата

0 (успешное завершение) или 1 (неуспешное завершение)

Результирующие наборы

Возвращает результирующий набор со следующими столбцами.

Имя столбца

Тип данных

Описание

profile_id

int

Идентификатор профиля.

name

sysname

Имя профиля.

description

nvarchar(256)

Описание профиля.

Замечания

Если заданы имя профиля или его идентификатор, процедура sysmail_help_profile_sp возвращает сведения об этом профиле. Иначе процедура sysmail_help_profile_sp возвращает сведения о каждом профиле в экземпляре SQL Server.

Хранимая процедура sysmail_help_profile_sp находится в базе данных msdb и ею владеет схема dbo. Если текущей базой данных является не msdb, процедуру следует выполнять с трехкомпонентным именем.

Разрешения

Разрешениями на выполнение этой процедуры по умолчанию обладают члены предопределенной роли сервера sysadmin.

Примеры

A. Список всех профилей

Этот пример отображает список всех профилей экземпляра.

EXECUTE msdb.dbo.sysmail_help_profile_sp;

Далее приведен образец результирующего набора, повторно форматированный под длину строки:

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

Б. Отображение заданного профиля

Этот пример отображает сведения для профиля AdventureWorks2008R2 Administrator.

EXECUTE msdb.dbo.sysmail_help_profile_sp
    @profile_name = 'AdventureWorks2008R2 Administrator' ;

Далее приведен образец результирующего набора, повторно форматированный под длину строки:

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