• Статья

sysmail_delete_principalprofile_sp (Transact-SQL)

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

Примеры

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

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