sysmail_update_principalprofile_sp (Transact-SQL)

  • 發行項

適用於：SQL Server

更新 主體與配置檔之間的關聯資訊。

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 的標識碼。 principal_id為 int，預設值為 NULL。 必須指定@principal_id或@principal_name。

[ @principal_name = ] 'principal_name'

資料庫中要更新之關聯的資料庫使用者或角色 msdb 名稱。 principal_name為 sysname，預設值為 NULL。 必須指定@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。

[ @is_default = ] is_default

這個設定檔是否為資料庫用戶的預設配置檔。 資料庫使用者可能只有一個預設配置檔。 @is_default為 bit，沒有預設值。

傳回碼值

0 （成功）或 1 （失敗）。

結果集

無。

備註

這個預存程式會變更指定的配置檔是否為資料庫用戶的預設配置檔。 資料庫使用者可能只有一個預設的私人配置檔。

當關聯主體名稱是 公用 或關聯主體標識符為 0時，這個預存程式會變更公用配置檔。 只能有一個預設的公用配置檔。

當 @is_default 是 1 且主體與多個配置檔相關聯時，指定的配置檔會變成主體的默認配置檔。 先前為預設配置檔的配置檔仍與主體相關聯，但不再是預設配置檔。

預存程式 sysmail_update_principalprofile_sp 位於 msdb 資料庫中，且由 dbo 架構所擁有。 如果目前的資料庫不是 msdb，則必須使用三部分名稱執行程式。

權限

此預存程式是由 db_owner 角色所擁有。 您可以授與 EXECUTE 任何用戶的許可權，但這些許可權可能會在 SQL Server 升級期間覆寫。

範例

A. 將設定檔設定為資料庫的預設公用配置檔

下列範例會將設定檔 General Use Profile 設定為資料庫中用戶 msdb 的預設公用配置檔。

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

B. 將設定檔設定為用戶的預設私人配置檔

下列範例會將配置檔AdventureWorks Administrator設定為資料庫中主體ApplicationUsermsdb的預設配置檔。 配置文件必須已經與主體相關聯。 先前為預設配置檔的配置檔仍與主體相關聯，但不再是預設配置檔。

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

相關內容