sysmail_help_principalprofile_sp (Transact-SQL)

列出 Database Mail 設定檔和資料庫主體間之關聯的相關資訊。

Transact-SQL 語法慣例

語法

sysmail_help_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。 您只能指定 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 其中之一。

傳回碼值

0 (成功) 或 1 (失敗)

結果集

傳回包含下表所列資料行的結果集。

資料行名稱	資料類型	說明
principal_id	int	資料庫使用者的識別碼。
principal_name	sysname	資料庫使用者的名稱。
profile_id	int	Database Mail 設定檔的識別碼。
profile_name	sysname	Database Mail 設定檔的名稱。
is_default	bit	指出設定檔是否為使用者預設設定檔的旗標。

備註

如果在未設定任何參數的情況下叫用 sysmail_help_principalprofile_sp，傳回的結果集會列出 SQL Server 執行個體中的所有關聯。 否則，結果集會包含符合提供參數之關聯的資訊。 例如，提供設定檔名稱時，程序便會列出設定檔的所有關聯。

sysmail_help_principalprofile_sp 在 msdb 資料庫中，擁有者是 dbo 結構描述。 如果目前的資料庫不是 msdb，就必須利用三部分名稱來執行這個程序。

權限

需要系統管理員 (sysadmin) 固定伺服器角色的成員資格。

範例

A.列出特定關聯的資訊

下列範例會顯示 AdventureWorks Administrator 設定檔和 msdb 資料庫中的 ApplicationLogin 主體間之所有關聯的資訊。

EXECUTE msdb.dbo.sysmail_help_principalprofile_sp
    @principal_name = 'danw',
    @profile_name = 'AdventureWorks Administrator' ;

範例結果集如下 (行的長度經過重新格式化)。

principal_id principal_name     profile_id  profile_name                   is_default
------------ ------------------ ----------- ------------------------------ ----------
5            danw               9           AdventureWorks Administrator   1

B.列出所有關聯的資訊

下列範例會顯示如何列出執行個體中之所有關聯的資訊。

EXECUTE msdb.dbo.sysmail_help_principalprofile_sp ;

範例結果集如下 (行的長度經過重新格式化)。

principal_id principal_name     profile_id  profile_name                   is_default
------------ ------------------ ----------- ------------------------------ ----------
6            terrid             3           Product Update Profile         1
5            danw               9           AdventureWorks Administrator   1

請參閱

參考

Database Mail 預存程序 (Transact-SQL)

概念

Database Mail