Поделиться через


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          AdventureWorks Administrator  Administrative mail profile.  
57          AdventureWorks Operator       Operator mail profile.        

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

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

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

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

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