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


sysmail_help_principalprofile_sp (Transact-SQL)

Область применения: SQL Server

Выводит сведения об взаимосвязях между профилями компонента Database Mail и участниками базы данных.

Соглашения о синтаксисе Transact-SQL

Синтаксис

sysmail_help_principalprofile_sp [ { [ @principal_id = ] principal_id | [ @principal_name = ] 'principal_name' } ]
    [ [ , ] { [ @profile_id = ] profile_id | [ @profile_name = ] 'profile_name' } ]
[ ; ]

Аргументы

[ @principal_id = ] principal_id

Идентификатор пользователя или роли базы данных в msdb базе данных для сопоставления для списка. @principal_id имеет значение int с значением по умолчаниюNULL. Необходимо указать либо @principal_id, либо @principal_name.

[ @principal_name = ] 'principal_name'

Имя пользователя или роли базы данных в msdb базе данных для сопоставления для списка. @principal_name — sysname с значением по умолчаниюNULL. Необходимо указать либо @principal_id, либо @principal_name.

[ @profile_id = ] profile_id

Идентификатор профиля для сопоставления для списка. @profile_id имеет значение int с значением по умолчаниюNULL. Можно указать @profile_id или @profile_name.

[ @profile_name = ] 'profile_name'

Имя профиля для сопоставления для списка. @profile_name имеет имя sysname с значением по умолчаниюNULL. Можно указать @profile_id или @profile_name.

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

0 (успешно) или 1 (сбой).

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

Возвращает результирующий набор, содержащий столбцы, перечисленные в следующей таблице.

Имя столбца Тип данных Description
principal_id int Идентификатор пользователя базы данных.
principal_name sysname Имя пользователя базы данных.
profile_id int Идентификатор профиля компонента Database Mail.
profile_name sysname Имя профиля компонента Database Mail.
is_default bit Флаг, который указывает, является ли профиль профилем по умолчанию для пользователя.

Замечания

Если sysmail_help_principalprofile_sp вызывается без параметров, результирующий набор возвращает список всех связей в экземпляре SQL Server. В противном случае результирующий набор содержит сведения об ассоциациях, которые удовлетворяют предоставленным параметрам. Например, если представлено имя профиля, процедура приводит список всех взаимосвязей для профиля.

sysmail_help_principalprofile_sp находится в msdb базе данных и принадлежит схеме dbo . Процедура должна выполняться с трехкомпонентным именем, если текущая база данных не msdbявляется.

Разрешения

Эта хранимая процедура принадлежит роли db_owner . Вы можете предоставить EXECUTE разрешения для любого пользователя, но эти разрешения могут быть переопределены во время обновления SQL Server.

Примеры

А. Перечисление сведений для определенной ассоциации

В следующем примере выводятся сведения обо всех взаимосвязях между профилем AdventureWorks Administrator и участником ApplicationLogin в базе данных msdb.

EXEC msdb.dbo.sysmail_help_principalprofile_sp
    @principal_name = 'danw',
    @profile_name = 'AdventureWorks Administrator';

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

principal_id principal_name     profile_id  profile_name                   is_default
------------ ------------------ ----------- ------------------------------ ----------
5            danw               9           AdventureWorks Administrator   1

B. Перечисление сведений обо всех сопоставлениях

В следующем примере выводятся сведения обо всех ассоциациях в экземпляре.

EXEC msdb.dbo.sysmail_help_principalprofile_sp;

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

principal_id principal_name     profile_id  profile_name                   is_default
------------ ------------------ ----------- ------------------------------ ----------
6            terrid             3           Product Update Profile         1
5            danw               9           AdventureWorks Administrator   1