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