sysmail_help_principalprofile_sp(Transact-SQL)

적용 대상:SQL Server

데이터베이스 메일 프로필과 데이터베이스 보안 주체 간의 연결에 대한 정보를 나열합니다.

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 역할 ID입니다. @principal_id 기본값NULL인 int입니다. @principal_id 또는 @principal_name 지정해야 합니다.

[ @principal_name = ] 'principal_name'

나열할 연결에 대한 데이터베이스 사용자 또는 데이터베이스의 msdb 역할 이름입니다. @principal_name sysname이며 기본값은 .입니다NULL. @principal_id 또는 @principal_name 지정해야 합니다.

[ @profile_id = ] profile_id

나열할 연결에 대한 프로필의 ID입니다. @profile_id 기본값NULL인 int입니다. @profile_id 또는 @profile_name 지정할 수 있습니다.

[ @profile_name = ] 'profile_name'

나열할 연결에 대한 프로필의 이름입니다. @profile_name sysname이며 기본값은 .입니다NULL. @profile_id 또는 @profile_name 지정할 수 있습니다.

반환 코드 값

0 (성공) 또는 1 (실패).

결과 집합

다음 표에 나열된 열을 포함하는 결과 집합을 반환합니다.

열 이름	데이터 형식	설명
principal_id	int	데이터베이스 사용자의 ID입니다.
principal_name	sysname	데이터베이스 사용자의 이름입니다.
profile_id	int	데이터베이스 메일 프로필의 ID 번호입니다.
profile_name	sysname	데이터베이스 메일 프로필의 이름입니다.
is_default	bit	프로필이 사용자의 기본 프로필인지 여부를 나타내는 플래그입니다.

설명

매개 변수 없이 호출되는 경우 sysmail_help_principalprofile_sp 반환된 결과 집합은 SQL Server 인스턴스의 모든 연결을 나열합니다. 그렇지 않으면 결과 집합은 제공된 매개 변수와 일치하는 연결에 대한 정보를 포함합니다. 예를 들어 프로시저는 프로필 이름이 제공될 때 프로필에 대한 모든 연결을 나열합니다.

sysmail_help_principalprofile_sp는 데이터베이스에 msdb 있으며 dbo 스키마가 소유합니다. 현재 데이터베이스가 아닌 msdb경우 프로시저를 세 부분으로 된 이름으로 실행해야 합니다.

사용 권한

이 저장 프로시저는 db_owner 역할이 소유합니다. 모든 사용자에 대한 사용 권한을 부여 EXECUTE 할 수 있지만 SQL Server 업그레이드 중에 이러한 권한이 재정의될 수 있습니다.

예제

A. 특정 연결에 대한 정보 나열

다음 예제에서는 프로필과 ApplicationLogin 데이터베이스의 보안 주체 간의 AdventureWorks Administrator 모든 연결에 대한 정보를 나열하는 방법을 msdb 보여 줍니다.

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

관련 콘텐츠

• 데이터베이스 메일
• 저장 프로시저 데이터베이스 메일(Transact-SQL)