sysmail_help_principalprofile_sp(Transact-SQL)

아티클
06/18/2013

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

구문

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는 int이며 기본값은 NULL입니다. principal_id 또는 principal_name을 지정할 수 있습니다.
[ @principal_name= ] 'principal_name'
나열할 연결에 대해 msdb 데이터베이스에 있는 데이터베이스 사용자 또는 역할의 이름입니다. principal_name은 sysname이며 기본값은 NULL입니다. principal_id 또는 principal_name을 지정할 수 있습니다.
[ @profile_id= ] profile_id
나열할 연결에 대한 프로필의 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	데이터베이스 사용자의 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가 아닐 경우 이 프로시저를 세 부분으로 구성된 이름으로 실행해야 합니다.

사용 권한

sysadmin 고정 서버 역할의 멤버 자격이 필요합니다.

예

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

다음 예에서는 msdb 데이터베이스에 있는 AdventureWorks Administrator 프로필과 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

2.모든 연결에 대한 정보 나열

다음 예에서는 인스턴스의 모든 연결에 대한 정보 목록을 보여 줍니다.

EXECUTE msdb.dbo.sysmail_help_principalprofile_sp ;