sysmail_delete_principalprofile_sp (Transact-SQL)

Статья
06/18/2013

Удаляет разрешение пользователя или роли базы данных на использование открытого или частного профиля компонента Database Mail.

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

Синтаксис

sysmail_delete_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. Чтобы сделать открытый профиль частным, укажите идентификатор участника 0 или имя участника 'public'. Необходимо указать либо аргумент principal_id, либо аргумент principal_name.
[ @principal_name = ] 'principal_name'
Имя пользователя базы данных или роли в базе данных msdb для удаляемой взаимосвязи. Аргумент principal_name имеет тип sysname и значение по умолчанию NULL. Чтобы сделать открытый профиль частным, укажите идентификатор участника 0 или имя участника 'public'. Необходимо указать либо аргумент 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 (неуспешное завершение)

Замечания

Чтобы сделать открытый профиль частным, укажите имя участника 'public' или идентификатор участника 0.

Будьте осторожны, удаляя разрешения для частного профиля пользователя по умолчанию или открытого профиля по умолчанию. Когда недоступен профиль по умолчанию, хранимая процедура sp_send_dbmail требует имя профиля в качестве аргумента. Таким образом, удаление профиля по умолчанию может повлечь неудачный вызов процедуры sp_send_dbmail. Дополнительные сведения см. в разделе Хранимая процедура sp_send_dbmail (Transact-SQL).

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

Разрешения

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

Примеры

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

EXECUTE msdb.dbo.sysmail_delete_principalprofile_sp
    @principal_name = 'ApplicationUser',
    @profile_name = 'AdventureWorks Administrator' ;

См. также

Справочник

Хранимые процедуры Database Mail (Transact-SQL)

Основные понятия

Компонент Database Mail

Объекты конфигурации компонента Database Mail

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