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

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является.

Разрешения

Вы можете предоставить 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

Связанный контент