sysmail_delete_principalprofile_sp (Transact-SQL)

  • Статья

Область применения: SQL Server

Удаляет разрешение пользователя или роли базы данных на использование открытого или частного профиля компонента 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.

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

Разрешения

Эта хранимая процедура принадлежит роли db_owner . Вы можете предоставить EXECUTE разрешения для любого пользователя, но эти разрешения могут быть переопределены во время обновления SQL Server.

Примеры

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

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

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