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

sysmail_delete_principalprofile_sp (Transact-SQL)

  • Статья

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

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

Другие ресурсы

Компонент Database Mail
Профили Database Mail
Выбор задачи конфигурации (компонент Database Mail)

Справка и поддержка

Получение помощи по SQL Server 2005

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

Версия Журнал

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