共用方式為

  • 發行項

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