sysmail_update_principalprofile_sp (Transact-SQL)

Статья
12/15/2008

Изменения: 12 декабря 2006 г.

Обновляет данные о взаимосвязи между каким-либо участником msdb и профилем.

Значок ссылки на раздел Синтаксические обозначения в Transact-SQL

Синтаксис

sysmail_update_principalprofile_sp { @principal_id = principal_id | @principal_name = 'principal_name' } ,
    { [ @profile_id = ] profile_id | [ @profile_name = ] 'profile_name' } ,
    [ @is_default = ] 'is_default'

Аргументы

[ @principal_id= ] principal_id
Идентификатор пользователя базы данных msdb или 0 для роли public. Аргумент principal_id имеет тип int и значение по умолчанию NULL. Либо аргумент principal_id, либо аргумент principal_name должны быть заданы.

[ @principal_name= ] 'principal_name'
Имя пользователя базы данных msdb или 'public' для роли public. Аргумент principal_name имеет тип sysname и значение по умолчанию NULL. Либо аргумент principal_id, либо аргумент principal_name должны быть заданы.

[ @profile_id= ] profile_id
Идентификатор (ID) профиля для изменения взаимосвязи. Аргумент profile_id имеет тип int и значение по умолчанию NULL. Либо аргумент profile_id, либо аргумент profile_name должны быть заданы.

[ @profile_name= ] 'profile_name'
Имя профиля для изменения взаимосвязи. Аргумент profile_name имеет тип sysname и значение по умолчанию NULL. Либо аргумент profile_id, либо аргумент profile_name должны быть заданы.

[ @is_default= ] 'is_default'
Является ли данный профиль профилем по умолчанию для пользователя базы данных. Пользователь базы данных может иметь только один профиль по умолчанию. Аргумент is_default имеет тип bit и не имеет значения по умолчанию.

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

0 (успешное завершение) или 1 (неуспешное завершение)

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

Нет

Замечания

Данная хранимая процедура изменяется в зависимости от того, является ли заданный профиль профилем по умолчанию для пользователя базы данных. Пользователь базы данных может иметь только один личный профиль по умолчанию.

Если имя участника взаимосвязи является public или идентификатор участника равен 0, то данная хранимая процедура изменяет открытый профиль. Может быть только один открытый (public) профиль по умолчанию.

Если аргумент @is_default имеет значение 1 и участник связан с более чем одним профилем, то заданный профиль становится профилем по умолчанию для участника. Профиль, который ранее был профилем по умолчанию, все еще связан с участником, но не является более профилем по умолчанию.

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

Разрешения

Выполнить разрешения этой процедуры по умолчанию для элементов фиксированной серверной роли sysadmin.

Примеры

А. Установка профиля в открытый профиль по умолчанию для базы данных

Следующий пример устанавливает профиль General Use Profile в открытый профиль по умолчанию для пользователей в базе данных msdb.

EXECUTE msdb.dbo.sysmail_update_principalprofile_sp
    @principal_name = 'public',
    @profile_name = 'General Use Profile',
    @is_default = '1';

Б. Настройка профиля в профиль по умолчанию для пользователя

Следующий пример устанавливает профиль AdventureWorks Administrator в профиль по умолчанию для участников ApplicationUser в базе данных msdb. Профиль должен быть заранее связан с участником. Профиль, который ранее был профилем по умолчанию, все еще связан с участником, но не является более профилем по умолчанию.

EXECUTE msdb.dbo.sysmail_update_principalprofile_sp
    @principal_name = 'ApplicationUser',
    @profile_name = 'AdventureWorks Administrator',
    @is_default = '1' ;

См. также

Журнал изменений

Версия	Журнал
12 декабря 2006 г.	Измененное содержимое. Указаны пользователи, такие как пользователи msdb, что роль ограничивается ролью public.

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