Share via

  • Статья

sysmail_help_principalprofile_sp (Transact-SQL)

Выводит сведения об взаимосвязях между профилями компонента 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 (неуспешное завершение)

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

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

Имя столбца

Тип данных

Описание

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.

Разрешения

Требует членства в предопределенной роли сервера sysadmin.

Примеры

А. Вывод сведений об указанной ассоциации

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

EXECUTE msdb.dbo.sysmail_help_principalprofile_sp
    @principal_name = 'danw',
    @profile_name = 'AdventureWorks2008R2 Administrator' ;

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

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

Б. Вывод сведений обо всех ассоциациях

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

EXECUTE 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           AdventureWorks2008R2 Administrator   1