sysmail_help_principalprofile_sp (Transact-SQL)

  • 發行項

適用於：SQL Server

列出 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，則必須使用三部分名稱執行程式。

權限

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

範例

A. 列出特定關聯的資訊

下列範例顯示列出配置檔與ApplicationLogin資料庫中主體msdb之間AdventureWorks Administrator所有關聯的資訊。

EXEC 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. 列出所有關聯的資訊

下列範例顯示列出 實例中所有關聯的資訊。

EXEC 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

相關內容